Data Export API
Before you begin working with the Data Export API:
- purchase access to the Data Export API via your Ada account manager
- get access to your exclusive Ada Developer Slack channel
- generate your API token
Data Export API Trial
A 30-day trial for Data API is available. The trial begins once you generate your first API access token. Any regenerated API access tokens will have the same expiration date as the first API access token. If you migrate to a paid Data Export API feature, you'll need to regenerate a new API access token, which will remove the initial expiration date.
During the trial period, you can check the expiry date in the dashboard under Settings > Integrations > Data Export API > Configure.
Rate limits
The Data Export API is subject to rate limiting. Exceeding the rate limit may return a 429-Too Many Requests response status code.
Rate limits ensure the stability of Ada's infrastructure for all clients and the best experience for you. When calling the Data Export API you should implement 429 retry logic using exponential backoff and jitter.
The Data Export API rate limits are 3 requests / second for each endpoint.
Data limits
In addition to rate limits, we’ve implemented page size and date range limitations.
Page size and date range limitations
Page size limitations: maximum of 10,000 records per page
Date range limitations: the end date of the query must be 60 days or less from the start date
Data retention
The Data Export API can access data going back a maximum of 12 months.
Data ingestion time
It takes at least two hours to ingest conversation data into the Data API database. This means that queries won't return data from conversations created within the previous two hours. To capture data for a specific period, make sure you have passed that two hour window. For example, a query with a created_from of Feb 9 00:00:00 and a created_to of Feb 9 23:59:59 should run at Feb 10 2:00:00 or later to capture that entire 24-hour period.