{"uid":"cap_gtNpKGudzasbDadVBRiL3","slug":"web-search-e173d0c1","name":"Web Search","description":"Use when an agent needs current web results for a query. Input: q, optional max (1-10, default 5), time_range (day, week, month, year). Output: JSON results with title, URL and date when known, provider and retrieval time. For page text use /v1/web/search-read. Provider failure is not charged. Example: ?q=x402+payment+protocol&max=5","url":"https://1gateway.dev/v1/web/search?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["q"],"properties":{"q":{"type":"string","examples":["x402 payment protocol"],"maxLength":300,"description":"Search query"},"max":{"type":"integer","maximum":10,"minimum":1,"examples":[5],"description":"Number of results (default 5)"},"time_range":{"enum":["day","week","month","year"],"type":"string","examples":["month"],"description":"Only results from the past day, week, month or year"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["query","timeRange","count","results","provider","retrievedAt","cached","upstreamCostUsd","attribution","notes"],"properties":{"count":{"type":"integer"},"notes":{"type":"array","items":{"type":"string"}},"query":{"type":"string"},"cached":{"type":"boolean"},"results":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"title":{"type":"string"},"publishedAt":{"type":["string","null"]}}}},"provider":{"type":"string"},"timeRange":{"type":"null"},"attribution":{"type":"string"},"retrievedAt":{"type":"string"},"upstreamCostUsd":{"type":"number"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.006","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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":"static","summary":"$0.006/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_jMsBKa1tg1cD6YLxDLXbQ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.006","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches current web search results (title, URL, date) for a query, with optional result count and time range filtering.","exampleAgentPrompt":"Search the web for 'x402 payment protocol' and give me the top 5 results from the past month — I need the titles and URLs.","exampleUseCases":[{"title":"Breaking news lookup for agent","prompt":"Search the web for 'Federal Reserve interest rate decision' and return up to 8 results from the past week so I can see what's being reported right now."},{"title":"Competitor research snapshot","prompt":"Find the latest 5 web pages about 'OpenAI GPT-5 release date' — I want current titles, URLs, and dates if available."},{"title":"Recent event fact-checking","prompt":"Can you search the web for 'SpaceX Starship launch 2025' limited to results from the past month and show me up to 10 results?"}],"resultDescription":"A JSON object containing the original query, time range applied, result count, an array of results each with title, URL, and published date (when known), the upstream provider name, retrieval timestamp, whether the result was cached, upstream cost in USD, attribution, and any notes about the response.","failureModes":["Provider failure — not charged, returns error indicating upstream unavailability","Empty results — query returns zero matches for the given time range","Invalid time_range value — must be one of: day, week, month, year","Query too long — q exceeds 300 character limit","max out of bounds — must be between 1 and 10"],"whenToPreferThis":"Use this endpoint when an AI agent needs fresh, real-time web search results beyond its training data cutoff. Prefer over static knowledge retrieval when current information, recent news, or live URLs are required. Use the companion /v1/web/search-read endpoint instead if you also need the full page text content, not just titles and URLs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T01:30:37.033Z","isFirstParty":false,"canonicalSlug":"web-search-e173d0c1"}