The AI92 API
The AI92 API is a single, credit-metered REST interface to the entire AI92 growth platform. One key, one base URL, one billing model — and behind it, eight production services that find contacts, run outreach campaigns, generate creative, track SEO and AI visibility, surface buyer intent, manage reviews, and model markets.
You do not provision per-service credentials, juggle per-product quotas, or learn eight different request shapes. Every service speaks the same conventions described in these guides: the same authentication, the same error envelope, the same pagination, the same idempotency, the same credit accounting.
The eight services
| Service | Base path | What it does |
|---|---|---|
| Contacts | /v1/contacts | Search, reveal, verify, enrich and bulk-discover B2B contacts. |
| Campaigns | /v1/campaigns | Build, preview and send multi-channel outreach campaigns (email / SMS / WhatsApp / Telegram). |
| Creative | /v1/creative | Generate on-brand images and video, newsletter banners, and full creative campaigns (GenAI). |
| SEO & AI-Visibility | /v1/seo, /v1/ai-visibility | Audits, keyword and backlink intelligence, competitor benchmarks, and how brands surface in AI answers. |
| Intent | /v1/intent | Identify anonymous visitors, score buyer intent, and run prospect/industry alerts. |
| Reviews & GBP | /v1/reviews, /v1/gbp | List reviews, AI-draft replies, request reviews, and publish Google Business Profile posts. |
| Markets | /v1/markets | Comprehensive market reports, competitor intelligence, and predictive analytics. |
| Cloud | /v1/cloud | Data storage, cleaning, sync/import, export, and custom audience segments. |
All eight share account, key, usage, billing, webhook and async-job surfaces under /v1/account, /v1/billing, /v1/webhooks and /v1/jobs.
Base URLs
| Environment | Base URL | Selected by |
|---|---|---|
| Production | https://api.ai92.ai | An ai92_live_ API key |
| Sandbox | https://api.ai92.ai | An ai92_test_ API key |
There is one host. The key prefix decides which world you hit: a ai92_test_ key routes the request to the isolated sandbox dataset and never spends credits. A ai92_live_ key hits production. See Sandbox.
Every path is versioned under /v1 — for example https://api.ai92.ai/v1/contacts/search.
REST conventions
- HTTPS only. Plain
http://is rejected. - JSON in, JSON out. Send
Content-Type: application/jsonon every body-carrying request. - Bearer auth.
Authorization: Bearer ai92_live_...on every authenticated call. - Verbs mean what you expect.
GETreads,POSTcreates/acts,PATCHupdates,DELETErevokes. - Predictable errors. Every error is the same envelope:
{ "error": { "code", "message", "status", "documentation_url" } }. See Errors. - Response headers carry billing + rate state.
X-Credits-Consumed,X-Credits-Remaining,X-RateLimit-*, andX-AI92-Trace-Idare returned on/v1service calls. - Idempotency via
X-AI92-Idempotency-Key, pagination viacursor/limit, async via/v1/jobs/{job_id}.
The credit model, in one paragraph
AI92 bills in credits. Read and metadata calls (search, list, previews, snapshots, status) are free; calls that produce billable value (revealing a contact, sending a message, rendering an image, running an analysis) cost a fixed, published number of credits that you can see in advance and confirm from the X-Credits-Consumed header on every response. You only pay for results: a verification that comes back inconclusive, a search that returns nothing, or a backend that fails is not charged, and long-running async jobs reserve credits up front and refund automatically on failure. Your live balance is one GET /v1/account away. Credits arrive three ways — one-off packs, recurring subscriptions, and add-ons — covered in Credits & Billing.
Where to go next
- Quickstart — first call in under five minutes.
- Authentication — API keys and OAuth 2.0.
- Credits & Billing — the full per-service cost table.
- Going live — the launch checklist.