Credit management

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:

TypeCreditsExamples
Setup and navigation0List and create workspaces, list workspace apps and tags, add an app to a workspace
Remove an app from a workspace200Remove Workspace App
Action on one review3Post Reply
Data read (list or report)12Reviews 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 toCredits
up to 1412
15–2824
29–4236
9084

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.