A brand monitoring API, with the product on top
Every mention Nephia catches on 14 sources is yours through a REST API: 31 operations under /v1, called with an x-api-key header.
The same matches can arrive as signed webhooks the moment a check finds them, or through the MCP server in your own agent.
A check costs 1–100 credits depending on the source, from the plan’s one credit pool, and the mentions it finds are never capped.
The /v1 surface
| Group | What it covers | Operations |
|---|---|---|
| Account | Account balance | 1 |
| Mentions | Everything your keywords caught, across every Source | 3 |
| Keywords | What you monitor. A keyword carries its terms, its Sources and its settings. Read, create, edit and pause them here. | 21 |
| Explore | One question asked of the Sources once, priced first, without creating a keyword | 2 |
| AI | Group, classify, agent and summarise passes over items you name | 2 |
| Vinted analytics | Observed price history and per-day market statistics | 2 |
Read from the OpenAPI specification when this page is built.
One request, every source
Mentions are one stream, whatever source caught them. Filter it by source, intent, sentiment, author or date; search it by text, or by meaning.
curl "https://api.nephia.cc/v1/mentions?intent=complaint&limit=20" \ -H "x-api-key: $NEPHIA_API_KEY"
Webhooks, signed and retried
Give a keyword a webhook URL and each match is POSTed to it with the full item, and its sentiment and intent when the AI read it. Every delivery is signed with your account’s secret, retried on failure and kept for replay; the details are in the questions below.
A keyword without a webhook records every match all the same, readable from its events for free.
What a call costs
| Call | Credits | Solo, per 1,000 | Growth, per 1,000 | Pro, per 1,000 | PAYG pack, per 1,000 |
|---|---|---|---|---|---|
| X check (Source floor 1m) | 4 | $0.507 | $0.302 | $0.238 | $0.571 |
| Reddit check (Source floor 1m) | 4 | $0.507 | $0.302 | $0.238 | $0.571 |
| YouTube check (Source floor 1m) | 5 | $0.633 | $0.377 | $0.298 | $0.714 |
| TikTok check (Source floor 1h) | 40 | $5.07 | $3.02 | $2.38 | $5.71 |
| Bluesky check (Source floor 2m) | 1 | $0.127 | $0.075 | $0.060 | $0.143 |
| Hacker News check (Source floor 2m) | 1 | $0.127 | $0.075 | $0.060 | $0.143 |
| Mastodon check (Source floor 2m) | 1 | $0.127 | $0.075 | $0.060 | $0.143 |
| Lemmy check (Source floor 2m) | 1 | $0.127 | $0.075 | $0.060 | $0.143 |
| GitHub check (Source floor 5m) | 1 | $0.127 | $0.075 | $0.060 | $0.143 |
| Product Hunt check (Source floor 5m) | 1 | $0.127 | $0.075 | $0.060 | $0.143 |
| Stack Overflow check (Source floor 5m) | 1 | $0.127 | $0.075 | $0.060 | $0.143 |
| RSS check (Source floor 2m) | 1 | $0.127 | $0.075 | $0.060 | $0.143 |
| AI answers check (Source floor 6h) | 100 | $12.67 | $7.54 | $5.96 | $14.29 |
| Vinted check (Source floor 15s) | 4 | $0.507 | $0.302 | $0.238 | $0.571 |
| Run an AI pass over items (one call = 50 items) | 1 | $0.127 | $0.075 | $0.060 | $0.143 |
| Price an AI pass | 0 | $0.000 | $0.000 | $0.000 | $0.000 |
| Co-cited brands on an AI answer (optional, on top of the 100-credit run) | 10 | $1.27 | $0.754 | $0.596 | $1.43 |
| Get an item price history | 3 | $0.380 | $0.226 | $0.179 | $0.429 |
| Get market price statistics | 5 | $0.633 | $0.377 | $0.298 | $0.714 |
A call is one request or one check. Listing your mentions by text, your keywords and their events costs nothing. Planned prices: nothing is charged during the public beta.
For agents
The MCP server exposes the same mentions and keywords as tools, behind an OAuth sign-in rather than a key. Claude, Cursor and ChatGPT connect to it with one URL.
Questions
How do webhooks retry, and how do I know a delivery is mine?
Every event POST carries a timestamped X-Signature header (t=…,v1=…): HMAC-SHA256 of the timestamp plus the exact raw JSON body, signed with your Account's webhook signing secret. Verify against the raw bytes before parsing and reject stale timestamps to block replays. Non-2xx and network failures retry three times, immediate, then +30s, then +2 min, and failed events stay available for replay for 48 hours. Retries never cost extra credits: the check was metered when we polled, not when we delivered.
X-Signature · timestamped HMAC-SHA256 · 3 attempts
What are the rate limits?
Inbound product quota is per Account, every API key on that Account shares one bucket. Free 60/min, Solo 350/min, Growth 700/min, Pro 1200/min. Credit packs do not raise the quota. Over the limit you get 429 with Retry-After, and no credit is deducted for the rejection. Checks run on our worker schedule, separate from your own request burst.
429 · Retry-After · Account bucket
Are failed calls billed?
Platform failures are free: our timeouts, our 5xx, a Source we could not reach. Rate-limit rejections (429) are free, and so is a refused pull (410). A definitive answer is billed even when empty or not found (404), because we fulfilled the request. Malformed input rejected before it touches a Source costs nothing.
platform 5xx / 429: free · definitive 404 / empty: billed