This page will help you get started with AppTweak's App Store API.

Intro

AppTweak’s API allows you to access the Apple App Store & Google Play Store programmatically in 100+ countries. Use our API to visualize mobile app data the way you want, build custom reports, automate part of your processes, or integrate AppTweak data into your product.

Getting started

In order to use the AppTweak Public API, you must obtain an API token which will be used for authentication and billing purposes.

This token can be automatically obtained by subscribing to an AppTweak account with a Pro, Guru, Power, or Enterprise plan. Once subscribed, you will find your API dashboard - which includes your API token and links to this documentation - in the "API" section of AppTweak.

27922792

API Dashboard within 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://app.demo.apptweak.com/api/public/store/apps/metrics/current.json?apps=880178264&metrics=downloads%2Crevenues%2Cpower%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 HTTP 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:

  1. Completing the query parameters
  2. Making sure your API key is in the authentication header
  3. 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.

15931593

The available API endpoints can be found on the left section Google and Apple App Store API (highlighted in green). The different input fields and the "Try it!" button to make a request are highlighted in orange.

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.