Pagination and Filters

Google Search Light supports pagination and optional filters on the request.

Pagination with page

Request one result page from 1 to 20 (default 1).

{
  "query": "coffee grinder",
  "page": 2
}

curl -X POST "https://scraper.geonode.io/v1/google/search/light" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "coffee grinder",
    "page": 2
  }'

Each returned page is billed as one unit. Prefer asking for a query's pages in order so the next page can reuse the Google session.

Multi-page with pages

Request the first N pages (1–10) in one call. Always starts at page 1. Cannot be combined with url. Not with page. A request with both returns 422.

{
  "query": "coffee grinder",
  "pages": 3
}

• Same session and exit IP for that request
• Stops at the first failed or missing page
• Inspect pages_stopped
• Billed for pages_returned only
• Not with page (returns 422 if both are set)

Filters

locale

en, en-US, or all.

safe

off (default), moderate, or strict.

time_range

day, week, month, or year.

device

desktop (default), mobile, iphone, or ipad.

uule

Encoded location only (w+... or a+...). Invalid values return 422.

format and ai_overview

Not pagination filters, but common request options: format (json | html | both) and ai_overview (boolean, page 1 only).