Account balance (/account)

GET /account returns your BestSERP credit balance, each credit grant with its expiry date, the next expiry and your rate limit. Free to call.

Updated View as Markdown

GET /account returns your balance and where it comes from. It costs nothing and is not rate limited like searches.

Request
curl 'https://api.bestserp.com/account' -H 'X-API-KEY: YOUR_API_KEY'
200 OK
{
  "email": "[email protected]",
  "balance": 2997,
  "grants": [
    {
      "id": "c1f6f1d2-7a8e-4f0b-9a51-2d9a3c4b5e60",
      "source": "signup",
      "amount": 3000,
      "remaining": 2997,
      "expiresAt": "2026-12-14T09:00:00+00:00",
      "createdAt": "2026-11-14T09:00:00+00:00"
    }
  ],
  "nextExpiry": {
    "credits": 2997,
    "expiresAt": "2026-12-14T09:00:00+00:00"
  },
  "rateLimitPerMinute": 60
}

Fields

Field Meaning
email The account's email.
balance Credits you can spend now.
grants Each grant of credits: source (signup, purchase...), amount, remaining, expiresAt (null when it never expires).
nextExpiry The soonest-expiring credits and when they expire. They are always spent first.
rateLimitPerMinute Searches per minute allowed for the account.

Every search response also carries X-Credits-Remaining, so you rarely need to poll this endpoint. See credits.