API Overview

appFigures provides a simple, RESTful way to interact with reports and account data. Anything that can speak HTTP and parse JSON can interact with the API. Let’s get started!

Location

The current version of the API can be found at: https://api.appfigures.com/v1.1/

Authentication

The appFigures API uses HTTP Authentication. It’s a simple solution with a lot of client support (curl and everything else).

Note: The API will only accept requests made over HTTPS. Any HTTP requests will fail.

Resources

The API is composed of the following root resources:

Sales

GET /sales/{itcAccountId}/regions/{startDate}/{endDate}

GET /sales/{reportType}/{startDate}/{endDate}

Ranks

GET /ranks/{productId}/{granularity}/{startDate}/{endDate}

Reviews

GET /reviews/{productId}/{countries}/{page}/

iAds

GET /iads/{type}/{startDate}/{endDate}

Archive

GET /archive/

GET /archive/latest/

GET /archive/{date}/

GET /archive/raw/{id}

Events

GET /events/

POST /events/

GET /events/{eventId}

PUT /events/{eventId}

DELETE /events/{eventId}

Users

GET /users/{email}/

GET /users/{email}/products/

GET /users/{email}/external_accounts/

Data

GET /data/stores

GET /data/categories

GET /data/languages

GET /data/currencies

Notes

All resources that could semantically return a JSON array instead return a JSON object of a relevant unique key mapped to each item. This is to mitigate a particularly sneeky XSS attack that storing HTTP AUTH credentials in the browser can open the door to.