JustSERPDocs
Account

Account calls

Your key's own call log, newest first: when each call was made, which endpoint, how it ended, whether it cost a call, how long it took, and the query, country and device where it had them.

GET
/v1/account/calls

Your key's own call log, newest first: when each call was made, which endpoint, how it ended, whether it cost a call, how long it took, and the query, country and device where it had them. Filter by endpoint, outcome or whether it was charged.

If you reset your API key in the dashboard, the list also holds the calls made with the keys you replaced during the last 30 days, so a reset does not clear your history.

Free: nothing is counted against your key and no concurrency slot is held. It needs your own API key.

The log keeps the last 30 days and began in October 2026, so an older window holds less until it fills. A call just made can take a moment to appear. Calls refused at the key check or rejected as invalid are logged only some of the time under heavy bursts, so refused and invalid rows are a sample.

A page holds up to limit calls. When next_before is not null there are more: send it as before to get the next page, with the same filters. before also takes an ISO 8601 time to start from.

Reads are limited to a few per key in a short time, both endpoints together: past that, 429 with Retry-After. GET takes the same fields as query parameters.

Authorization

headerX-API-Key<token>

Your API key.

Query Parameters

limit?integer

How many calls to answer at most.

Range1 <= value <= 100
Default20
before?string

The next_before of the previous page, or an ISO 8601 time: only calls before it.

engine?string

Only calls to this endpoint, by name, such as google_search.

Match^[a-z0-9_]{1,64}$
outcome?string

Only calls that ended this way.

Value in"ok""not_found""failed""aborted""refused""invalid"
charged?boolean

Only calls that cost a call (true) or did not (false).

Response Body

One page of the call log, newest first. calls is [] when nothing matches.

application/json
  1. response
calls*array<>
next_before*|

Send as before for the next page; null on the last page.

Example Request
curl -X GET 'https://api.justserp.com/v1/account/calls?limit=20&engine=google_search&outcome=failed'
Example Response
{  "calls": [    {      "time": "2026-11-03T09:15:02.311Z",      "engine": "google_search",      "status": 200,      "outcome": "ok",      "charged": true,      "ms": 2310,      "query": "coffee",      "country": "us",      "device": "desktop",      "reason": null    }  ],  "next_before": "1793697302311.5b7a5a4e-96a1-4b1f-9a6f-0f3f7a2f3c11"}