Requirements and Limitations

The Analytics API is available for any organization that has API enabled. You must establish an authenticated session using OAuth in order to access the Analytics API. When working with the Analytics API, consider these restrictions in addition to general API limits.

Responses and requests are in JSON. While using the Analytics API with a POST request body, you must use content-type: application/json. You might get unexpected results if you don’t use this content type.

Note

Limits

• Cross filters, standard report filters, and filtering by row limit are unavailable when filtering data.
• Historical trend reports in tabular format are unavailable.
• The API can process only reports that contain up to 100 fields selected as columns.
• A list of up to 200 recently viewed reports can be returned.
• Your organization can request up to 500 synchronous report runs per hour.
• The API supports up to 20 synchronous report run requests at a time.
• A list of up to 2,000 instances of a report that was run asynchronously can be returned.
• The API supports up to 200 requests at a time to get results of asynchronous report runs.
• Your organization can request up to 1,200 asynchronous requests per hour.
• Asynchronous report run results are available within a 24-hour rolling period.
• The API returns up to the first 2,000 report rows. You can narrow results using filters.
• You can add up to 20 custom field filters when you run a report.