Accounts

Create an account (programmatic signup)

Public, CAPTCHA-free signup. Returns a sandbox API key immediately — shown exactly once, before any email verification. Sandbox keys expire after 14 days and carry hard usage caps (1 project, 1 audit, 2 articles). Rate limited to 5 signups/hour per IP. Idempotency-Key is scoped to the caller's IP so a retried signup replays the stored 201 (raw key included) instead of hitting account_exists.

post/v1/accounts

Request

Base URL: https://serp-agent.com
URL: https://serp-agent.com/v1/accounts
Auth: none required

Headers

Idempotency-Keystring

Any unique string (max 200 chars). Retrying a request with the same key replays the stored response verbatim (with header Idempotent-Replayed: true) instead of re-executing — including one-time secrets in the original body. Keys are scoped per account (per client IP on the unauthenticated signup) and pruned after 24h. Reusing a key on a different endpoint returns 409 idempotency_conflict.

Request body

emailstring email required

Trimmed and lowercased server-side.

company_namestring

origin'agent' | 'human'

Who is signing up. Defaults to "agent".

Response

Account created. api_key is the raw sandbox key — it is shown exactly once and never retrievable again.

account_idstring required

api_keystring required

Raw sandbox key (sk_sandbox_…). Shown exactly once — store it now.

mode'sandbox' required

upgrade_urlstring uri required

docsstring uri required

Example response

{
  "sandbox_limits": {
    "audits": 1,
    "articles": 2,
    "expires_days": 14
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.