{"uid":"cap_0xEWdDa5QVDxEISo5ijGM","slug":"call402-com-web-search-via-tavily-x402-54681902","name":"call402.com Web Search via Tavily (x402)","description":"USDC pay-per-call APIs for AI agents via the x402 protocol (v2, exact, Base mainnet). Send a request, receive HTTP 402 with payment requirements, pay with @x402/fetch or any x402 client, retry with the PAYMENT-SIGNATURE header.","url":"https://call402.com/api/search-tavily?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"query":{"type":"string","description":"Natural-language search query"},"num_results":{"type":"integer","description":"Results to return, 1-10 (default 5)"}}},"responseSchema":{"type":"json","schema":{"type":"object","required":["query","results","meta"],"properties":{"meta":{"type":"object","description":"source, search_depth (always basic), response_time, results_count"},"query":{"type":"string"},"results":{"type":"array","description":"Ranked results: title, url, content, score"}}},"example":{"meta":{"source":"tavily","search_depth":"basic","response_time":0.42,"results_count":1},"query":"latest Base ecosystem news","results":[{"url":"https://example.com","score":0.87,"title":"Example result","content":"Extracted content snippet from the page."}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.015","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.015/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_WRaoniWkleEjS7JquoKtg","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.015","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Performs a natural-language web search powered by Tavily and returns ranked results with titles, URLs, and content snippets, payable per-call with USDC via the x402 protocol.","exampleAgentPrompt":"Search the web for the latest news about the Base blockchain ecosystem and give me the top 7 results with their titles, URLs, and content summaries.","exampleUseCases":[{"title":"Real-time news research for agents","prompt":"Search the web for the latest developments in Ethereum layer-2 scaling and return the top 5 results with their titles and content snippets."},{"title":"Competitive intelligence lookup","prompt":"Find me recent articles about OpenAI's new product announcements — search the web and bring back 8 results so I can review what's being reported."},{"title":"Fact-checking a current claim","prompt":"Search the web to verify whether Apple has officially announced a new iPhone model in 2025 and give me the top 3 sources that discuss it."}],"resultDescription":"A JSON object containing the original query string, an array of ranked search results (each with title, URL, content snippet, and relevance score), and a metadata block showing source (always 'tavily'), search depth, response time, and result count.","failureModes":["402 Payment Required returned on first request — agent must pay USDC via x402 and retry with PAYMENT-SIGNATURE header","Invalid or malformed query string results in a 400 error","num_results outside range 1-10 may cause validation errors or be clamped","Insufficient USDC balance or invalid payment signature causes payment failure","Tavily upstream outage or rate limit may cause 503 or timeout responses","Network latency spikes if Tavily's index is slow to respond"],"whenToPreferThis":"Choose this endpoint when your AI agent needs live web search results with real-time content and you want to pay per-call in USDC without a subscription — ideal for autonomous agents operating on-chain or in crypto-native environments using the x402 payment protocol. Prefer this over scraping endpoints when you want pre-ranked, relevance-scored results with content already extracted. Prefer over general search APIs when micropayment-based, usage-proportional billing is important.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-20T17:51:00.106Z","isFirstParty":false,"canonicalSlug":"call402-com-web-search-via-tavily-x402-54681902"}