API Documentation for App Store & Google Play Store

Introduction

The AppTweak API is designed around REST principles. Our API is designed to have predictable, resource-oriented URLs and to use HTTP response codes to indicate API errors. We use built-in HTTP features, like HTTP headers and HTTP verbs, which can be understood by off-the-shelf HTTP clients. JSON will be returned in all responses from the API, including errors.

API Endpoint
https://api.apptweak.com

Authentication

You authenticate to the AppTweak API by providing one of your secret API token in the request. You can manage your API tokens from your account. Any request performed using one of your API token will be billed on your account so be sure to keep them 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.

Example Request
$ curl -H "X-Apptweak-Key: your-api-key" \
https://api.apptweak.com/ios/applications/284882215.json

Format

All successfull response return a valid minified JSON document.

The Response Format

The JSON document is a hash which contains the response content and metadata about the request and about the response itself.

Parameters
content:
Varying The response content. Check the documentation of each request to have additional information about it's content.
metadata:
hash Holds the metadata about the request and the response. Always holds the two following sub-keys :
metadata -> request
hash Holds the following metdata about the request: the store on which the request was performed, the time at which the request was fulfilled, the path of the request, and the params as parsed by our system. This is useful for debugging and allows you to verify how we treated your request
metadata -> content
hash Depending on the request we might add additional data here. Check the documentation of each request to verify which data are provided. When no additional data are provided, the hash is empty.
Example Request
$ curl -H "X-Apptweak-Key: your-api-key" \
https://api.apptweak.com/ios/searches.json?term=puzzle&country=FR&language=fr



Example Object
{
  "content": [
    {
      "developer": "Ferran Tebe",
      "devices": [
        "iphone",
        "ipad",
        "ipod"
      ],
      "genres": [
        6014,
        6016,
        7012,
        7018
      ],
      "icon": "http://a5.mzstatic.com/eu/r30/Purple7/v4/7b/6f/20/7b6f2010-115a-a5c9-f796-5c89e8fa0564/icon180x180.jpeg",
      "id": 455696756,
      "price": "0,00 €",
      "slug": "puzzle-man-pro-jeu-puzzle",
      "title": "Puzzle Man Pro - un jeu de puzzle classique et addictif"
    },
    ...
  ],
  "metadata": {
    "content": {
      "size": 10,
      "total_size": 66561
    },
    "request": {
      "params": {
        "country": "fr",
        "device": "iphone",
        "format": "json",
        "language": "fr",
        "term": "puzzle"
      },
      "path": "/searches.json",
      "performed_at": "2015-09-23 12:35:56 UTC",
      "store": "ios"
    }
  }
}

Organisation

The AppTweak API allows you to access the iOS and android stores. To specify the app store you wish to perform requests on, you must prefix the path of each request with the name of the OS you wish to access :

ios:
To access the Apple App Store for all iOS devices (iPhone, iPad, ...)
android:
To access the Google Play Store for all android devices (Google Nexus, Samsung Galaxy, HTC One, ...)

We try to provide an experience as smooth as possible by providing request methods and responses as similar as possible on both stores.

Access iOS Documentation Access Android Documentation
Example iOS Requests
$ curl -H "X-Apptweak-Key: your-api-key" \
https://api.apptweak.com/ios/applications/284882215.json

$ curl -H "X-Apptweak-Key: your-api-key" \
https://api.apptweak.com/ios/categories/top/6000.json

Example Android Requests
$ curl -H "X-Apptweak-Key: your-api-key" \
https://api.apptweak.com/android/applications/com.facebook.katana.json

$ curl -H "X-Apptweak-Key: your-api-key" \
https://api.apptweak.com/android/categories/top/BUSINESS.json