The API is entirely HTTP-based
GET requests are used to retrieve data from the API. POST and PUT requests are used to add or edit records respectively. DELETE requests remove data (there’s no way to undo deletes, so be careful). API Methods that require a particular HTTP method will return an error if you do not make your request with the correct one.
The API is stateless
As with most REST APIs, the Appfigures API does not keep state, which means that every request will require authentication.
Security
The Appfigures API makes OAuth and HTTP Authentication available. Authentication is documented here, and you’ll get to get a Client Key to get started.
To ensure all requests are made securely the API will only accept requests over SSL (HTTPS). Any request over HTTP will fail.
Encoding
All API responses will be UTF-8 encoded.
Dates & Time Zones
Dates used to make a request or in the response will be in the sortable date format of year-month-day (2017-04-12, for example).
You can also use date offsets relative to today. For example:
- n, -n: n days in the future or past
(-2 — two days ago, 4 — 4 days in the past) - nw, -nw, w: n weeks in the future or past
(-2w — two weeks ago, w — last week, 4w — 4 weeks in the past) - and so on for month(m) and year(y)
Dates in Appfigures fall into three different categories and the time zones are different accordingly:
Revenue reports
Downloads, revenue, and ad reports are most commonly reported without a timezone and are normalized into a single date.
Ranks reports
Rank reports are always reported in the time zone selected by the user, which can be retrieved using the /users resource. The default time zone is Eastern Standard Time (EST).
Everything else
All other dates will be reported in Eastern Standard Time (EST)
There’s a limit on API calls
Each account is allowed a fixed number of API calls every month. The actual number, along with details on increasing the limit is available here.
The API is available to all of our members
API access is available to all members, regardless of plan type, or user role. We don’t discriminate. Each member has access to all functions available within their Appfigures account.