{"uid":"cap_FCrPnuVJsHwMgRxDOgJL-","slug":"agents-openwebninja-com-openweb-ninja-real-time-web-search-45a42ff1","name":"OpenWeb Ninja Real-Time Web Search","description":"Get real-time organic search results from across the web, AI Overviews, total count, and more.  \n  Support the Google Search parameters (gl, hl, tbs, etc) and city level geo targeting.  \n  Supports all Google Advanced Search operators such (e.g. inurl:, site:, intitle:, etc).","url":"https://agents.openwebninja.com/realtime-web-search/search?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["q"],"properties":{"q":{"type":"string","example":"how to build a website","description":"Search query"},"gl":{"type":"string","default":"us","description":"The country / region for which to make the query. Allowed values: 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). Allowed values: 2-letter country code, see ISO 639-1 alpha-2."},"lr":{"type":"string","description":"Only return search results in a specific language.  \n  It uses lang_{two-letter language code} to specify languages and | as a delimiter (e.g. lang_fr|lang_de will only search French and German pages)."},"num":{"type":"integer","default":10,"maximum":100,"minimum":1,"description":"Maximum number of results to return. Please note that a request credit will be consumed from the quota for each results page (10 results)."},"tbs":{"type":"string","description":"This parameter defines advanced search parameters that aren't available using regular query parameters (to be searched)."},"nfpr":{"type":"string","description":"Exclude results of 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)."},"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 you want the search to originate from.  \n  It is recommended to specify location at the city level in order to simulate a real user’s search (e.g. London, England, United Kingdom)."},"extra_speed":{"type":"boolean","description":"Speed up the endpoint by up to 4x of the original speed on a best effort basis (false by default).  \n  Please note that each call with extra_speed=true will consume 2 requests from the quota . Experimental feature."},"fetch_ai_overviews":{"type":"boolean","description":"Whether to return AI Overviews if available (false by default).  \n  In case true or 1, AI Overviews will be pulled as well and in case available, the request will consume two request credits from the quota."},"return_organic_result_video_thumbnail":{"type":"boolean","description":"Whether to return the base64 encoded image source for organic video results (false by default).  \n  In case true or 1, an additional video_thumbnail field will be returned for organic video results containing the base64 encoded image."}}},"responseSchema":{"type":"object","required":["status","request_id","parameters","data"],"properties":{"data":{"type":"object","required":["organic_results","has_ai_overviews"],"properties":{"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 (numbered)."}}},"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, when present."},"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)."},"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 Google shows next to the result."},"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)."},"top_answer":{"type":"string","nullable":true,"description":"Highlighted top answer when the result is a Q&A page."},"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."},"answers_count":{"type":"string","nullable":true,"description":"Count of answers shown for Q&A-style results (e.g. Reddit, Quora)."},"displayed_link":{"type":"string","nullable":true,"description":"Breadcrumb-style URL Google displays under the title."}}},"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."},"total_organic_results":{"type":"integer","nullable":true,"description":"Approximate total number of organic results Google reports for the 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 (include), 1 (exclude)."},"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 (include), 1 (exclude)."},"uule":{"type":"string","nullable":true,"description":"Google uule location string as received (only when explicitly passed)."},"start":{"type":"integer","description":"Pagination offset as received (number of results skipped)."},"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_O3hw3mrBJ52IcdIGC0PtD","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 Google organic search results, AI Overviews, and result counts with full support for Google Search parameters and advanced operators.","exampleAgentPrompt":"Search Google for 'best project management tools for remote teams' and give me the top 10 organic results plus the AI Overview if one is available — target US English results on desktop.","exampleUseCases":[{"title":"Competitive SEO research with operators","prompt":"Search Google for 'site:competitor.com pricing' and return up to 20 results so I can see what pricing pages they have indexed."},{"title":"Geo-targeted local market research","prompt":"Search Google for 'coffee shop franchise opportunities' targeting results from the UK in English, and give me the top 10 results including any AI Overview."},{"title":"Real-time trend monitoring","prompt":"Search Google for 'electric vehicle battery recall' filtered to results from the past week using tbs, and show me the top 15 results with their dates."}],"resultDescription":"A structured JSON object containing an array of organic search results (each with title, URL, snippet, position, rank, and optional date/thumbnail), an optional AI Overviews block with text fragments and citation links, request parameters echo, a status field, and a request ID. Up to 100 results can be returned across paginated requests.","failureModes":["Missing required 'q' parameter returns a validation error","Invalid country code for 'gl' or language code for 'hl' may return unexpected results or an error","Combining 'uule' and 'location' parameters simultaneously is not supported and will cause an error","Requesting more than 100 results exceeds the maximum and will be rejected","Query returning no Google results yields an empty organic_results array","Rate limit or quota exhaustion returns a 402 or 429 error","AI Overviews not returned when fetch_ai_overviews is false or Google does not generate one for the query"],"whenToPreferThis":"Choose this endpoint when you need real-time, structured Google search results with fine-grained control over geo-targeting (country, language, city-level location), device simulation, time filters, and advanced search operators. It is preferable over generic search APIs when you require Google-specific parameters (gl, hl, tbs, uule), AI Overviews data, or Google SERP fidelity rather than an aggregated multi-engine result. Ideal for SEO research, competitive intelligence, content discovery, and agents that need to ground answers in live web data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:35:58.662Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-openweb-ninja-real-time-web-search-45a42ff1"}