{"uid":"cap_BK7PDuQN8cVHNu-iSvYlY","slug":"agents-openwebninja-com-openweb-ninja-real-time-full-depth-web-search-cd605ebc","name":"OpenWeb Ninja Real-Time Full-Depth Web Search","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/v2/search?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_Gm2toqvDZQN6mf4oYksKW","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 listings, ads, AI overviews, knowledge graph, places, top stories, inline videos, answer boxes, and discussions with city-level geo targeting.","exampleAgentPrompt":"Search the web in real-time for 'best electric vehicles 2025' targeting US users in English, give me up to 10 organic results plus any AI overview, answer box, or top stories Google surfaces.","exampleUseCases":[{"title":"Real-time news research on a topic","prompt":"Search Google right now for 'OpenAI GPT-5 release date' targeting US English users and show me the top stories, AI overview, and organic results — I want to see what's actually happening today."},{"title":"Local business discovery in a city","prompt":"Run a real-time Google search for 'best Italian restaurants near downtown Chicago' simulating a location in Chicago, Illinois, United States, and return any local places pack results along with organic listings."},{"title":"Competitive intelligence with advanced operators","prompt":"Do a real-time Google search using 'site:techcrunch.com artificial intelligence funding 2025' for me in English, US region, and return the organic results so I can see their latest AI coverage."}],"resultDescription":"A structured JSON object containing: organic results (title, URL, snippet), optional ads, optional AI overview with text fragments and reference links, optional answer box with type and plain-text answer, optional knowledge graph, optional places/local pack, optional top stories, optional inline videos, optional discussions, plus request metadata and parameters echoed back.","failureModes":["Missing required 'q' parameter returns a 400 validation error","Query yields no results for very obscure or nonsensical terms","uule and location cannot be combined — supplying both causes a parameter conflict error","Rate limiting or credit exhaustion returns a 402 or 429 error (each call costs 2 credits)","Google may not surface optional components (ads, AI overview, answer box, places) for every query — those fields return null","Misspelled queries may be auto-corrected by Google unless nfpr=1 is set"],"whenToPreferThis":"Choose this endpoint when you need rich, full-depth Google SERP data in real-time — especially when you need multiple result types simultaneously (organic + AI overview + places + answer box) in a single call. Prefer it over lighter SERP endpoints when AI overviews, knowledge graphs, or local places packs are required. Use it when city-level geo targeting matters. Note that it costs 2 credits per call, so prefer a lighter endpoint if only basic organic results are needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:35:55.195Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-openweb-ninja-real-time-full-depth-web-search-cd605ebc"}