{"uid":"cap_9wDa95E-kAiyXqNLMagGo","slug":"web-search-read-agent-utility-suite-3f5ac5d9","name":"Web Search + Read (Agent Utility Suite)","description":"Web search plus reading: searches the web and returns the top 1-3 results as clean Markdown (main content, tables, PDFs) in one call, skipping blocked pages for the next result, plus all results and a direct answer. Country, language and recency filters. $0.012 USDC per call.","url":"https://x402-agent-api.onrender.com/api/v1/web-search-read?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"via":{"type":"string","maxLength":64,"description":"Optional: the tool whose next_calls suggested this call (filled in for you)."},"read":{"type":"integer","default":3,"maximum":3,"minimum":1,"description":"How many of the top results to read as Markdown (1-3, default 3). Pages that cannot be read are skipped for the next result."},"query":{"type":"string","maxLength":400,"minLength":1,"description":"What to search for, e.g. \"best open-source vector database 2026\" or \"site:sec.gov Apple 10-K\"."},"country":{"type":"string","pattern":"^[a-z]{2}$","description":"Two-letter country for local results, e.g. us, gb, de. Default: us."},"language":{"type":"string","pattern":"^[a-z]{2}$","description":"Two-letter language code, e.g. en, de, fr."},"time_range":{"enum":["day","week","month","year"],"type":"string","description":"Only results from the past day, week, month or year (news, recent events)."},"max_chars_per_page":{"type":"integer","default":8000,"maximum":20000,"minimum":500,"description":"Markdown characters per page (500-20000, default 8,000)."}}},"responseSchema":{"type":"json","example":{"count":1,"pages":[{"url":"https://www.x402.org/","title":"x402","markdown":"# x402\n\nAn open protocol for internet-native payments...","position":1,"published":null,"truncated":false,"word_count":9}],"query":"what is x402","answer":null,"results":[{"url":"https://www.x402.org/","date":null,"title":"x402 - Payments for the internet","snippet":"An open protocol for internet-native payments...","position":1}],"skipped":[],"provider":"serper","next_calls":[],"related_searches":[]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.012","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.012/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.012","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.012","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_fCThNPOj6fxnA0cLu1i1c","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.012","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches the web for a query and returns the top results as clean Markdown, reading up to 3 pages in one call.","exampleAgentPrompt":"Search the web for 'best open-source vector databases 2025' and read the top 3 results as Markdown, focused on recent articles from the past month.","exampleUseCases":[{"title":"Competitive research from live web","prompt":"Search the web for 'Notion vs Linear project management 2025' and read the top 2 results — I want to see what people are actually saying about both tools right now."},{"title":"Latest earnings news lookup","prompt":"Search for 'Nvidia Q1 2025 earnings results' and read the top 3 pages as Markdown, limiting to results from the past week."},{"title":"SEC filing search via site filter","prompt":"Search for 'site:sec.gov Tesla 10-K 2024' and read the top result so I can see the filing index page."}],"resultDescription":"Returns a JSON object with: the search query, a list of result metadata (URL, title, snippet, date, position), the full Markdown content of up to 3 fetched pages (with word count and truncation flag), an optional direct answer, related searches, and a next_calls suggestion array. Pages that cannot be fetched are skipped and logged in a 'skipped' array.","failureModes":["Query too long (over 400 chars) returns validation error","Pages that block scraping are skipped and the next result is tried instead","time_range filter may return no results for very niche queries","max_chars_per_page too low may truncate important content","country/language codes must be valid ISO two-letter codes or request is rejected","Payment failure via x402 if USDC balance is insufficient or wallet not set up"],"whenToPreferThis":"Use this endpoint when you need to both search the web AND read the full content of result pages in a single call, rather than making separate search and fetch calls. Prefer this over a plain URL reader when you don't yet know which specific URL to read. Prefer it over a search-only endpoint when you need the actual page text, not just snippets. The time_range filter makes it especially useful for recent news or events.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T12:39:15.641Z","isFirstParty":false,"canonicalSlug":"web-search-read-agent-utility-suite-3f5ac5d9"}