{"uid":"cap_9fIMUekzzGz6KkqflOGHp","slug":"echo-router-tavily-web-search-d904e19a","name":"Echo Router – Tavily Web Search","description":"Performs web searches using Tavily's search API. Returns relevant search results with content snippets and metadata for research and information retrieval.","url":"https://echo.router.merit.systems/resource/tavily/search","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"days":{"type":"integer"},"query":{"type":"string"},"topic":{"enum":["general","news"],"type":"string"},"country":{"type":"string"},"end_date":{"type":"string"},"start_date":{"type":"string"},"time_range":{"type":"string"},"max_results":{"type":"integer"},"search_depth":{"enum":["basic","advanced"],"type":"string"},"include_answer":{"type":"boolean"},"include_images":{"type":"boolean"},"auto_parameters":{"type":"boolean"},"exclude_domains":{"type":"array"},"include_domains":{"type":"array"},"include_favicon":{"type":"boolean"},"chunks_per_source":{"type":"integer"},"include_raw_content":{"type":"boolean"},"include_image_descriptions":{"type":"boolean"}}},"responseSchema":{"query":{"type":"string"},"answer":{"type":"string","nullable":true},"images":{"type":"array","items":{"type":"string"}},"results":{"type":"array","items":{"type":"object","required":["title","url","content","score","raw_content"],"properties":{"url":{"type":"string"},"score":{"type":"number"},"title":{"type":"string"},"content":{"type":"string"},"favicon":{"type":"string"},"raw_content":{"type":"string","nullable":true}},"additionalProperties":false}},"request_id":{"type":"string"},"response_time":{"type":"number"},"auto_parameters":{"type":"object","properties":{"topic":{},"search_depth":{}},"additionalProperties":false}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.008","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.008/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_LnjivNbXD8Yr99uC-2hdW","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.008","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Performs web searches via Tavily's search API, returning ranked results with content snippets, scores, and optional AI-generated answers.","exampleAgentPrompt":"Search the web for the latest news about OpenAI's GPT-5 release — do a deep search, include an AI-generated answer, limit to 10 results from the last 7 days, and focus on the 'news' topic.","exampleUseCases":[{"title":"Fact-check a viral claim","prompt":"Search the web to fact-check this claim: 'A new study shows coffee cures Alzheimer's disease.' Do a deep search, include an AI-generated answer summarizing what credible sources say, focus on health and medical domains, and return the top 8 results from the past 30 days."},{"title":"Research a competitor's latest moves","prompt":"Look up the latest news and announcements about Anthropic — search the web for recent product launches, funding rounds, or partnerships, do a deep search, limit to 10 results from the last 14 days, and include an AI-generated answer that summarizes the key findings."},{"title":"Find recent articles on a niche topic","prompt":"Search the web for recent articles about vertical farming adoption in Southeast Asia — include an AI-generated answer, focus on the 'general' topic category, return up to 10 results published in the last 60 days, and pull in raw content so I can read the full details."}],"resultDescription":"A list of ranked search results each containing title, URL, content snippet, relevance score, and optional raw content; plus an optional AI-generated answer summarizing findings, any matched images, and metadata including request ID and response time.","failureModes":["Empty or vague query returns low-quality or no results","Invalid date range or malformed start_date/end_date causes parameter error","Unsupported topic or search_depth value may cause API rejection","Rate limiting or quota exhaustion from Tavily upstream returns error","Network timeout if Tavily API is slow, especially with include_raw_content enabled","Payment failure (402) if USDC balance is insufficient"],"whenToPreferThis":"Choose this endpoint when you need live, up-to-date web search results with relevance scoring and optional AI-synthesized answers. Prefer it over static knowledge bases when recency matters, or when you need to search within specific domains, countries, or date windows. It is especially useful for news research, fact-checking with sources, or any task requiring current information beyond a model's training cutoff.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:34:00.326Z","isFirstParty":false}