Rate limits
We impose limits on the number of API calls an ad account or a user can make within a specified timeframe. Exceeding these limits results in API requests from one or more users under the ad account being throttled.
Quota
By default, any and all API requests you make are subject to rate limits. The rate limit imposed at the ad account level on all available Moloco Ads API endpoints is 300 per 5 minutes. The following is a summary of all rate limits.
Endpoint | Level | Quota |
---|---|---|
All endpoints | Ad account | 300 / 5min |
POST /analytics-overview | Ad account | 60 / min |
POST /analytics-detail | Ad account | 60 / hour |
POST /analytics-skadnetwork | Ad account | 60 / hour |
GET/cohort-summary | Ad account | - 60 / min when the value of the type property is the ROAS type- 60 / hour when the value of the type property is the KPI action type |
GET /reports | Ad account | - 0~1 date range: 30 / day - 2~7 date range: 10 / day - 8~31 date range: 5 / day Note: Up to 4 million rows are returned in response to a single API call. |
GET /logs | Ad account | 30 / day |
GET /ad-accounts | User | 300 / 5min |
HTTP response
After you have made an API request, you will find detailed information about the rate limits imposed on your API request in the HTTP headers included in the response.
X-Rate-Limit-Quota The maximum number of requests you're permitted to make per hour.
X-Rate-Limit-Remaining The number of requests remaining in the current rate limit window.
X-Rate-Limit-Reset The time at which the current rate limit window resets in UTC epoch seconds.
In the event that the assigned rate limit for an API endpoint has been exceeded, the system returns an error code in the response as in the following example.
{
"code": 8,
"message": "API quota exceeded. Please try again later. code = ResourceExhausted"
}
Frequently Asked Questions
I would like to retrieve my campaign data. What are my options?
Depending on your specific use case, you can choose between the AnalyticsDetail API and the Report API. See the following table for more details.
Endpoint | API type | API quota | Available data output format | Available dimension and metric | Row limit | Recommended use case |
---|---|---|---|---|---|---|
POST /analytics-detail | Synchronous API | 60/hour | .json | You can choose from a comprehensive list of all available dimensions and metrics. You can apply filters as needed. | 10,000 rows | Use this API for frequent data retrieval (e.g., display on data dashboard) and quick data analytics on a subset of data. |
GET /reports | Asynchronous API | - 0~1 date range: 30 / day - 2~7 date range: 10 / day - 8~31 date range: 5 / day | .csv , .json | You can choose from a select number of dimensions and metrics. No filters are available. | 4 million rows | Use this API for regular (e.g., daily, weekly, etc.) data retrieval and reading general trends in campaign performance. |
Updated 6 months ago