Understanding the limitations of API Calls in the AppsFlyer API

This article will help you navigate report quotas and rate limits for efficient data retrieval through the AppsFlyer connector.

AppsFlyer imposes quotas and rate limitations on report generation to maintain system stability and ensure fair usage. These restrictions vary depending on the type of report, the method of retrieval (Pull API vs. data export pages), and the user’s account level.

In Dataslayer, we differentiate the group of metrics into 2 main types:

  1. Aggregated Reports
  2. Events Reports

How are the API Calls limited on each report?

1. Aggregated Reports

This category of metrics retrieves information through the Aggregate Pull API. The following limits apply:

  • Date Range Up to 2 Days:
    Maximum of 1 call per minute per app per report.
  • Date Range of 3 or More Days:
    - Maximum of 120 calls per day per account.
    - Up to 24 calls per day per app.

2. Events Report

The Raw Data Pull API works differently from the Aggregate Pull API. Instead of providing aggregated counts, it delivers detailed event-level data, where each row represents an individual user event. For example, an install event might include fields such as date, application ID, and user identifier.

The quotas for this API are structured as follows:

  • Up to 24 requests per day per account per report type (Organic installs, Non-organic installs, Retargeting conversions, Uninstalls, etc).

  • Each report type has its own quota, meaning that reaching the limit for one report (e.g., Organic Installs) does not affect the limit for another (e.g.,  Installs).

This distinction is crucial when planning data retrieval, as different types of event reports operate independently under their own quota system.

Error example

Browser template-Feb-10-2025-03-12-03-0913-PM
Maximum number of in-app event reports

This error shows that you have encountered a limit on in-app events reports, which includes metrics such as Organic installs, Non-organic installs, and Retargeting conversions. As indicated in the message, you can either contact your AppsFlyer account executive to discuss an upgrade for your limits or wait until the next day when the limits will reset.

When building a query with Event metrics, you may notice that loading times can be lengthy. To enhance performance, consider applying filters such as Media Source or Country Code set to "equals to":

Browser template (2)-Feb-13-2025-09-17-20-2375-AM

Browser template (3)-Feb-13-2025-09-18-07-2606-AM

This approach allows the API call to be pre-filtered, resulting in a quicker query execution.

For more details about quotas and limitations, please refer to AppsFlyer’s official documentation here.


As always, feel free to contact us via live chat on our website or email if you have any doubts or questions. We are happy to help!