{"uid":"cap_jv2uN8JpPlteVZlRr2Lcz","slug":"web-search-tavily-powered-via-4yearcycle-com-x402-6d318ff4","name":"Web Search (Tavily-powered via 4yearcycle.com x402)","description":"General web search reselling the Tavily Search API: query the live web and get back ranked results (title, URL, snippet, relevance score) plus an optional short synthesized answer, with basic or advanced search depth and optional domain include/exclude filters.","url":"https://4yearcycle.com/x402/web-search","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":["who is Leo Messi","latest news on EU AI Act enforcement"],"maxLength":400,"minLength":1,"description":"Search query. Required, 1-400 characters."},"max":{"type":"string","default":"5","pattern":"^\\d{1,2}$","examples":["5","10"],"description":"Maximum number of results to return. Integer 1-10. Default: 5."},"depth":{"enum":["basic","advanced"],"type":"string","default":"basic","examples":["basic","advanced"],"description":"Search depth. \"advanced\" costs Tavily more upstream but is not priced differently to the buyer yet. Default: basic."},"exclude_domains":{"type":"string","examples":["pinterest.com"],"description":"Optional comma-separated domains to exclude from results."},"include_domains":{"type":"string","examples":["wikipedia.org","nytimes.com,bbc.com"],"description":"Optional comma-separated domains to restrict results to, e.g. wikipedia.org,bbc.com."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["query","count","results"],"properties":{"count":{"type":"integer","description":"Number of results returned"},"query":{"type":"string","description":"Query as sent to Tavily"},"answer":{"type":["string","null"],"description":"Tavily's short synthesized answer, null if unavailable"},"results":{"type":"array","items":{"type":"object","required":["title","url","snippet","score"],"properties":{"url":{"type":"string","description":"Source URL"},"score":{"type":"number","description":"Tavily relevance score for this result (higher = more relevant)"},"title":{"type":"string","description":"Page title as indexed by Tavily"},"snippet":{"type":"string","description":"Tavily's extracted content for this result, capped to 500 characters"}}},"description":"Ranked search results, most relevant first"},"responseTimeMs":{"type":"integer","description":"Upstream Tavily response time in milliseconds"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_i7SZObvaUzCG-Uyw0cAPh","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Queries the live web via Tavily Search API and returns ranked results with titles, URLs, snippets, and relevance scores, plus an optional synthesized answer — payable per-call via x402.","exampleAgentPrompt":"Search the web for the latest news on EU AI Act enforcement — give me up to 10 results using advanced search depth, and exclude pinterest.com from the results.","exampleUseCases":[{"title":"Real-time news research for a topic","prompt":"Search the web for the latest developments on the US-China trade war and give me the top 7 results — I want a short synthesized answer too if possible."},{"title":"Domain-restricted fact lookup","prompt":"Look up who founded OpenAI, but only pull results from wikipedia.org and britannica.com — basic search depth is fine, just give me 5 results."},{"title":"Competitive intelligence gathering","prompt":"Search the web for recent funding news about Anthropic and give me up to 10 ranked results with snippets, using advanced search depth and excluding social media sites like reddit.com and twitter.com."}],"resultDescription":"A JSON object containing the original query string, the number of results returned, an array of ranked result objects (each with title, URL, snippet text, and a Tavily relevance score), and an optional short synthesized answer string (null if unavailable).","failureModes":["Missing or empty 'q' parameter returns a 400 error","Query exceeding 400 characters is rejected","Invalid 'max' value (outside 1-10 integer range) causes a validation error","Tavily upstream API unavailability results in a 502 or 503 error","Payment not provided or insufficient USDC balance causes a 402 Payment Required response","Domain filter typos may silently reduce result quality without an explicit error"],"whenToPreferThis":"Choose this endpoint when an AI agent needs live, ranked web search results with relevance scores and an optional synthesized answer in a single call, especially when domain filtering (include/exclude) is needed. It is well-suited for agents that need real-time information retrieval without managing a Tavily API key directly, and supports x402 micropayment billing at $0.03 per call — ideal for pay-per-use agent architectures.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:37:16.784Z","isFirstParty":false}