Google Search
google_searchGoogle web search results (organic results, featured snippets, related questions and more) for any country, city-level location, language and device. 1 credit.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | ||
| uule | No | Advanced: a raw Google uule value ("w+...", "a+...", "j+..."), plain or URL-encoded as copied from a Google URL. Use location instead unless you already have uule values. | |
| pages | No | Fetch pages 1..pages (up to 3) in this one request: the result has a "pages" array, one entry per page with its own status, credits and output (html_url, or the parsed results). 1 credit per page; a failed page, or a page whose AI Overview timed out, is free. wait_for_ai_overview applies to page 1. Not with page. | |
| query | Yes | ||
| device | No | "desktop" (default), "mobile" (Android phone, Pixel 8), "iphone" (iPhone 15, Safari), "ipad" (iPad Air, Safari) or "galaxy" (Samsung Galaxy S24, Chrome). | desktop |
| country | No | Two-letter country code. Defaults to "us", or to the country of location. | |
| language | No | en | |
| location | No | Search from a city, region or postal code: a Google canonical location name, "City,Region,Country" (Google Ads geotarget format), e.g. "Austin,Texas,United States". When country is omitted it is taken from the location. | |
| strict_geo | No | Internal, not documented: crawl from an exit in the request's own country. | |
| resolve_links | No | Resolve Google's encrypted /goto result links to their real destinations. Google lets a page's links be resolved all at once only a couple of minutes after serving it, so on async jobs and batches the job stays "processing" (links_status "pending") until all are resolved, about 3 minutes after the crawl, and then completes with one webhook. On the live queue it answers at once with about 5-6 links per page resolved, result titles first (up to about 10 seconds). With output "html" the page's hrefs are rewritten (unresolved ones keep Google's href). In parsed JSON a link is never a Google redirect: one not resolved is the site's home page and carries link_unresolved: true. | |
| wait_for_ai_overview | No | Wait (up to about 10 seconds) for the AI Overview to finish loading before the page is captured. A page whose AI Overview does not load in time (ai_overview_status "timeout") costs 0 credits. |