Getting Started with Google Search Light

In this guide, you make your first Google Search Light request and see how the API returns results.

Before You Begin

Before making a Light request, make sure you have:

A Geonode API key
Google Search Light plan (separate from general Search / Extract)
The Scraper API base URL

If you haven't completed the initial setup, see Quick Start Guide.

Make Your First Request

Send a POST request to the Google Search Light endpoint.

POST /v1/google/search/light

For your first request, you only need a search query.

Example Request

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"
  }'

{
  "query": "coffee grinder"
}

Defaults when omitted

Field	Default
`page`	`1`
`pages`	`1`
`safe`	`"off"`
`device`	`"desktop"`
`format`	`"json"`
`ai_overview`	`false`

Example Response

A successful request returns pages in one response shape (format: "json" shown). Truncated to one organic hit.

{
  "job_id": "f9a2e661-dc43-404b-bc6d-2f1c1cdb8e76",
  "query": "coffee grinder",
  "pages_requested": 1,
  "pages_returned": 1,
  "pages_stopped": null,
  "pages": [
    {
      "page": 1,
      "attempts": 1,
      "results": [
        {
          "position": 1,
          "title": "Best Coffee Grinders of 2026",
          "url": "https://www.example.com/best-coffee-grinders",
          "snippet": "We tested burr and blade grinders for espresso, pour-over, and drip...",
          "thumbnail": null,
          "displayed_url": "https://www.example.com › best-coffee-grinders",
          "source_host": null
        }
      ],
      "suggestions": [],
      "spelling_correction": null,
      "ai_overview": null
    }
  ]
}

pages_returned is the number of pages billed for this request. With format: "json", html is omitted. With format: "both" or "html", each page can include html. thumbnail and source_host are often null.