Credits and billing

Every tool is priced in credits. A cheap Reddit read costs one credit, and tools that do more work cost more. The rules:

The number shown is the most a call can cost. Tools marked "up to" charge less when they do less work, and the response says exactly what was charged.

List tools charge once per page, not per row. The X follower exporters are the exception: they charge per page of a fixed size, and that size is shown as the unit next to the price.

• Cached responses cost the same as fresh ones. The cache makes repeat calls fast but doesn't change the price.
• Failed calls cost 0. No error code ever charges credits.
• Test keys cost 0.

Your balance has two parts: monthly credits from your plan, and purchased credits from top-ups. Monthly credits are spent first and reset each billing period. Purchased credits are spent after them.

You can read your balance three ways:

• credits.remaining in every response body.
• The x-credits-remaining response header.
• GET /v1/account, which is free and also returns your plan and rate limit.

If your balance is below a tool's cost, the call fails with HTTP 402 before anything is fetched, and you aren't charged:

{
  "error": {
    "code": "insufficient_credits",
    "message": "This call costs up to 2 credits and you have 1.",
    "retryable": false,
    "docsUrl": "https://chatterapi.com/docs/errors#insufficient_credits",
    "topupUrl": "https://chatterapi.com/dashboard/billing",
    "instructionsForAgent": "The user's ChatterAPI balance is too low for this call. Tell them and share the topupUrl. Do not retry."
  },
  "requestId": "req_01JA7Q3V8K2N4P5R6S7T8V"
}

topupUrl goes to billing. instructionsForAgent tells an AI agent to stop and tell you instead of retrying.

New accounts get 1,000 credits once. Plans start at $19 a month for 25,000 credits. Only subscribers can buy top-ups, and purchased credits stay in your balance if the plan ends. Full prices are on the pricing page.

The Usage page shows your spend per tool and per day.