AI-optimized web search via Tavily, pay-per-query over MPP/Tempo.
What it does
This endpoint exposes Tavily's AI-optimized web search API through the Locus MPP (Micropayment Protocol), settling payments on Tempo L2 in pathUSD. Each call is a one-shot charge (intent: charge). The /tavily/search endpoint accepts a query string and returns web search results with optional AI-generated answers, images, and raw HTML content. You can control search depth (basic or advanced), topic category (general or news), domain inclusion/exclusion filters, recency (last N days), country targeting, and max result count.
The broader Tavily service hosted at this MPP gateway also includes three sibling endpoints: /tavily/extract for pulling structured content from up to 20 URLs, /tavily/map for discovering and mapping site URLs with natural-language instructions, and /tavily/crawl for multi-page crawling with configurable depth and breadth. Pricing for the search endpoint is $0.09 per basic query and $0.16 per advanced query, as stated in the OpenAPI x-payment-info. The map endpoint is priced at 90,000 base units of pathUSD (6 decimals), which equals $0.09 per call.
The endpoint is a POST-only route; the probe returned 404 on HEAD and GET, which is expected since the OpenAPI spec defines only a POST method. No 402 challenge was captured because the probe did not attempt POST, but the OpenAPI schema and payment metadata are well-defined. Documentation references point to https://docs.tavily.com for the upstream API reference and https://beta.paywithlocus.com/mpp/tavily.md for MPP-specific integration guidance.
Capabilities
Use cases
- —Agents that need real-time web search results to answer user questions
- —RAG pipelines that retrieve fresh web content for grounding LLM responses
- —Automated research workflows that crawl and extract content from specific domains
- —News monitoring agents filtering results by topic and recency
- —Site auditing tools that map all URLs on a given domain
Fit
Best for
- —AI agents needing pay-per-call web search without API key management
- —LLM-based applications requiring structured search results with AI-generated summaries
- —Developers who want crypto-settled micropayments for search queries on Tempo L2
Not for
- —High-volume bulk search where per-query pricing becomes expensive compared to flat-rate plans
- —Use cases requiring non-web data sources (databases, proprietary datasets)
Quick start
curl -X POST https://tavily.mpp.paywithlocus.com/tavily/search \
-H "Content-Type: application/json" \
-d '{"query": "latest AI research papers 2025", "search_depth": "basic", "max_results": 5, "include_answer": "true"}'Example
Request
{
"days": 30,
"query": "latest AI research papers 2025",
"topic": "general",
"country": "us",
"max_results": 5,
"search_depth": "basic",
"include_answer": "true",
"include_images": false,
"include_raw_content": false
}Endpoint
Quality
The OpenAPI spec is well-structured with clear request schemas, pricing metadata, and documentation links. However, no 402 challenge was captured (probe used HEAD/GET, not POST), no response schema or example response is available, and crawled pages returned only 404 JSON errors. Pricing is stated in x-payment-info descriptions but amounts are null for most endpoints.
Warnings
- —No 402 MPP challenge was captured because the probe did not attempt a POST request; liveness via POST is unconfirmed.
- —No response schema is defined in the OpenAPI spec — only '200: Successful response' with no body schema.
- —Pricing amounts are null for search, extract, and crawl endpoints; only human-readable price descriptions are provided in x-payment-info.
- —The pathUSD currency address (0x20c000000000000000000000b9537d11c60e8b50) and its decimals are not independently verified in this bundle.
Citations
- —Tavily search endpoint costs $0.09 (basic) / $0.16 (advanced) per queryhttps://tavily.mpp.paywithlocus.com
- —Tavily map endpoint costs 90,000 base units of pathUSD per callhttps://tavily.mpp.paywithlocus.com
- —API reference documentation is at docs.tavily.comhttps://tavily.mpp.paywithlocus.com
- —MPP-specific docs at beta.paywithlocus.com/mpp/tavily.mdhttps://tavily.mpp.paywithlocus.com
- —Payment settles via Tempo method with intent chargehttps://tavily.mpp.paywithlocus.com