# HackerNews Mention Intelligence — Documentation

A paid change-intelligence API for HackerNews mentions, designed to be called by AI agents and automation.

## Endpoints
| Endpoint | Price | Returns |
|---|---|---|
| GET /v1/snapshot?target=<keyword> | free | mentions 7d/30d, latest threads |
| mention_changes | $0.05 | new discussions vs history, hot-thread flags |
| mention_intel_report | $0.50 | buzz momentum & top-story report |
| mention_batch_scan | $0.03/keyword | up to 50 keywords in one call |
| mention_landscape | $5 | mindshare ranking across up to 10 keywords, rising-buzz flags |

## Target format
A keyword, product or company name, for example `openai`.

## Payment
- Agents: unpaid calls return HTTP 402 with a base64 PAYMENT-REQUIRED header; settle USDC on Base via x402 and retry. P2P, 0% commission.
- Humans: choose a plan on /pricing, send the exact USDC amount shown, and the access key is issued automatically — no card or AI wallet needed.
- One access key works across the whole change-intelligence product family.

## Subscriptions
Pro $99/month (25 keywords), Business $499/month (150), Enterprise $2000/month (unlimited). Continuous watch and change alerts.

MCP endpoint (Streamable HTTP): https://hn-intel.contentforge-press.workers.dev/mcp