Pull API - raw data reporting API

At a glance: Using pull APIs you can get CSV files of reports by using URL links that contain the query parameters. Pull API reports contain either aggregated or raw data.

CSV reports can be delivered using Pull APIs and also by Download, Email, and Data locker*

The method you use depends on the report size and frequency you use the same report.  In general, for reports, you need ad-hoc, use the download/email method.

Pull API is for use by advertisers and agencies.

See also:

You can create the API link manually as described in this document or ready prepared in AppsFlyer.  To get the prepared API: Goto Integration > API access. (Note: When the admin in AppsFlyer changes so does the API token)

To retrieve the current Pull API token, click your email > API Tokens.

If you use the manual creation method for the creating of the API link then ensure that:

  • Parameters are in lowercase as they are case-sensitive.
  • You don't specify the same field twice in the same URL. Doing so results in an empty file being downloaded.

 Notes:

Changing the AppsFlyer account admin: Pull API links require an API token which is generated when the AppsFlyer account is first created. If the account admin changes then the API token also changes.  This means, for example, that if you have pull API URLs contained in scripts, and the account owner changes you need to update the pull API URL with the new API token.

    • Parameters are in lowercase as they are case-sensitive.
    • Don't specify the same field twice in the same URL. Doing so results in an empty file being downloaded.
Was this article helpful?