Pay-per-query web search via Perplexity's Sonar API, settled on Tempo L2 through Locus MPP.
What it does
This endpoint exposes Perplexity's web search capability through the Locus Micropayment Protocol (MPP). It accepts a search query and returns web results, with optional filters for domain, recency, language, date range, country localization, and result count (1–20). Payment is settled per-call at approximately $0.006 via the Tempo L2 method using pathUSD.
The endpoint is part of a broader Perplexity service suite hosted on Locus MPP that also includes Sonar chat (with models like sonar, sonar-pro, sonar-reasoning-pro, and sonar-deep-research), standard embeddings, and contextualized embeddings — each at their own path. The web search endpoint specifically requires only a `query` field in the POST body, making it straightforward for agents to integrate.
The probe did not capture a 402 challenge on HEAD/GET (returning 404 instead), which is expected since this is a POST-only endpoint. The OpenAPI spec is well-defined with clear request schemas, payment metadata, and pricing descriptions. Documentation references point to the Perplexity API docs and a Locus-hosted markdown file for further details.
Capabilities
Use cases
- —Agent-driven real-time web research without API key management
- —Retrieving current web results with domain and date filters for RAG pipelines
- —Localized search queries scoped to specific countries or languages
- —Programmatic web search with micropayment settlement per query
Fit
Best for
- —AI agents needing on-demand web search with per-call payment
- —Developers who want Perplexity search without a subscription
- —Workflows requiring filtered, localized web results
Not for
- —High-volume bulk search where subscription pricing is more economical
- —Use cases requiring chat completions or reasoning (use the /perplexity/chat endpoint instead)
- —Embedding or vector search tasks (use /perplexity/embed or /perplexity/context-embed)
Quick start
curl -X POST https://perplexity.mpp.paywithlocus.com/perplexity/search \
-H "Content-Type: application/json" \
-d '{"query": "latest developments in quantum computing", "max_results": 5}'Example
Request
{
"query": "latest developments in quantum computing",
"country": "US",
"max_results": 5,
"search_recency_filter": "week",
"search_language_filter": "en"
}Endpoint
Quality
The OpenAPI spec is detailed with clear request schemas, pricing info, and payment metadata. However, the probe did not capture a live 402 challenge (POST-only endpoint probed with HEAD/GET), no example response schema is available, and all crawled pages returned 404 (expected for non-endpoint paths). No actual response format documentation was gathered.
Warnings
- —Probe returned 404 on HEAD/GET; endpoint is POST-only so liveness could not be confirmed via the probe methods used
- —No response schema documented — the shape of search results is unknown from available material
- —Price of $0.006 per call is taken from x-payment-info description but the amount field is null, so exact on-chain pricing may vary
Citations
- —Web search endpoint priced at approximately $0.006 per callhttps://perplexity.mpp.paywithlocus.com
- —Payment settled via Tempo L2 method with pathUSD currencyhttps://perplexity.mpp.paywithlocus.com
- —Request accepts query, max_results (1-20), domain filter, recency filter, language filter, date filters, and country parametershttps://perplexity.mpp.paywithlocus.com
- —Part of a service suite including chat, embeddings, and contextualized embeddings endpointshttps://perplexity.mpp.paywithlocus.com
- —API reference available at docs.perplexity.aihttps://perplexity.mpp.paywithlocus.com