{"uid":"cap__73JFXTUXvrayySgVI1Q7","slug":"web-search-read-top-pages-3100e2f2","name":"Web Search + Read Top Pages","description":"Web search that reads the results: give a query, get the top web results plus the full text of the top 1-3 pages, each read in a real browser. For research, RAG and fresh answers in one call.","url":"https://web.tollkit.dev/search/read?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"num":{"type":"integer","default":3,"maximum":3,"minimum":1,"description":"How many pages to read."},"query":{"type":"string","maxLength":400,"description":"What to search for."},"country":{"type":"string","pattern":"^[a-zA-Z]{2}$"}}},"responseSchema":{"type":"json","example":{"query":"what is the x402 payment protocol","answer":null,"source":"Web search via Tavily (tavily.com); pages read by Tollkit in a real browser","results":[{"url":"https://www.x402.org/","date":null,"page":{"text":"x402 is an open, internet-native payment standard … (full visible text of the page, up to 12,000 characters)","title":"x402","final_url":"https://x402.org/","truncated":false,"fetched_at":"2026-10-04T12:00:00.000Z","text_length":3554},"title":"x402","snippet":"An open standard for internet-native payments over HTTP 402.","position":1},{"url":"https://docs.cdp.coinbase.com/x402/welcome","date":null,"page":{"text":"(full visible text of the page)","title":"Welcome to x402","final_url":"https://docs.cdp.coinbase.com/x402/welcome","truncated":false,"fetched_at":"2026-10-04T12:00:01.000Z","text_length":6120},"title":"x402 overview","snippet":"How x402 lets APIs charge per request in stablecoins.","position":2}],"pages_read":2,"searched_at":"2026-10-04T12:00:00.000Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_GD8Xak0f6tmgj6hCFbfpZ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Performs a web search and returns full page text of the top 1–3 results, fetched in a real browser, in a single API call","exampleAgentPrompt":"Search the web for 'best open-source LLM frameworks 2025' and read the full text of the top 3 results so I can get a comprehensive up-to-date picture.","exampleUseCases":[{"title":"Live fact-checking for AI answers","prompt":"Search the web for 'current US federal funds rate 2025' and read the top 2 results so I can give an accurate, up-to-date answer."},{"title":"Competitor research in one shot","prompt":"Search for 'Notion vs Obsidian vs Roam comparison 2025' and pull back the full text of the top 3 pages — I want a thorough read of what people are saying right now."},{"title":"RAG pipeline with fresh web content","prompt":"Find me the most recent articles about 'EU AI Act enforcement timeline' and return the full text of the top 3 pages so I can feed them into my knowledge base."}],"resultDescription":"Returns top web search results along with the full extracted text of 1–3 pages as fetched by a real browser, giving both link metadata and readable page content in a single response.","failureModes":["Query exceeds 400-character limit — validation error returned","Requested page is paywalled or JavaScript-heavy and cannot be fully extracted","Search returns no results for highly niche or misspelled queries","Country code is invalid or unsupported — pattern validation error","Page read times out for slow-loading sites","Payment fails or USDC balance is insufficient — x402 payment error"],"whenToPreferThis":"Choose this endpoint when you need both a web search and full page text in a single call — ideal for RAG pipelines, research agents, or any task needing fresh, live web content without chaining separate search and scrape steps. Prefer it over a plain search API when the snippet is not enough and you need the complete page body. Prefer it over a standalone web scraper when you don't already have a URL and need discovery plus extraction together.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:38:10.850Z","isFirstParty":false,"canonicalSlug":"web-search-read-top-pages-3100e2f2"}