{"uid":"cap_d6a6LF1XliW-FFYDJyUWG","slug":"agents-openwebninja-com-google-ai-mode-search-ed58a1fa","name":"Google AI Mode Search","description":"Send a prompt/query and get structured results and reference links from Google's AI Mode.","url":"https://agents.openwebninja.com/realtime-web-search/ai-mode?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["prompt"],"properties":{"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 country code, see ISO 639-1 alpha-2."},"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."},"prompt":{"type":"string","example":"How to make a pizza step by step?","description":"AI Mode prompt."},"location":{"type":"string","description":"Where the AI Mode search originates from, for location-dependent prompts such as local businesses, weather or events. 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. Cannot be combined with uule."},"attachments":{"type":"string","description":"Optional JSON array of document URLs (PDF) to attach to the prompt, passed as a string, e.g. [\"https://example.com/file.pdf\"]. Up to 5 files, 10 MB each. Images are not supported. Attaching one or more documents is charged a flat 1 extra request credit. For multiple or long URLs use the POST method (no URL length limit)."},"session_token":{"type":"string","description":"Specify a session token from previous AI Mode response to continue the chat from the same point (preserving history in context for continuous conversation)."}}},"responseSchema":{"type":"object","required":["status","request_id","parameters","data"],"properties":{"data":{"type":"object","required":["reply_parts","reference_links"],"properties":{"reply_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, images."},"images":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","description":"Image URL."},"label":{"type":"string","nullable":true,"description":"Image alt text / caption."},"width":{"type":"integer","nullable":true,"description":"Image width in pixels."},"height":{"type":"integer","nullable":true,"description":"Image height in pixels."}}},"nullable":true,"description":"Images carried by an images fragment."},"ordered":{"type":"boolean","nullable":true,"description":"Whether a list fragment is ordered (numbered)."}}},"description":"Sequenced fragments composing the AI Mode reply (paragraphs, headings, lists, images)."},"session_token":{"type":"string","nullable":true,"description":"Token to pass back as session_token on a follow-up request to continue this conversation. Null when the upstream did not surface one."},"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."},"favicon":{"type":"string","nullable":true,"description":"Favicon URL of the cited page."},"snippet":{"type":"string","nullable":true,"description":"Short excerpt of the cited page."}}},"description":"Citation links referenced by the AI Mode reply."}}},"status":{"type":"string","description":"The status of the API response."},"parameters":{"type":"object","properties":{"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."},"tbs":{"type":"string","nullable":true,"description":"Advanced Google search parameter (tbs) as received (only when explicitly passed)."},"uule":{"type":"string","nullable":true,"description":"Google uule location string as received (only when explicitly passed)."},"prompt":{"type":"string","description":"The AI Mode prompt as received."},"location":{"type":"string","nullable":true,"description":"Search origin location as received (only when explicitly passed)."},"session_token":{"type":"string","nullable":true,"description":"Session token as received (only when explicitly passed to continue a conversation)."}},"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_C6uFd3Sc-zcrt3LfPp0nJ","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":"Send a natural language prompt to Google's AI Mode and receive a structured, multi-part AI-generated answer with cited reference links.","exampleAgentPrompt":"Use Google AI Mode to search for 'best ways to reduce home energy bills in winter' and give me the structured answer with all cited reference links, searching from New York, United States.","exampleUseCases":[{"title":"Step-by-step recipe research","prompt":"Ask Google AI Mode how to make homemade sourdough bread from scratch, step by step, and show me all the reference links it cites."},{"title":"Local event discovery with AI","prompt":"Use Google AI Mode to find what major events are happening in London, England this weekend — search as if I'm located in London, England, United Kingdom."},{"title":"Document-grounded Q&A","prompt":"Attach this PDF report at https://example.com/annual-report-2024.pdf and ask Google AI Mode to summarize the key financial highlights from it."}],"resultDescription":"Returns a structured object containing sequenced reply fragments (paragraphs, headings, ordered/unordered lists, and images) that compose the AI Mode answer, plus an array of reference links (each with title, URL, source, and optional publication date), and an optional session token for continuing the conversation in a follow-up request.","failureModes":["Missing required 'prompt' parameter returns a 400 validation error","Combining 'location' and 'uule' simultaneously is not allowed and returns an error","Invalid country code (gl) or language code (hl) may yield unexpected locale results","PDF attachment URLs that are inaccessible or exceed 10 MB per file will fail to attach","Upstream Google AI Mode unavailability may return a 5xx error from the proxy","Expired or invalid session_token breaks conversation continuity","Prompts that Google AI Mode declines to answer may return empty reply_parts"],"whenToPreferThis":"Choose this endpoint when you need a synthesized, AI-generated answer grounded in real-time web data with explicit reference links — especially for factual, how-to, or research queries where citing sources matters. Prefer it over a plain web search endpoint when you want pre-structured reply fragments (paragraphs, lists, headings) rather than raw search result snippets. Also prefer it for multi-turn conversational search sessions or when you need to attach a PDF document for document-aware AI answers.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:36:52.738Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-google-ai-mode-search-5611a610"}