Skip to content

Structured Google data: send queries. Single lookup, 1 credit per successful call.

GET · POST1 credit / successful callSingle lookupLong-running
GEThttps://api.scrapier.io/api/v2/google-search/Open in Playground

Call GET /api/v2/google-search/ with queries. The results are in data.results. 8 optional parameters refine the call (see Parameters).

Terminal window
curl -G "https://api.scrapier.io/api/v2/google-search/" \
-H "X-API-Key: YOUR_API_KEY" \
--data-urlencode "queries=latest technology news" \
--max-time 210
NameTypeRequiredDefaultDescription
X-API-Key headerstringyes—Your API key from the dashboard.
queriesstringyese.g. latest technology newsSearch keyword (max 2048 characters). Required on every call.
pageintegerno1Google result page to fetch (1-50, 10 results per page). Request any page directly (1, 2, 3 ...) with the same query and filters; the response's next_page is null when there are no more results.
countryCodestringnousCountry code (e.g. us, gb, de).
languageCodestringnoenUI language code (e.g. en, fr, de).
dateRangestringno—Only results from the last hour/day/week/month/year (empty = any time)
hourdayweekmonthyear
sitestringno—Restrict results to one site (adds site:<domain>), e.g. github.com
includeUnfilteredResultsbooleannofalseInclude omitted near-duplicate results (filter=0)
use_fallbackbooleannotrueWhen Google blocks a page, fall back to a real-browser rendered Google SERP
Advanced
NameTypeDefaultDescription
use_proxybooleantrueRoute the request through Scrapier's residential proxy pool. Default: true. Leave as is unless support tells you otherwise.
raw_databooleanfalseWhen true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under raw_responses, in place of the formatted items. When false (default) you get the formatted output. Pagination (cursor / next_cursor) works the same in both modes.
{
"success": true,
"data": {
"queries": "best laptops 2026",
"page": 1,
"page_size": 10,
"results": [
{
"url": "https://www.example.com/best-laptops-2026",
"position": 1,
"title": "Best Laptops 2026: Top Picks",
"displayedUrl": "example.com › best-laptops-2026",
"siteName": "example.com",
"description": "Our roundup of the best laptops to buy in 2026...",
"date": null,
"emphasizedKeywords": [
"laptops"
],
"siteLinks": [],
"relatedQueries": [
"best laptops 2026 for students"
],
"scrapedAt": "2026-11-03T10:00:00+00:00"
}
],
"has_next_page": true,
"next_page": 2
}
}

Sample from the live catalog; arrays trimmed to 3 items. Results are in data.results.

FieldTypeExampleDescription
queriesstringbest laptops 2026—
pageinteger1—
page_sizeinteger10—
resultsarray[1 item]The results.
has_next_pagebooleantrue—
next_pageinteger2—
results[].urlstringhttps://www.example.com/best-laptops-2026—
results[].positioninteger1—
results[].titlestringBest Laptops 2026: Top Picks—
results[].displayedUrlstringexample.com › best-laptops-2026—
results[].siteNamestringexample.com—
results[].descriptionstringOur roundup of the best laptops to buy in 202…—
results[].datenullnull—
results[].emphasizedKeywordsarray[1 item]—
results[].siteLinksarray[]—
results[].relatedQueriesarray[1 item]—
results[].scrapedAtstring2026-11-03T10:00:00+00:00—

Returns everything in one call; next_cursor is always null.

Failed calls are free. Branch on the HTTP status and read the message from error (or detail). Full details in Errors.

StatusMeaningRetry?Charged?
400Bad or missing input.No — fix the paramsNo
401 / 403Missing, invalid or revoked API key.No — fix the keyNo
402Out of credits (body has balance).No — top upNo
404Unknown endpoint slug.No — check the slugNo
429 / 503Busy or throttled.Yes — after Retry-AfterNo
5xxTarget site or upstream failure, or timeout.Yes — with backoffNo
  • This endpoint can take several minutes. Set your client timeout to at least 210 seconds.
  • Google Maps Places — Search Google Maps for places matching a keyword around a location and get names, ratings, addresses and place IDs.
  • Google Ad Library Leads — Structured Google data: send urls. Single lookup, 1 credit per successful call.
  • Google Ad Transparency — Structured Google data: send urls. Cursor-paginated, 1 credit per successful call.
  • Google Autocomplete — Structured Google data: send queries. Cursor-paginated, 1 credit per successful call.