Google web search
GET /google/v1/searchGoogle results with every Google option: country / location / language, time and date range, result type (web, news, images, videos, shopping, books), site and file-type filters, SafeSearch, desktop or mobile, and up to 100 results per call (limit). All options are free except limit, which loads one results page per 10 results. Pass next_page from the previous response; next_page is null on the last page. Each web result has url (the exact address) and google_link. Google now holds some result links on a verification page for about a minute after a search, so url can be null: then site_url gives the site and url_guess the address rebuilt from the green breadcrumb (null when Google shortened it).
Every response includes credits_used: the credits this call cost.
Each call costs 3 credits; failed calls are free. Run it in the console playground to see a live result.
Parameters
| Name | Type | Description |
|---|---|---|
qrequired | string | Search query (also accepted as query or keyword). Example: coffee machine |
country | string | Results for this country (Google gl, and the location defaults to it). Two-letter code. Example: us |
location | string | Search as if from this place, e.g. `Austin,Texas,United States` (Google uule). Default: the country. |
language | string | Interface language (Google hl), e.g. en, de, pt-BR. Example: en |
lr | string | Only results in these languages, e.g. `en` or `en|de`. |
cr | string | Only results from these countries, e.g. `US` or `US|GB`. |
time | string | Only results from the past hour, day, week, month or year; `day_3` = past 3 days. |
date_from | string | Only results from this date (YYYY-MM-DD). |
date_to | string | Only results up to this date (YYYY-MM-DD). |
sort | string | `date` sorts newest first (news). |
tbs | string | Raw Google tbs filter, combined with the options above. |
google_domain | string | Google domain, e.g. google.co.uk. |
safe | string | SafeSearch: on or off. |
autocorrect | string | 0 searches the query exactly as typed (no spelling correction). |
filter | string | 0 also shows near-duplicate results. |
site | string | Only these sites, comma-separated (site:). |
exclude_sites | string | Leave these sites out, comma-separated (-site:). |
filetype | string | Only this file type, e.g. pdf. |
device | string | desktop (default) or mobile results. |
type | string | web (default), news, images, videos, shopping or books. Example: web |
page | integer | Page number (10 results each). Pass next_page from the previous response. |
start | integer | Result offset instead of page (0, 10, 20, ...). |
limit | integer | How many results (1-100). Each 10 results is one more results page. Example: 10 |
resolve | string | 1 (default) turns Google's /goto links into the real URLs; 0 skips that. Example: 1 |
size | large | medium | icon | 2mp | 4mp | 8mp | 12mp | 20mp | large, medium, icon, 2mp, 4mp, 8mp, 12mp, 20mp (larger than). |
color | string | color, grayscale, transparent, or a colour: red, orange, yellow, green, teal, blue, purple, pink, white, gray, black, brown. |
image_type | photo | clipart | line | gif | face | photo, clipart, line, gif, face. |
aspect | square | tall | wide | panoramic | square, tall, wide, panoramic. |
license | creative_commons | commercial | creative_commons or commercial. |
image_format | jpg | png | gif | bmp | svg | webp | ico | raw | jpg, png, gif, bmp, svg, webp, ico, raw. |
duration | short | medium | long | short (<4 min), medium (4-20 min), long (>20 min). |
hd | string | 1: high quality only. |
captions | string | 1: with closed captions only. |
Every endpoint also takes: raw、fields、fresh、output、records
{
"ads": [],
"ai_overview": null,
"cached": false,
"credits_used": 2,
"featured_snippet": null,
"knowledge_panel": null,
"local_results": [],
"next_page": 2,
"next_start": 10,
"page": 1,
"pages_fetched": 1,
"people_also_ask": [],
"people_also_ask_detail": [],
"query": "espresso machine",
"related_searches": [],
"results": [
{
"date": null,
"docid": null,
"google_link": null,
"href": "https://books.google.com/books?id=BYEAEgAAQBAJ&printsec=frontcover&dq=espresso+machine&hl=en&newbks=1&newbks_redir=1&sa=X&ved=2ahUKEwi75v_H-…",
"image": null,
"image_alt": null,
"landing_page": null,
"position": 1,
"price": null,
"source": null,
"text": "Coffee Machine Buying Guide: The Complete Guide to Espresso ... books.google.com › books Rowan Aldwick · 2026 Inside you'll discover how to:…",
"title": "Coffee Machine Buying Guide: The Complete Guide to Espresso ...",
"url": "https://books.google.com/books?id=BYEAEgAAQBAJ&printsec=frontcover&dq=espresso+machine&hl=en&newbks=1&newbks_redir=1&sa=X&ved=2ahUKEwi75v_H-…"
},
{
"date": null,
"docid": null,
"google_link": null,
"href": "https://books.google.com/books?id=rYCN0QU-5-8C&pg=PA25&dq=espresso+machine&hl=en&newbks=1&newbks_redir=1&sa=X&ved=2ahUKEwi75v_H-NCXAxVO_7sIH…",
"image": null,
"image_alt": null,
"landing_page": null,
"position": 2,
"price": null,
"source": null,
"text": "Kompendium semantische Netze: Konzepte, Technologie, ... - Page 25 books.google.com › books · Translate this page Klaus Reichenberger · 2010…",
"title": "Kompendium semantische Netze: Konzepte, Technologie, ... - Page 25",
"url": "https://books.google.com/books?id=rYCN0QU-5-8C&pg=PA25&dq=espresso+machine&hl=en&newbks=1&newbks_redir=1&sa=X&ved=2ahUKEwi75v_H-NCXAxVO_7sIH…"
},
"… 8 more"
],
"search_parameters": {
"autocorrect": true,
"country": "us",
"cr": null,
"device": "desktop",
"filter": true,
"google_domain": "google.com",
"language": "en",
"limit": 10,
"location": "United States",
"lr": null,
"q": "espresso machine",
"safe": null,
"start": 0,
"tbs": null,
"type": "books"
},
"search_url": "https://www.google.com/search?q=espresso+machine&hl=en&gl=us&uule=w%2BCAIQICINVW5pdGVkIFN0YXRlcw&tbm=bks",
"spelling": null,
"top_stories": [],
"total": null,
"videos": []
} Response fields (52)
Field paths and types observed in the sample response; the live response is authoritative.
$ | object |
$.ads | array |
$.ai_overview | null |
$.cached | boolean |
$.credits_used | integer |
$.featured_snippet | null |
$.knowledge_panel | null |
$.local_results | array |
$.next_page | integer |
$.next_start | integer |
$.page | integer |
$.pages_fetched | integer |
$.people_also_ask | array |
$.people_also_ask_detail | array |
$.query | string |
$.related_searches | array |
$.results | array |
$.results[] | object | string |
$.results[].date | null |
$.results[].docid | null |
$.results[].google_link | null |
$.results[].href | string |
$.results[].image | null |
$.results[].image_alt | null |
$.results[].landing_page | null |
$.results[].position | integer |
$.results[].price | null |
$.results[].source | null |
$.results[].text | string |
$.results[].title | string |
$.results[].url | string |
$.search_parameters | object |
$.search_parameters.autocorrect | boolean |
$.search_parameters.country | string |
$.search_parameters.cr | null |
$.search_parameters.device | string |
$.search_parameters.filter | boolean |
$.search_parameters.google_domain | string |
$.search_parameters.language | string |
$.search_parameters.limit | integer |
$.search_parameters.location | string |
$.search_parameters.lr | null |
$.search_parameters.q | string |
$.search_parameters.safe | null |
$.search_parameters.start | integer |
$.search_parameters.tbs | null |
$.search_parameters.type | string |
$.search_url | string |
$.spelling | null |
$.top_stories | array |
$.total | null |
$.videos | array |