Cohort API

“Bringing Your Data Analysis Together with Cohort Reporting in MAX” from AppLovin’s Blog.

MAX provides three API endpoints with which you can get user performance data based on when the user installed your app:

1. Send a request to the /maxCohort endpoint to determine how much revenue users are generating with respect to when they install.
2. Send a request to the /maxCohort/imp endpoint to learn how many impressions users are seeing.
3. Send a request to the /maxCohort/sessions endpoint to retrieve session information.

All dates are in UTC and based on full UTC days.

You must authenticate to use these endpoints. To do so, set the value of api_key in your request to your account’s Reports Key.

Request Format

Target URLs

• https://r.applovin.com/maxCohort (Ad revenue performance)
• https://r.applovin.com/maxCohort/imp (Ad Impressions information)
• https://r.applovin.com/maxCohort/session (Session information)

Parameters

/maxCohort Columns

/maxCohort/imp Columns

/maxCohort/session Columns

Response Format

• If your request includes format=csv, the response will be a comma-separated text file with column headings that have the same values as those in columns in your request.

  day,country,application,installs,pub_revenue_7
  2019-03-25,gb,"My Test App",142,81.24
  2019-03-25,in,"My Test App",921,59.25

• If your request includes format=json, the response will be a JSON file with keys code (response code, 200 means successful), count (the number of results returned), and results (a list of dictionaries with data).

  {
    "code": 200,
    "results": [
      {
        "day": "2019-03-25",
        "country": "gb",
        "application": "My Test App",
        "installs": "142",
        "pub_revenue_7": "81.24"
      },
      {
        "day": "2019-03-25",
        "country": "in",
        "application": "My Test App",
        "installs": "921",
        "pub_revenue_7": "59.25”
      }
    ],
    "count": 2
  }