{"uid":"cap_2pNRM0alNt7WQsW8iRQyW","slug":"bulk-web-search-multi-query-ec3e8f60","name":"Bulk Web Search (Multi-Query)","description":"Bulk web search — run up to 5 search queries in one paid call and get ranked results per query (title, URL, snippet, relevance score) as clean JSON. Same news, finance, date-range, country and domain filters as single web search, applied to every query. One payment instead of five for research fan-out, multi-query RAG retrieval and agent planning.","url":"https://websearch.use.x402atlas.com/search/bulk?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":["query"],"properties":{"query":{"type":"string","maxLength":1000,"description":"Repeat the parameter per query, 1..5 (?query=a&query=b); each up to 1000 chars"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["queried_at","searches"],"properties":{"note":{"type":"string","description":"Present only on a sample response (no query): a hint to pass real queries. The paid request ran; no upstream call was made."},"searches":{"type":"array","items":{"type":"object","required":["query","results"],"properties":{"query":{"type":"string"},"results":{"type":"array","items":{"type":"object","required":["title","url","content","score"],"properties":{"url":{"type":"string"},"score":{"type":"number","description":"Relevance score"},"title":{"type":"string"},"content":{"type":"string","description":"Relevant snippet from the page"}}}}}},"description":"One entry per successful query, in submission order"},"queried_at":{"type":"string","format":"date-time"},"failed_queries":{"type":"array","items":{"type":"string"},"description":"Queries whose search failed upstream; absent when all succeeded"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.045","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.045/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.045","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.045","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_re8mILVg-J8rbf9LL06oe","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.045","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Run up to 5 web search queries in a single paid API call, returning ranked results (title, URL, snippet, relevance score) per query as structured JSON.","exampleAgentPrompt":"Search the web for all five of these topics at once and give me ranked results for each: 'LLM agent frameworks 2025', 'RAG pipeline best practices', 'vector database comparison', 'AI agent memory architectures', and 'multi-agent orchestration tools'.","exampleUseCases":[{"title":"Multi-topic market research in one shot","prompt":"I need web search results for three competitor topics at once: 'OpenAI GPT-4o pricing', 'Anthropic Claude 3.5 pricing', and 'Google Gemini API pricing' — pull ranked results for all three in a single call."},{"title":"Multi-query RAG retrieval for knowledge base","prompt":"For my RAG pipeline, search for these four queries simultaneously and return the top results for each: 'how to chunk documents for embeddings', 'best embedding models for semantic search', 'FAISS vs Pinecone performance', and 'hybrid search BM25 plus dense retrieval'."},{"title":"News fan-out for agent planning","prompt":"Search the web for the latest news on five topics at the same time: 'Fed interest rate decision', 'US inflation data', 'S&P 500 outlook', 'tech sector layoffs 2025', and 'dollar index today' — I want ranked results for each query."}],"resultDescription":"A JSON object containing a 'searches' array with one entry per submitted query (in submission order), each holding the query string and an array of results. Each result includes title, URL, content snippet, and a numerical relevance score. A 'queried_at' ISO datetime is included, plus an optional 'failed_queries' array listing any queries that failed upstream.","failureModes":["Upstream search failure for one or more queries — those queries appear in 'failed_queries' array while successful ones are returned normally","Empty results array for a query if no relevant pages were found","Payment not processed — x402 payment required before results are returned","Query string exceeds 1000 characters — validation error","More than 5 queries submitted — exceeds the per-call limit","Rate limiting or upstream provider downtime causing all queries to fail"],"whenToPreferThis":"Choose this endpoint when you need to run 2–5 distinct web searches as part of a single agent workflow step — such as research fan-out, multi-query RAG retrieval, or parallel topic comparison — and want to pay once instead of making multiple separate calls. It is more cost-efficient and faster than chaining individual search calls when the queries are independent. Prefer the single-query endpoint if you only have one search to perform, or the deep research endpoint if you need higher-depth crawling per query.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T20:13:31.424Z","isFirstParty":false,"canonicalSlug":"bulk-web-search-multi-query-ec3e8f60"}