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.