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
POST /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.