{"uid":"cap_piMzknAFCSVXvCUO-Mr9s","slug":"agents-openwebninja-com-openweb-ninja-search-full-heavy-serp-ee058e15","name":"OpenWeb Ninja Search Full (Heavy SERP)","description":"Get real-time full-depth web search results via the heavy serp path, including organic results, ads, AI overviews, knowledge graph, places, top stories, inline videos, answer box, and discussions. Supports Google Search parameters (gl, hl, tbs, etc.) and city-level geo targeting. Note: Each request to this endpoint consumes 2 request credits.","url":"https://agents.openwebninja.com/realtime-web-search/search-full?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["q"],"properties":{"q":{"type":"string","example":"albert einstein","description":"Search query. Supports all Google Advanced Search operators (site:, inurl:, intitle:, etc)."},"gl":{"type":"string","default":"us","description":"The country / region for which to make the query. 2-letter country code, see ISO 3166-1 alpha-2."},"hl":{"type":"string","default":"en","description":"The language to use for the search (Google's hl parameter). 2-letter language code, see ISO 639-1 alpha-2."},"lr":{"type":"string","description":"Restrict search results to a specific language. Uses lang_{two-letter language code} with | as delimiter (e.g. lang_fr|lang_de searches French and German pages only)."},"nhr":{"enum":["0","1"],"type":"string","default":"0","description":"Exclude 'People also ask' style related questions from the results with nhr=1. Include them with nhr=0 (default)."},"num":{"type":"integer","default":10,"maximum":10,"minimum":1,"description":"Maximum number of organic results to return per request (1-10)."},"tbs":{"type":"string","description":"Advanced Google search parameters that aren't available using regular query parameters (e.g. qdr:d for the last day, qdr:w for the last week)."},"nfpr":{"enum":["0","1"],"type":"string","default":"0","description":"Exclude results of the auto-corrected query when the original query is misspelled with nfpr=1, and include them with nfpr=0 (default)."},"uule":{"type":"string","description":"Google's own encoded location string (e.g. w+CAIQICIgU2VhdHRsZSxXYXNoaW5ndG9uLFVuaXRlZCBTdGF0ZXM=), passed to Google as is. Use it instead of location when you already generate uule values. Cannot be combined with location."},"start":{"type":"integer","default":0,"description":"Number of results to skip for pagination (default 0)."},"device":{"enum":["desktop","mobile","tablet"],"type":"string","default":"desktop","description":"The device to simulate for the search. Mobile and tablet return Google's mobile SERP layout, whose rankings and features can differ from desktop. Allowed values: desktop (default), mobile, tablet."},"location":{"type":"string","description":"Where the search originates from. Recommended to specify at city level to simulate a real user's search (e.g. London, England, United Kingdom). See https://openwebninja.s3.us-east-1.amazonaws.com/locations.json for the list of supported locations."},"fetch_ai_overviews":{"type":"boolean","default":false,"description":"Whether to return AI Overviews when available (false by default). When true or 1, if AI Overviews are available, each request consumes two request credits instead of one."},"return_organic_result_video_thumbnail":{"type":"boolean","default":false,"description":"Whether to return a base64-encoded video_thumbnail field for organic video results (false by default)."}}},"responseSchema":{"type":"object","required":["status","request_id","parameters","data"],"properties":{"data":{"type":"object","required":["organic_results","has_ai_overviews"],"properties":{"ads":{"type":"array","items":{"type":"object"},"nullable":true,"description":"Sponsored / ad results, when Google surfaces them for this query."},"places":{"type":"array","items":{"type":"object"},"nullable":true,"description":"Local pack / places results, when Google surfaces them for this query."},"answer_box":{"type":"object","nullable":true,"properties":{"type":{"type":"string","description":"Answer box variant. Examples: instant_answer, calculator, definition."},"answer":{"type":"string","nullable":true,"description":"Plain-text answer Google displays."}},"description":"Google answer box (instant answer / calculator / definition), when Google surfaces one."},"top_stories":{"type":"array","items":{"type":"object"},"nullable":true,"description":"Top Stories results, when Google surfaces them for this query."},"ai_overviews":{"type":"object","nullable":true,"properties":{"text_parts":{"type":"array","items":{"type":"object","required":["type"],"properties":{"list":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Item body text."},"title":{"type":"string","nullable":true,"description":"Bold label preceding the item text, when present."}}},"nullable":true,"description":"Items of a list fragment."},"text":{"type":"string","nullable":true,"description":"Text content of paragraph/heading fragments."},"type":{"type":"string","description":"Fragment kind. Values: paragraph, heading, list."},"ordered":{"type":"boolean","nullable":true,"description":"Whether a list fragment is ordered."}}},"description":"Sequenced fragments composing the AI Overview body (paragraphs, headings, lists, images)."},"reference_links":{"type":"array","items":{"type":"object","required":["title","link"],"properties":{"date":{"type":"string","nullable":true,"description":"Publication date of the cited page."},"link":{"type":"string","description":"URL of the cited page."},"title":{"type":"string","description":"Title of the cited page."},"source":{"type":"string","nullable":true,"description":"Publisher / source label."},"snippet":{"type":"string","nullable":true,"description":"Short excerpt of the cited page."}}},"description":"Citation links referenced by the AI Overview."}},"description":"Google's AI Overview block (only present when fetch_ai_overviews=true and AI Overviews are available)."},"inline_videos":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","description":"Video URL."},"title":{"type":"string","description":"Video title with source label."},"domain":{"type":"string","nullable":true,"description":"Video host domain."},"duration":{"type":"string","nullable":true,"description":"Duration label (e.g. '4:14')."},"position":{"type":"integer","description":"Position within the inline videos block."}}},"nullable":true,"description":"Inline video results."},"knowledge_graph":{"type":"object","nullable":true,"properties":{"type":{"type":"string","nullable":true,"description":"Entity type label (e.g. 'Theoretical physicist')."},"kgmid":{"type":"string","nullable":true,"description":"Google Knowledge Graph machine ID."},"title":{"type":"string","nullable":true,"description":"Entity title."},"attributes":{"type":"object","nullable":true,"description":"Free-form key/value attributes Google surfaces for the entity (e.g. born, died, spouse).","additionalProperties":{"type":"string"}},"description":{"type":"string","nullable":true,"description":"Short description of the entity."}},"description":"Knowledge Graph entity panel, when Google returns one for this query."},"organic_results":{"type":"array","items":{"type":"object","required":["title","url","position","rank"],"properties":{"url":{"type":"string","description":"Canonical URL of the result."},"date":{"type":"string","nullable":true,"description":"Date associated with the result, when Google surfaces one."},"rank":{"type":"integer","description":"Absolute rank across all pages returned (1-based)."},"title":{"type":"string","description":"Title of the search result."},"domain":{"type":"string","nullable":true,"description":"Domain extracted from the result URL."},"source":{"type":"string","nullable":true,"description":"Source / publisher label shown by Google."},"snippet":{"type":"string","nullable":true,"description":"Short text snippet shown by Google under the result."},"position":{"type":"integer","description":"Position of the result within the page (1-based)."},"rich_snippet":{"type":"object","nullable":true,"properties":{"price":{"type":"string","nullable":true,"description":"Displayed price of the item, including the currency symbol as shown by Google."},"rating":{"type":"number","nullable":true,"description":"Average customer rating of the item."},"reviews":{"type":"string","nullable":true,"description":"Number of customer reviews as displayed by Google, which may be abbreviated (for example 1.2k)."},"delivery":{"type":"string","nullable":true,"description":"Delivery or shipping information as displayed by Google."},"rating_max":{"type":"integer","nullable":true,"description":"Highest value on the rating scale. Returned only when Google exposes the scale."},"availability":{"type":"string","nullable":true,"description":"Stock status of the item as displayed by Google."}},"description":"Rich result data Google displays for product and listing results. Present only when the result carries such data, and each field appears only when Google displays it."},"displayed_link":{"type":"string","nullable":true,"description":"Breadcrumb-style URL Google displays under the title."},"video_thumbnail":{"type":"string","nullable":true,"description":"Base64-encoded thumbnail for organic video results (only when return_organic_result_video_thumbnail=true)."},"snippet_highlighted_words":{"type":"array","items":{"type":"string"},"nullable":true,"description":"Substrings Google highlights inside the snippet."}}},"description":"Organic web search results."},"has_ai_overviews":{"type":"boolean","description":"Whether AI Overviews are present in the response. Only true when fetch_ai_overviews=true and AI Overviews are available."},"related_searches":{"type":"array","items":{"type":"object","properties":{"link":{"type":"string","nullable":true,"description":"Google search URL for the related query."},"query":{"type":"string","description":"Related query text."}}},"nullable":true,"description":"Related search suggestions surfaced by Google."},"shopping_results":{"type":"array","items":{"type":"object"},"nullable":true,"description":"Shopping results, when Google surfaces them for this query."},"total_organic_results":{"type":"integer","nullable":true,"description":"Approximate total number of organic results Google reports for the query."},"discussions_and_forums":{"type":"array","items":{"type":"object"},"nullable":true,"description":"Discussions & forums results, when Google surfaces them for this query."}}},"status":{"type":"string","description":"The status of the API response."},"parameters":{"type":"object","properties":{"q":{"type":"string","description":"The search query as received."},"gl":{"type":"string","description":"ISO 3166-1 alpha-2 country code used for the search."},"hl":{"type":"string","description":"ISO 639 language code used for the search."},"lr":{"type":"string","nullable":true,"description":"Language restriction filter as received (only when explicitly passed)."},"nhr":{"type":"string","description":"People-also-ask filter as received. Values: 0, 1."},"num":{"type":"integer","description":"Maximum number of organic results requested."},"tbs":{"type":"string","nullable":true,"description":"Advanced Google search parameter (tbs) as received (only when explicitly passed)."},"nfpr":{"type":"string","description":"Auto-corrected query filter as received. Values: 0, 1."},"uule":{"type":"string","nullable":true,"description":"Google uule location string as received (only when explicitly passed)."},"start":{"type":"integer","description":"Pagination offset as received."},"device":{"type":"string","description":"Device simulated for the search as received. Values: desktop (default), mobile, tablet."},"location":{"type":"string","nullable":true,"description":"Search origin location as received (only when explicitly passed)."},"deduplicate":{"type":"boolean","description":"Whether deduplication by URL was requested."},"fetch_ai_overviews":{"type":"boolean","description":"Whether AI Overviews fetching was requested for this call."},"return_organic_result_video_thumbnail":{"type":"boolean","description":"Whether base64 video thumbnails were requested for organic video results."}},"description":"The parameters the API received and used for this request, echoed back."},"request_id":{"type":"string","description":"A unique ID to trace the API request."}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"unknown","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"unprobed","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"unknown","summary":"price unknown","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_tr8g7T1Gci7xHnZgeSRJL","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.openwebninja.com","brandSlug":"agents-openwebninja-com-x402","brandBaseUrl":"https://agents.openwebninja.com","brandDocsUrl":null,"whatItDoes":"Returns real-time, full-depth Google SERP results including organic results, ads, AI overviews, knowledge graph, places, top stories, inline videos, answer box, and discussions via a heavy scrape path.","exampleAgentPrompt":"Do a full Google search for 'best electric cars 2025' targeting the US in English, and give me everything — organic results, any AI overview, answer box, top stories, and ads — up to 10 results.","exampleUseCases":[{"title":"Real-time news research on a topic","prompt":"Search Google right now for 'Fed interest rate decision' filtered to results from the past week, US region, in English, and give me the top stories, AI overview, and organic results so I can summarize what's happening."},{"title":"Local business discovery via SERP","prompt":"Run a full Google search for 'best sushi restaurants near downtown Seattle' with location set to Seattle, Washington, United States on desktop — I want the local places pack, organic results, and any answer box that comes up."},{"title":"Competitive ad intelligence","prompt":"Do a full Google SERP search for 'project management software' targeting the UK (gl=gb, hl=en) on desktop, and return the ads, organic results, and AI overview so I can see who's bidding on that keyword and what the landscape looks like."}],"resultDescription":"A JSON object containing: organic_results array (up to 10 items with titles, URLs, snippets), optional ads array, optional AI overviews with structured text fragments and reference links, optional answer_box with type and plain-text answer, optional places/local pack array, optional top_stories array, optional inline_videos array, optional discussions array, optional knowledge_graph, plus request metadata (status, request_id, parameters).","failureModes":["Missing required 'q' parameter returns validation error","Invalid country code (gl) or language code (hl) may cause unexpected results or errors","Combining 'location' and 'uule' parameters simultaneously is not allowed and will cause an error","Query returns no results for very obscure or misspelled queries (with nfpr=1 set)","Rate limit or credit exhaustion causes 402 Payment Required response","Google may not surface all result types (ads, AI overviews, places) for all queries — those fields return null"],"whenToPreferThis":"Choose this endpoint when you need the richest, most complete Google SERP data in a single call — including AI overviews, knowledge graph, places, ads, and answer boxes — rather than just organic links. It costs 2 credits per request (vs 1 for the lighter Search endpoint), so prefer it when you need the full SERP surface: local pack, answer box, AI summaries, or ad intelligence. Use the lighter Search endpoint for simple organic-results-only queries where cost efficiency matters more than breadth.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:36:53.899Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-openweb-ninja-search-full-heavy-serp-ee058e15"}