Pay-per-call news search via Brave's independent index, settled on Tempo L2.
What it does
This endpoint provides programmatic news search powered by Brave Search's independent web index, exposed through the Locus MPP (Micropayment Protocol). Each call is charged $0.035 in pathUSD on Tempo L2 with no subscription or API key required — just a per-request payment challenge.
The news-search endpoint accepts a query string and optional parameters for result count (1–50, default 20), freshness filtering (past day, week, month, year, or custom date range), and country code. It is part of a broader Brave Search suite on the same gateway that also offers web search, image search, video search, LLM context retrieval, and AI answers.
The endpoint uses POST with a JSON body. The only required field is `q` (the search query). The MPP probe returned 404 on HEAD/GET, which is expected since the endpoint is POST-only. The OpenAPI spec confirms the payment intent is "charge" (one-shot per call) via the Tempo method. Documentation is referenced at https://api.search.brave.com/app/#/documentation and https://beta.paywithlocus.com/mpp/brave.md.
Capabilities
Use cases
- —Retrieving recent news articles on a topic for an AI agent's research pipeline
- —Monitoring breaking news by freshness filter for alerting systems
- —Building news-aware chatbots that cite current sources
- —Aggregating headlines across countries for market intelligence
- —Feeding news context into RAG workflows
Fit
Best for
- —AI agents needing pay-per-call news retrieval without API keys
- —Privacy-conscious applications avoiding ad-funded search APIs
- —Developers wanting crypto-settled micropayments for search
- —Workflows requiring freshness-filtered news results
Not for
- —High-volume bulk news scraping (per-call cost adds up)
- —Applications that need full-text article content (returns search results, not articles)
- —Users without Tempo L2 / pathUSD payment capability
Quick start
curl -X POST https://brave.mpp.paywithlocus.com/brave/news-search \
-H "Content-Type: application/json" \
-d '{"q": "artificial intelligence regulation", "count": 10, "freshness": "pw"}'Example
Request
{
"q": "artificial intelligence regulation",
"count": 10,
"country": "US",
"freshness": "pw"
}Endpoint
Quality
OpenAPI spec is well-defined with clear request schema and payment info, but no response schema or example response is provided. The probe returned 404 because it used HEAD/GET on a POST-only endpoint, so liveness is not confirmed but strongly implied by the complete OpenAPI definition. No crawled documentation content was available beyond the spec.
Warnings
- —Endpoint returned 404 on HEAD/GET probes; it is POST-only so liveness is inferred from OpenAPI spec but not directly confirmed via 402 challenge
- —No response schema documented — output format must be inferred from Brave Search API docs
- —Currency address 0x20c000000000000000000000b9537d11c60e8b50 assumed to be pathUSD with 6 decimals based on Tempo L2 conventions
Citations
- —News search endpoint charges 35000 base units via Tempo method with intent 'charge'https://brave.mpp.paywithlocus.com
- —Query parameters include q (required), count (1-50), freshness, and countryhttps://brave.mpp.paywithlocus.com
- —API reference documentation available at Brave's documentation portalhttps://api.search.brave.com/app/%23/documentation
- —LLM-oriented docs referenced at beta.paywithlocus.comhttps://beta.paywithlocus.com/mpp/brave.md