Skip to content
Gridlode
Docs · Reference

Google Search

GET /v1/search/google3 credits / pagecache 60 min

One Google results page for any query, country, language, city-level location and device: organic results with sitelinks, dates and snippets, plus People also ask, related searches, top stories, the local pack, the knowledge graph and the AI Overview when Google shows one. Each page is 10 results; page N returns results N*10-9 to N*10 and is billed as N pages, because the first N*10 results are fetched. Set light=true for organic results only. Every response carries a confidence score. Google requires JavaScript from automated visitors, so results come from a licensed results feed rather than our own scrapers; failed requests are never charged.

Query parameters

q
string · required
Search query.
gl
string
Country to search from, e.g. us, gb, de.
Default: "us"
hl
string
Interface language, e.g. en, de, pt-BR.
Default: "en"
num
integer
Results per page. Always 10: Google removed num=100 in September 2025. For deeper rankings request page=2..10 (one request per page).
Default: 10
page
integer
Results page (1-10); page 2 = results 11-20.
Default: 1
location
string
Search as if from this place, as a Google canonical location name such as 'Austin,Texas,United States' (sent as the uule parameter).
Default: null
device
string
Desktop or mobile results.
Default: "desktop"
Allowed: desktop, mobile
safe
string
SafeSearch filtering.
Default: "off"
Allowed: off, active
light
boolean
Organic results only (smaller, faster response).
Default: false
max_age
integer
Accept a cached answer up to this many seconds old, billed at 50%.

Response data fields

    Example

    curl "https://api.gridlode.com/v1/search/google?q=python%20programming%20language" \
  -H "Authorization: Bearer $GRIDLODE_KEY"

    Try it without code on the Google Search API page.