Credit management
Every paid API account has a monthly credit allowance. Each API method costs a fixed number of credits per request, and the cost is taken from your balance when the request runs. API v2 and API v3 requests use the same balance.
How the balance works
- Used credits reset to zero on the 1st of every month.
- When your balance can't cover a request, the API returns HTTP
402("Not enough credits"). Free methods keep working at a zero balance. - Requests that return an error are not charged: the credits held for them go back to your balance.
- Requests rejected before they run (invalid token, missing access to the app or workspace, invalid parameters) are never charged.
Need a higher allowance? Contact AppFollow support.
Method cost
Every method falls into one of these groups:
| Type | Credits | Examples |
|---|---|---|
| Setup and navigation | 0 | List and create workspaces, list workspace apps and tags, add an app to a workspace |
| Remove an app from a workspace | 200 | Remove Workspace App |
| Action on one review | 3 | Post Reply |
| Data read (list or report) | 12 | Reviews feed, review metrics, app versions, app search |
Adding an app to a workspace is free. Removing one costs 200 credits, so plan your workspace setup before you cycle apps in and out.
Requests with a date range
Ratings methods (Ratings Summary, Ratings Chart, Ratings Breakdown and the Google Play Console charts) cost 12 credits for the first 14 days of the requested period, plus 12 credits for every started 14-day block after that. The range length is the number of days between from and to in the request body.
Days between from and to | Credits |
|---|---|
| up to 14 | 12 |
| 15–28 | 24 |
| 29–42 | 36 |
| 90 | 84 |
Example: "from": "2026-01-01", "to": "2026-01-31" is a 30-day range and costs 36 credits.
Reviews methods also take from and to, but cost a flat 12 credits per request whatever the range.
The price of every method is listed in Methods cost and availability and on each method's page.
Rate limits
Default limits, shared across API v2 and v3:
- 3,000 requests per hour per API token
- 10,000 requests per hour per account (all tokens together)
- 100 requests per hour for a sandbox token
When you exceed a limit, the API returns 429 and a Retry-After header with the number of seconds to wait.
