Skip to main content
Get the top 100 Google results with 1 API call — set language/country, control depth, and verify with the original SERP page (page_html).

Make your first request in minutes

Pricing: one successful API call = one billable request (retries included, no bandwidth fees). See SERP Pricing & Billing.
Use these ready-to-use example to fetch the top 100 results with just 1 API call.

Google SERP – Top 100 quick start example

Run these examples to return positions 1–100 with one request (update your API key).
Use start_page and end_page to fetch all pages from the first to the last you specify; for example, 1..10 gets pages 1–10, which is roughly the top 100 results.
curl -X POST "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_mfz5x93lmsjjjylob&include_errors=true" \
  -H "Authorization: Bearer ${API_KEY}" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "url": "https://www.google.com/",
      "keyword": "pizza",
      "language": "en",
      "country": "US",
      "start_page": 1,
      "end_page": 10
    },
    {
      "url": "https://www.google.com/",
      "keyword": "coffee",
      "language": "de",
      "country": "DE",
      "start_page": 1,
      "end_page": 10
    }
  ]'
This is an async request: the trigger returns a snapshot_id; use the Progress API to track it and the Download API to fetch results when ready.
page_html is the original SERP page returned with your results, use it to verify positions, inspect ads/features, or re‑parse later.

Optional: Localize or limit depth

  • Localize: set language and country (e.g., de + DE)
  • Limit depth: set start_page and end_page to the exact page range you need (e.g., 1..2 ≈ Top 20, 1..5 ≈ Top 50); smaller ranges return faster and produce smaller payloads
cURL (DE locale, Top 20)
curl -X POST "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_mfz5x93lmsjjjylob&include_errors=true" \
  -H "Authorization: Bearer ${API_KEY}" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "url": "https://www.google.com/",
      "keyword": "pizza",
      "language": "de",
      "country": "DE",
      "start_page": 1,
      "end_page": 2
    }
  ]'
I