# MentionsAPI

> Unified API for tracking brand mentions across ChatGPT, Claude, Gemini, and Perplexity. One endpoint, four answer engines, structured brand mentions and citations. Built for developers shipping GEO and brand-monitoring tools.

MentionsAPI is a subscription + credits API: plans start at $5/month (1,000 credits) or $54/year (12,000 credits), every call debits credits from your balance in real time, and paid plans can buy top-up packs ($4 per 1,000 credits on monthly, $3 per 1,000 on annual). New accounts get 300 free credits. The headline endpoint is `POST /v1/check` which fans out across LLM providers in parallel and returns a normalized response with brand mention positions, sentiments, and cited URLs. A quick check is 130 credits (5 when served from a recent identical query); live UI surfaces run 15–165 credits. The full machine-readable contract is at https://mentionsapi.com/openapi.json.

## Documentation

- [Quickstart](https://mentionsapi.com/docs/quickstart): Make your first call in under a minute (curl, Node.js, Python).
- [Authentication](https://mentionsapi.com/docs/authentication): Bearer token setup and key rotation.
- [Providers](https://mentionsapi.com/docs/providers): Supported LLM providers, models, and per-provider quirks.
- [Brand extraction](https://mentionsapi.com/docs/brand-extraction): How brand mentions are detected, position-indexed, and sentiment-scored.
- [Citation canonicalization](https://mentionsapi.com/docs/citation-canonicalization): URL deduplication and canonical resolution across providers.
- [Caching](https://mentionsapi.com/docs/caching): Reduced pricing for recently-asked queries, cache_bypass, and per-tier behavior.
- [Rate limits](https://mentionsapi.com/docs/rate-limits): Per-key limits, response headers, and burst behavior.
- [Webhooks](https://mentionsapi.com/docs/webhooks): Async delivery for scheduled monitor runs.
- [Errors](https://mentionsapi.com/docs/errors): Error codes, partial-success behavior, and recovery patterns.
- [Wallet](https://mentionsapi.com/docs/wallet): How the credit balance, plan grants, deductions, and top-ups work.
- [Security](https://mentionsapi.com/docs/security): Threat model, data retention, and key handling.

## Endpoints

- [POST /v1/ask](https://mentionsapi.com/docs/endpoints/ask): Query LLMs in parallel and extract brand mentions.
- [POST /v1/extract-brands](https://mentionsapi.com/docs/endpoints/extract-brands): Brand extraction from arbitrary text.
- [GET /v1/usage](https://mentionsapi.com/docs/endpoints/usage): Account usage and current balance.
- [GET /v1/keys](https://mentionsapi.com/docs/endpoints/keys): API key management.
- [POST /v1/monitors](https://mentionsapi.com/docs/endpoints/monitors): Scheduled monitor runs.

## Methodology

- [Methodology](https://mentionsapi.com/methodology): Sample sizes, Wilson 95% confidence intervals, Levenshtein-≤2 fuzzy matching, per-platform reliability targets.
- [Delta Report](https://mentionsapi.com/delta-report): API vs UI gap checker — the difference between what the LLM API returns and what real users see in the UI.

## Use-case landing pages

- [Multi-LLM API](https://mentionsapi.com/multi-llm-api): One endpoint, four answer engines, single response schema.
- [AI visibility API](https://mentionsapi.com/ai-visibility-api): Programmatic measure of brand presence in AI answers.
- [GEO API](https://mentionsapi.com/generative-engine-optimization-api): Data layer for Generative Engine Optimization tools.
- [Brand monitoring API](https://mentionsapi.com/ai-brand-monitoring-api): Track brand mentions across LLMs on a schedule.
- [Citation tracking API](https://mentionsapi.com/ai-citation-tracking-api): Find which URLs AI engines cite for which prompts.
- [ChatGPT API wrapper](https://mentionsapi.com/chatgpt-api-wrapper): ChatGPT API client with brand tracking built in.
- [Perplexity API wrapper](https://mentionsapi.com/perplexity-api-wrapper): Citation-parsed Perplexity wrapper with normalized URLs.
- [LLM API aggregator](https://mentionsapi.com/llm-api-aggregator): Normalized multi-provider responses with deduplicated citations.

## Pricing

- [Pricing](https://mentionsapi.com/pricing): Monthly $5 → 1,000 credits; Annual $54 → 12,000 credits; 300 free credits on signup. A quick check is 130 credits (5 when served from a recent identical query); live UI surfaces run 15–165 credits; discover is 165 and compare is 500 per call. Top-up packs (1k–100k credits) require an active paid plan: $4/1k on monthly, $3/1k on annual. Credits never expire.

## Reference

- [OpenAPI 3.1 spec (JSON)](https://mentionsapi.com/openapi.json): Machine-readable API contract.
- [API catalog (RFC 9727)](https://mentionsapi.com/.well-known/api-catalog): Linkset of API resources.
- [Sitemap](https://mentionsapi.com/sitemap.xml): All public URLs.
- [Status](https://status.mentionsapi.com): Live service status.

## Optional

- [Blog: ChatGPT API misses 96% of what real users see](https://mentionsapi.com/blog/api-vs-ui-gap): 1,000-query teardown of the API-vs-UI gap across four providers.
- [Blog](https://mentionsapi.com/blog): Technical deep dives on GEO, multi-LLM data engineering, and methodology.
- [Terms of service](https://mentionsapi.com/legal/terms)
- [Privacy policy](https://mentionsapi.com/legal/privacy)
- [Data Processing Agreement](https://mentionsapi.com/legal/dpa)
- [Security](https://mentionsapi.com/legal/security)
- [Contact: hello@mentionsapi.com](mailto:hello@mentionsapi.com)