GET /account/identity/limit/{service}

Retrieve the identity limits set for a given service.

An HTTPS GET request sent to:{service}

A successful call to this endpoint returns: 200 OK plus a JSON object.


Parameter Description

Number of results to return per page.

Default: 25


The page you want to retrieve. For example, if you set this parameter to 3, the API will return page 3 only (if there is sufficient data to fill more than 2 pages).

Default: 1


  1. Retrieve the account limits for all your identity ids on Facebook:

curl -X GET 
    -H 'Authorization: username:api_key'

The output looks like this:

HTTP/1.1 200 OK

    "count": <total number of results>,
    "limits": [
            "identity_id": "<string>",
            "service": "<eg. facebook>",
            "total_allowance": <positive integer>,
            "analyze_queries": <positive integer>
            "identity_id": "<string>",
            "service": "<eg. facebook>",
            "total_allowance": <positive integer>,
            "analyze_queries": <positive integer>
    "page": <page number>,
    "pages": <total page count>,
    "per_page": <number of results per page>

If no results are found, count will be 0 and the limits array will be empty.

Output Fields

Property Type Description
count int The total number of results found.
identity_id string The id of the identity.
service string The service these limits apply to.
total_allowance int The daily recording limit set for the identity for this service.
analyze_queries int The hourly analyze query limit set for the identity for this service
page int The page number of the results.
pages int The total number of pages of results.
per_page int The number of items returned per page.


Response code Description
400 Occurs if per_page or page are not positive integers
404 Occurs if the service does not exist.


  1. All calls to the API must be properly authenticated with a DataSift username and API key.
  2. All calls to the API must be versioned. The current version is v1.3.

Resource information

Rate limit cost: 25

Requires authentication: Yes

Response formats: JSON, JSONP