Need Help? Support

Service Overview

Discovery

A list of all supported services is publicly available at /services. The response includes each service's name and brief description, and the sets of data that service provides. Each data type also includes its base synching frequency in seconds, though this is modulated on a user-by-user basis by the actual frequency of new data from that endpiount.

Example request:

GET https://api.singly.com/services

Example JSON:

Service endpoints

Get a range of data from a specific service and endpoint.

The URL pattern for interacting with services looks like this:

GET https://api.singly.com/services/:serviceName/:serviceEndpoint

URL parameters:

Query parameters:

  • limit the number of results to return (defaults to 20, unlimited max).
  • since The unix timestamp (in epoch milliseconds) of the oldest entry. Defaults to 0, useful when looking for newer things since the last request.
  • until The unix timestamp (in epoch milliseconds) of the newest entry. Defaults to now. Use this to page back in time, passing in the oldest timestamp of the previous results.
  • all of the common parameters like near, q, etc.

Example request:

GET https://api.singly.com/services/twitter/tweets?access_token=my_token

Example response:

Individual items from a service

The URL pattern for retrieving a specific item from a service looks like this:

GET https://api.singly.com/services/:serviceName/:serviceEndpoint/:id

Example request:

GET https://api.singly.com/services/twitter/tweets/193208621465743360?access_token=my_token

Example response: