Sign in

v9

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01211389.1 KB

Batch results

Queue multiple searches for later retrieval.

post/search/batches

Request body

OR

Example request

{
  "terms": [
    "foo bar baz"
  ],
  "engine": "google",
  "serps": 1,
  "urls": [
    "https://www.google.com/search?q=foo+bar+baz&hl=fr&gl=fr&ie=UTF-8"
  ],
  "awaiting": "ai",
  "callback": "https://webhook.site/02e249f8-1faf-4fab-bcf5-78ce683e85a8"
}

Response

A job identifier and confirmation count.

idstring uuid required

The identifier to retrieve the batch searches with.

countinteger required

The number of queries in the batch as confirmed by the API.

Example response

{
  "id": "a0482596-c2ad-445a-a435-727002156a20",
  "count": 1
}