Search APIs
Loading…
← API Store
Search & SEO

Google

Google

Google web search

GET /google/v1/search
Test this endpoint

Google 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

NameTypeDescription
qrequiredstringSearch query (also accepted as query or keyword). Example: coffee machine
countrystringResults for this country (Google gl, and the location defaults to it). Two-letter code. Example: us
locationstringSearch as if from this place, e.g. `Austin,Texas,United States` (Google uule). Default: the country.
languagestringInterface language (Google hl), e.g. en, de, pt-BR. Example: en
lrstringOnly results in these languages, e.g. `en` or `en|de`.
crstringOnly results from these countries, e.g. `US` or `US|GB`.
timestringOnly results from the past hour, day, week, month or year; `day_3` = past 3 days.
date_fromstringOnly results from this date (YYYY-MM-DD).
date_tostringOnly results up to this date (YYYY-MM-DD).
sortstring`date` sorts newest first (news).
tbsstringRaw Google tbs filter, combined with the options above.
google_domainstringGoogle domain, e.g. google.co.uk.
safestringSafeSearch: on or off.
autocorrectstring0 searches the query exactly as typed (no spelling correction).
filterstring0 also shows near-duplicate results.
sitestringOnly these sites, comma-separated (site:).
exclude_sitesstringLeave these sites out, comma-separated (-site:).
filetypestringOnly this file type, e.g. pdf.
devicestringdesktop (default) or mobile results.
typestringweb (default), news, images, videos, shopping or books. Example: web
pageintegerPage number (10 results each). Pass next_page from the previous response.
startintegerResult offset instead of page (0, 10, 20, ...).
limitintegerHow many results (1-100). Each 10 results is one more results page. Example: 10
resolvestring1 (default) turns Google's /goto links into the real URLs; 0 skips that. Example: 1
sizelarge | medium | icon | 2mp | 4mp | 8mp | 12mp | 20mplarge, medium, icon, 2mp, 4mp, 8mp, 12mp, 20mp (larger than).
colorstringcolor, grayscale, transparent, or a colour: red, orange, yellow, green, teal, blue, purple, pink, white, gray, black, brown.
image_typephoto | clipart | line | gif | facephoto, clipart, line, gif, face.
aspectsquare | tall | wide | panoramicsquare, tall, wide, panoramic.
licensecreative_commons | commercialcreative_commons or commercial.
image_formatjpg | png | gif | bmp | svg | webp | ico | rawjpg, png, gif, bmp, svg, webp, ico, raw.
durationshort | medium | longshort (<4 min), medium (4-20 min), long (>20 min).
hdstring1: high quality only.
captionsstring1: 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
$.adsarray
$.ai_overviewnull
$.cachedboolean
$.credits_usedinteger
$.featured_snippetnull
$.knowledge_panelnull
$.local_resultsarray
$.next_pageinteger
$.next_startinteger
$.pageinteger
$.pages_fetchedinteger
$.people_also_askarray
$.people_also_ask_detailarray
$.querystring
$.related_searchesarray
$.resultsarray
$.results[]object | string
$.results[].datenull
$.results[].docidnull
$.results[].google_linknull
$.results[].hrefstring
$.results[].imagenull
$.results[].image_altnull
$.results[].landing_pagenull
$.results[].positioninteger
$.results[].pricenull
$.results[].sourcenull
$.results[].textstring
$.results[].titlestring
$.results[].urlstring
$.search_parametersobject
$.search_parameters.autocorrectboolean
$.search_parameters.countrystring
$.search_parameters.crnull
$.search_parameters.devicestring
$.search_parameters.filterboolean
$.search_parameters.google_domainstring
$.search_parameters.languagestring
$.search_parameters.limitinteger
$.search_parameters.locationstring
$.search_parameters.lrnull
$.search_parameters.qstring
$.search_parameters.safenull
$.search_parameters.startinteger
$.search_parameters.tbsnull
$.search_parameters.typestring
$.search_urlstring
$.spellingnull
$.top_storiesarray
$.totalnull
$.videosarray