{"uid":"cap_OfZxVu2mxmnHzijGtXt1j","slug":"web-search-read-2d9fc9e2","name":"Web Search Read","description":"Use when an agent needs to search and read in one call. Input: q, optional max (1-10, default 5), time_range (day, week, month, year). Output: JSON results (title, URL, date) and, for the top 3, the page converted to Markdown (up to 4,000 characters each; a page that fails is marked, the rest still ship). Provider failure is not charged. Example: ?q=EU+AI+Act+timeline&max=5","url":"https://1gateway.dev/v1/web/search-read?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","pagesRead","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"},"markdown":{"type":["string","null"]},"readError":{"type":["string","null"]},"publishedAt":{"type":["string","null"]},"markdownTruncated":{"type":"boolean"}}}},"provider":{"type":"string"},"pagesRead":{"type":"integer"},"timeRange":{"type":"null"},"attribution":{"type":"string"},"retrievedAt":{"type":"string"},"upstreamCostUsd":{"type":"number"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_kihgCTuHNG0_wlExWoaUw","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches the web and returns results with titles, URLs, dates, and full Markdown page content for the top 3 results in a single API call","exampleAgentPrompt":"Search the web for 'EU AI Act timeline' and read the top 5 results from the past month — give me the titles, URLs, and full page content.","exampleUseCases":[{"title":"Breaking news research for an agent","prompt":"Search the web for 'OpenAI GPT-5 release' and read the top 3 results from the past week — I want the titles, URLs, and the actual page content so I can summarize what's happening."},{"title":"Competitive intelligence on a product launch","prompt":"Look up 'Anthropic Claude pricing 2025' on the web, fetch up to 5 results from the past month, and give me the full text of those pages so I can compare pricing structures."},{"title":"Regulatory compliance update check","prompt":"Search for 'SEC crypto regulation updates' with a time range of the past day, get me up to 4 results, and read the page content so I can see what new rules were announced."}],"resultDescription":"A JSON object containing: the original query, time range, total result count, number of pages successfully read, a results array (each with title, URL, publishedAt date, and for the top 3 a markdown string of up to 4,000 characters or a readError if the page failed to load), plus provider name, retrieval timestamp, cached flag, upstream cost in USD, attribution text, and any notes.","failureModes":["Search provider outage — call is not charged but returns a provider failure error","Individual page read failures — marked with readError in that result, remaining results still returned","Query exceeds 300 character max — validation error","max parameter out of range (must be 1-10) — validation error","Invalid time_range value — validation error","Page content truncated at 4,000 characters per page — markdownTruncated flag set to true"],"whenToPreferThis":"Choose this endpoint when an AI agent needs both search results AND the actual page content in a single call, avoiding the need to separately search then scrape each URL. Ideal for research workflows, news monitoring, regulatory lookups, and competitive intelligence where full article text is needed, not just titles and URLs. Prefer over pure search-only endpoints when downstream processing requires the page body.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T12:31:08.462Z","isFirstParty":false,"canonicalSlug":"web-search-read-2d9fc9e2"}