# Indo News API

> Structured Indonesian news for AI agents: headlines, keyword search and ranked briefings from Google News Indonesia.

Base URL: https://indo-news-api.vercel.app
Network: USDC on Base (eip155:8453, 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913), Polygon (eip155:137, 0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359), Arbitrum (eip155:42161, 0xaf88d065e77c8cC2239327C5EDb3A432268e5831) or Avalanche (eip155:43114, 0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E), payTo 0x7C8A3c26bd579c5176A29a5a8Ae80536319Fa94b
Protocol: x402 v2, exact scheme. Unpaid requests return HTTP 402 with a PAYMENT-REQUIRED header.

## Endpoints

- GET /headlines?topic=finance - up to 25 headlines by topic ($0.05)
- GET /search?q=suku+bunga - up to 25 matching articles ($0.10)
- GET /briefing?topic=finance - deduped, ranked briefing with keyword trends and top sources ($0.50)
- GET /digest - all 8 topics in one call, deduped, with global keyword trends and top sources ($2.50)
- GET /monitor?q=rupiah - coverage monitor for a brand/person/topic: source counts, keyword trends, coverage timeline ($1.00)

Topics: nasional, dunia, finance, techno, sport, hiburan, sains, kesehatan.

## MCP

- POST https://indo-news-api.vercel.app/mcp - MCP server (streamable HTTP, JSON responses). Tools: indonesia_headlines_preview (free 3 headlines), indonesia_news_endpoints (prices + call shape), indonesia_coverage_report (quote for a written report).

## Free resources

- https://indo-news-api.vercel.app/preview?topic=finance - free sample: 3 latest headlines (evaluate before paying)
- https://indo-news-api.vercel.app/sample?topic=finance - rendered sample report: ranked articles, keyword trends, top sources
- https://indo-news-api.vercel.app/sample?q=pertamina - rendered coverage sample: article counts, top sources, coverage timeline
- https://indo-news-api.vercel.app/report?q=pertamina&tx=0x… - self-serve 49 USDC report: verified from the on-chain USDC transfer, no email needed
- https://indo-news-api.vercel.app/report/buy?q=pertamina - buy the 49 USDC written report with x402 (agent path): pay the 402, retry, get HTML + JSON
- https://indo-news-api.vercel.app/demo-report - full example report: every article, timeline, top sources, keyword trends, JSON shape
- https://indo-news-api.vercel.app/license/pilot - 30-day licence, 1,000 calls, $99 paid once with x402: response contains Authorization: Bearer <token>
- https://indo-news-api.vercel.app/license/growth - 30-day licence, 10,000 calls, $399 paid once with x402: response contains Authorization: Bearer <token>
- https://indo-news-api.vercel.app/license/claim?plan=pilot&tx=0x… - same licence after a manual USDC transfer, verified on-chain, no email
- https://indo-news-api.vercel.app/order - pay directly in USDC (Base): $49 report, $99 pilot, $399 growth
- https://indo-news-api.vercel.app/b2b - volume and monthly licensing for teams
- https://indo-news-api.vercel.app - landing page
- https://indo-news-api.vercel.app/openapi.json - OpenAPI discovery document
- https://indo-news-api.vercel.app/.well-known/x402 - machine-readable resource manifest (endpoints, prices, payTo)
- https://indo-news-api.vercel.app/ - health and pricing JSON

Contact: kaminariouji@gmail.com