The Kustiq API. Same profiles, same credits, your code.

What the API does

Everything the dashboard does, programmatically: profile a company from a domain or work email, batch up to 1,000 companies with job polling, read churn scores and alerts, drive the outreach pipeline (discover, research, qualify, enrich), and sync results to HubSpot. The base URL is https://api.kustiq.com. Endpoints are grouped under /api/v1/.

A first call looks like this:

curl -X POST https://api.kustiq.com/api/v1/profiles/enrich \
  -H "Content-Type: application/json" \
  -H "X-API-Key: kq_live_your_key_here" \
  -d '{"input": "acme.com"}'

The full endpoint catalog, with request and response examples pre-filled for your own keys, lives at /dashboard/api.

Plan gating

API keys require the Pro plan with an active subscription. Creating a key on the free tier or the Insight plan returns HTTP 403; a lapsed subscription returns HTTP 402 until billing is resolved. Plans and credits are on /pricing.

Rate limits

These are the per-plan rate limits that /terms section 9 refers to. Limits are enforced per key on a sliding 1-minute window:

• Pro: 120 requests per minute per key.
• Insight and free tier: no API key access.

Every authenticated response reports where you stand, and exceeding the limit returns HTTP 429:

X-RateLimit-Limit: 120
X-RateLimit-Remaining: 87

HTTP/1.1 429 Too Many Requests
Retry-After: 60

On a 429, wait for the Retry-After window and resume. We may additionally rate-limit, suspend, or revoke keys whose usage pattern is inconsistent with normal product use, with an email to the billing contact first unless the pattern indicates active abuse. That policy is spelled out in /terms section 9.

Credits

API usage draws from the same credit balance as the web app, at the same rates. Profiling a company through the API costs exactly what profiling it from the dashboard costs. Batch jobs report progress by job ID; cancelling a running batch refunds the unused credits. When the balance is exhausted, profiling requests fail until the next monthly grant lands or you top up from /dashboard/billing.

Key handling

• Keys are issued per organisation, up to 5 at a time, by workspace admins at /dashboard/api.
• Keys start with kq_live_ and the plaintext is shown exactly once at creation. Kustiq stores only a hash.
• Rotation: the replacement key works immediately and the old key keeps working for a 24-hour grace period, then expires.
• Revocation: immediate, and always wins, even inside a rotation grace period.

Error codes

• 401: missing, malformed, revoked, or rotation-expired key.
• 402:the organisation’s subscription is not active. Resolve billing at /dashboard/billing.
• 403: the plan does not include API access (requires Pro).
• 429: rate limit exceeded. Honour Retry-After and check X-RateLimit-Remaining.

Free public endpoints

Three snapshot endpoints require no authentication: company snapshot by domain, similar companies, and a side-by-side compare of two domains. They serve the same data as the free company pages at /directory and are rate-limited per IP rather than per key.

FAQ

Changelog

• 2026-07-18 · v1.0 Initial publication. Documents the per-plan rate limits referenced by /terms section 9, key handling, credit behaviour, and error codes.