Search APIs
Loading…
← API Store
Search & SEO

Google

Google

Google AI mode answer

GET /google/v1/ai-mode
Test this endpoint

Every response includes credits_used: the credits this call cost.

Each call costs 4 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.

Every endpoint also takes: raw、fields、fresh、output、records

{
  "all_sources": [
    {
      "google_link": "https://www.google.com/goto?url=CAEScwHrOzAV4J_lYpP0LxDfELCXYwH2f0YxZS51k-L0Vpep2u3kVAc2xwyktZfoRIlFNnIAzCNZFa2PrhoaLB3iIN8NllwuBWkJhwlh3XR6…",
      "label": "Bon Appétit: Recipes, Cooking, Entertaining, Restaurants | Bon Appétit"
    }
  ],
  "answer": "Finding the right coffee machine depends entirely on how you like to brew your morning cup—whether you prefer a quick single-serve pod, a la…",
  "blocks": [
    {
      "tag": "h3",
      "text": "AI Mode reply for coffee machine"
    },
    {
      "tag": "li",
      "text": "Hamilton Beach 12 Cup Programmable Coffee Maker 52580270 46290"
    },
    "… 54 more"
  ],
  "cached": false,
  "credits_used": 1,
  "images": [
    "https://encrypted-tbn1.gstatic.com/faviconV2?url=https://www.google.com&client=AIM&size=128&type=FAVICON&fallback_opts=TYPE,SIZE,URL",
    "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRMaD5ca9hrUjjVZMWDV9OHsNGqfCeX-uaXPuu9lbIcEq12xfRCUJGRT7xNxfmDg3uCKbTb5I24ceT_Ct4",
    "… 10 more"
  ],
  "links": [
    {
      "href": "https://myactivity.google.com/search-services/history/search?utm_source=aim&utm_campaign=aim_tm",
      "label": "See your Search history"
    },
    {
      "href": "https://www.google.com/search-personalization/",
      "label": "Personalization"
    },
    "… 44 more"
  ],
  "query": "coffee machine",
  "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": "coffee machine",
    "safe": null,
    "start": 0,
    "tbs": null,
    "type": "web"
  },
  "sources": [
    {
      "google_link": "https://www.google.com/goto?url=CAEScwHrOzAV4J_lYpP0LxDfELCXYwH2f0YxZS51k-L0Vpep2u3kVAc2xwyktZfoRIlFNnIAzCNZFa2PrhoaLB3iIN8NllwuBWkJhwlh3XR6…",
      "label": "Bon Appétit: Recipes, Cooking, Entertaining, Restaurants | Bon Appétit",
      "url": "https://www.bonappetit.com/story/best-drip-coffee-makers"
    }
  ]
}
Response fields (40)

Field paths and types observed in the sample response; the live response is authoritative.

$object
$.all_sourcesarray
$.all_sources[]object
$.all_sources[].google_linkstring
$.all_sources[].labelstring
$.answerstring
$.blocksarray
$.blocks[]object | string
$.blocks[].tagstring
$.blocks[].textstring
$.cachedboolean
$.credits_usedinteger
$.imagesarray
$.images[]string
$.linksarray
$.links[]object | string
$.links[].hrefstring
$.links[].labelstring
$.querystring
$.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
$.sourcesarray
$.sources[]object
$.sources[].google_linkstring
$.sources[].labelstring
$.sources[].urlstring