{"uid":"cap_er1DpsfGwm6AMNSMQEZcR","slug":"agents-litescrape-com-search-google-via-litescrape-72f7a601","name":"Search Google via Litescrape","description":"Runs a Google Search and returns the parsed results page: organic_results (position, title, link, displayed_link, snippet), knowledge_graph when Google shows a panel, related_searches, ai_overview when Google generates one, plus search_metadata and the normalized search_parameters. Search by q, or resolve one entity by ludocid or kgmid. Localize with google_domain, gl, hl, and device, bias to a place with location, uule, or lat and lon, narrow by date or vertical with tbs and tbm, and use the as_ parameters for exact phrases, exclusions, numeric ranges, and site restrictions. Page with start. One call is one request.","url":"https://agents.litescrape.com/api/google/search","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"q":{"type":"string","maxLength":2048,"description":"Search query. Required unless ludocid or kgmid is supplied."},"cr":{"type":"string","description":"Country restrictions such as countryUS, joined with |."},"gl":{"type":"string","maxLength":2,"minLength":2,"description":"Two-letter country code for result localization, lowercase."},"hl":{"type":"string","default":"en","description":"Interface and result language code, such as en, en-GB, or de."},"lr":{"type":"string","description":"Language restrictions such as lang_en, joined with |."},"oq":{"type":"string","description":"Autocomplete original-query lineage value, forwarded verbatim."},"si":{"type":"string","description":"Opaque cached Google search context from a previous response."},"ibp":{"type":"string","description":"Google layout or expansion control token."},"lat":{"type":"number","maximum":90,"minimum":-90,"description":"Latitude of the search origin. Requires lon; conflicts with location and uule."},"lon":{"type":"number","maximum":180,"minimum":-180,"description":"Longitude of the search origin. Requires lat; conflicts with location and uule."},"num":{"type":"integer","maximum":100,"minimum":1,"description":"Best-effort first-page result count, 1 to 100."},"tbm":{"enum":["lcl","vid","nws","shop","pts"],"type":"string","description":"Google vertical: local, video, news, shopping, or patents. Images are not supported."},"tbs":{"type":"string","description":"Google native date or search filter string."},"uds":{"type":"string","description":"Opaque Google filter token from a previous response."},"as_q":{"type":"string","description":"Additional all-of search terms."},"lsig":{"type":"string","description":"Opaque Knowledge Graph or local-pack signature from a previous response."},"nfpr":{"enum":["0","1"],"type":"string","description":"Set 1 to exclude auto-corrected queries."},"safe":{"enum":["active","off"],"type":"string","description":"Adult-content filtering."},"uule":{"type":"string","maxLength":2048,"description":"Pre-encoded Google location token. Conflicts with location."},"as_dt":{"enum":["i","e"],"type":"string","description":"Include (i) or exclude (e) the as_sitesearch host. Requires as_sitesearch."},"as_eq":{"type":"string","description":"Phrase the results must not contain."},"as_lq":{"type":"string","format":"uri","description":"Only pages that link to this URL."},"as_oq":{"type":"string","description":"Any-of search terms."},"as_rq":{"type":"string","format":"uri","description":"Pages related to this URL."},"gs_lp":{"type":"string","description":"Google gs_lp autocomplete-session token, forwarded verbatim."},"kgmid":{"type":"string","description":"Knowledge Graph machine ID, such as /m/0k8z, to search for one entity instead of a query."},"start":{"type":"integer","default":0,"minimum":0,"description":"Result offset."},"as_epq":{"type":"string","description":"Exact phrase the results must contain."},"as_nhi":{"type":"string","description":"Upper bound of an inclusive numeric range. Requires as_nlo."},"as_nlo":{"type":"string","description":"Lower bound of an inclusive numeric range. Requires as_nhi."},"as_qdr":{"type":"string","description":"Quick date range: d, w, m, or y with an optional count, such as m3."},"device":{"enum":["desktop","tablet","mobile"],"type":"string","default":"desktop","description":"Device layout Google renders."},"filter":{"enum":["0","1"],"type":"string","description":"Set 0 to include similar results Google would otherwise omit."},"radius":{"type":"number","maximum":1000,"minimum":1,"description":"Search-bias radius in meters around location or lat/lon. Desktop accepts 1 to 199, tablet and mobile 1 to 1,000."},"ludocid":{"type":"string","description":"Google local CID to search for one entity instead of a query."},"sclient":{"type":"string","description":"Google client identifier such as gws-wiz-serp."},"location":{"type":"string","maxLength":512,"description":"Human-readable search origin, such as Austin, Texas. Conflicts with uule."},"color_scheme":{"enum":["light","dark"],"type":"string","description":"Result color presentation."},"as_sitesearch":{"type":"string","description":"Site hostname to include or exclude."},"google_domain":{"type":"string","default":"google.com","description":"Google domain to query, such as google.com or google.co.uk."}}},"responseSchema":{"type":"object","properties":{"pagination":{"type":"object","description":"Present when more results exist: next (a ready-made URL for the next page) or next_page_token."},"ai_overview":{"type":"object","description":"Google's AI Overview when one is generated: text_blocks and sources."},"knowledge_graph":{"type":"object","description":"Knowledge Graph panel when Google shows one: title, type, kgmid, description."},"organic_results":{"type":"array","items":{"type":"object"},"description":"Ranked results: position, title, link, displayed_link, snippet."},"search_metadata":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string"},"total_time_taken":{"type":"number"}}},"related_searches":{"type":"array","items":{"type":"object"},"description":"Related search blocks with their items and links."},"search_parameters":{"type":"object","description":"The request parameters as normalized by the API."}},"description":"Successful responses carry request metadata, the normalized parameters, and the result groups available for the operation. Optional groups are omitted when the source does not provide them. Errors are a JSON body with error, error_code, status_code, request_id, retryable, and the echoed search_parameters."},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.000150","displayCostAsset":"USD","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":1,"rating":{"score":"0.58","successRate":"0.00","reviews":1,"stars":"3.3","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.000150/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.000150","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.000150","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_vFOn_5hlYMPagCew9Spvx","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.000150","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.litescrape.com","brandSlug":"agents-litescrape-com-mpp","brandBaseUrl":"https://agents.litescrape.com","brandDocsUrl":null,"whatItDoes":"Runs a Google Search and returns structured parsed results including organic results, knowledge graph, AI overview, and related searches","exampleAgentPrompt":"Search Google for 'best noise-cancelling headphones 2024' and give me the top 10 organic results with titles, links, and snippets, localized to the US in English.","exampleUseCases":[{"title":"Competitive research via Google SERP","prompt":"Search Google for 'project management software alternatives to Asana' and return the top 20 organic results with titles, snippets, and links so I can analyze what competitors are ranking."},{"title":"Breaking news lookup by topic","prompt":"Search Google News for 'Federal Reserve interest rate decision' from the past week — use the news vertical and return the top results with titles and links."},{"title":"Entity lookup via Knowledge Graph","prompt":"Look up the Knowledge Graph entity with kgmid '/m/0k8z' on Google and return the knowledge panel details like the title, type, and description."}],"resultDescription":"Returns a JSON object containing: organic_results (array of ranked web results with position, title, link, displayed_link, snippet), knowledge_graph (panel data when present, with title, type, kgmid, description), ai_overview (text blocks and sources when Google generates one), related_searches (array of related query blocks), search_metadata (request ID, status, time taken), and search_parameters (normalized input parameters). Pagination info is included when more results are available.","failureModes":["Missing required parameter: q, ludocid, or kgmid must be provided — returns 400 error with error_code","Conflicting location parameters (e.g. both location and uule, or lat/lon with location) — returns 400","Unsupported tbm vertical (e.g. images) — returns 400 or empty results","Rate limiting or quota exhaustion — returns 402 or 429 with retryable flag","Google returns no results for the query — empty organic_results array","Invalid gl or hl code — may silently fall back to defaults"],"whenToPreferThis":"Choose this endpoint when you need structured Google Search results as JSON without managing browsers, proxies, or scraping infrastructure. Prefer it over Bing or DuckDuckGo endpoints when Google's index quality, Knowledge Graph, or AI Overview is specifically needed. Use it over the 'Ask Google AI Mode' endpoint when you want full SERP data (organic results + knowledge graph + related searches) rather than just a generated AI answer. Use it over Google Maps endpoints when you need web search results, not place/business listings.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-09-16T23:33:26.215Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-19T18:35:00.709Z","isFirstParty":false}