Intro

The AppTweak API lets you programmatically access app store data from the Apple App Store and Google Play across 100+ countries. Use it to retrieve structured data, build custom analyses and reports, automate workflows, or integrate AppTweak data directly into your product.

Getting started

To use the AppTweak API, you’ll need an API token for authentication and usage tracking. You can generate a token by subscribing to an API plan (Small, Medium, Large, or Enterprise). A 7-day free trial is available.

Once subscribed, you’ll find your API Dashboard — including your API token and links to this documentation — in the API section of AppTweak. ).

Are you ready to make your first request? Follow our tutorial here 👨🏻‍🏫

Data format

Depending on the data you’d like to fetch, you will need to indicate a series of parameters to define your request. All successful responses return a valid minified JSON document. The JSON document is a hash which contains the response content and metadata about the request and the response itself. Our responses always follows the same structure: a hash “result” that contains one or multiple “resources”. These resources can be an app, a keyword, or a category. Each of these resources will contain a response hash that varies according to the request.

Example request

curl --request GET \
     --url 'https://public-api.apptweak.com/api/public/store/apps/metrics/current.json?apps=1064216828&metrics=downloads%2Crevenues%2Capp-power%2Cratings&country=us&device=iphone' \
     --header 'Accept: application/json' \
     --header 'x-apptweak-key: YOUR API TOKEN'

Example response

{
  "result": {
    "880178264": {
      "downloads": {
        "value": 3772,
        "precision": 0.25,
        "date": "2022-03-03"
      },
      "revenues": {
        "value": 15971,
        "precision": 0.25,
        "date": "2022-03-03",
        "currency": "USD"
      },
      "power": {
        "value": 86.6,
        "date": "2022-03-03"
      },
      "ratings": {
        "value": null,
        "breakdown": null,
        "date": "2022-03-03"
      }
    }
  },
  "metadata": {
    "request": {
      "path": "/api/public/store/apps/metrics/current.json",
      "params": {
        "device": "iphone",
        "country": "us",
        "language": "us",
        "apps": [
          "880178264"
        ],
        "metrics": [
          "downloads",
          "revenues",
          "power",
          "ratings"
        ]
      },
      "cost": 210,
      "max_credit_cost": 220,
      "status": 200
    },
    "response": null
  }
}

Authentication

You authenticate the AppTweak API by providing your secret API token in the request. Any request performed using your API token will be billed to your account, so be sure to keep it secret!

Authentication to the API occurs using HTTPS request Headers. Provide your API token in the X-Apptweak-Key Header.

All API requests must be made over HTTPS. Calls made over plain HTTP will fail. You must authenticate for all requests.

How to make requests

You can make requests directly from the documentation. Under the GOOGLE & APPLE APP STORE API section on the left sidebar you can find all the available API endpoints. On each of the endpoints definition page you can make requests by:

Completing the query parameters
Making sure your API key is in the authentication header
Clicking on the "Try it!" button and the API call will be executed

You can also follow a step by step guide to find how to make your first requests in the next section.

The available API endpoints can be found on the left under App Store API. 1,2, 3 steps to make your API call.

Rate limit

The AppTweak API also has a limit on the number of requests you can perform in a given amount of time. Currently that limit is set to 60 requests per 10 seconds.

FAQ

You can access frequently asked questions about our API in the following helpdesk article.