Generate available keyword or AI domain names

Supports three request shapes:

A keyword request runs the deterministic Buy Domains engine with Partner-safe neutral modifiers. It does not call Spider or AI.
type: branded requires a URL. Spider reads the website, then concurrent AI workers generate brand-led names.
type: generic accepts either a URL or a description. A URL uses Spider; a description skips Spider. Generic names do not use the company brand.

AI requests have a 15-second end-to-end ceiling. If Spider or AI fails, times out, or returns no usable names, generation falls back to the deterministic Partner prefix and suffix engine inside that same ceiling.

Fastly registrar availability is always required. Google and Microsoft tenant probes are attempted only for Fastly-available names. If a tenant probe fails or times out, the endpoint falls back to the Fastly result. A confirmed Google or Microsoft tenant claim is still excluded.

An uncached registrar lookup can take several seconds. limited keys can call this endpoint.

Sandbox keys use the same request and response shape, but return deterministic local availability without calling a registrar or tenant provider. A returned sandbox name passes the same sandbox availability check when it is submitted to an order, unless another order used it in the meantime.

limit is the number of domain names returned in total across every requested TLD (default 50, max 100), not a per-TLD count. Defaults to .com when tlds is omitted. Use GET /domains/tlds as the live allowlist.

Names are grouped by TLD. The response also includes the requested subset of live pricingTlds rows. TLD group keys have no leading dot (com, not .com), and empty groups are omitted. limited keys can call this endpoint.

POST

domains

generate

curl --request POST \
  --url https://api.peeker.ai/partner/v1/domains/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "keyword": "peeker"
}
'

{
  "data": {
    "domains": {
      "com": [
        "peekerhq.com",
        "getpeeker.com"
      ],
      "ai": [
        "peekerhq.ai"
      ]
    },
    "pricing": [
      {
        "tld": ".com",
        "price_cents": 1300,
        "renewal_price_cents": 1500,
        "currency": "usd"
      },
      {
        "tld": ".ai",
        "price_cents": 6900,
        "renewal_price_cents": 7900,
        "currency": "usd"
      }
    ]
  }
}

{
  "error": {
    "code": "emailbison_super_admin_key",
    "message": "Use an EmailBison workspace/user API key; super-admin keys are not accepted.",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "field": "credentials.api_key",
    "details": {}
  }
}

{
  "error": {
    "code": "emailbison_super_admin_key",
    "message": "Use an EmailBison workspace/user API key; super-admin keys are not accepted.",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "field": "credentials.api_key",
    "details": {}
  }
}

{
  "error": {
    "code": "emailbison_super_admin_key",
    "message": "Use an EmailBison workspace/user API key; super-admin keys are not accepted.",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "field": "credentials.api_key",
    "details": {}
  }
}

{
  "error": {
    "code": "emailbison_super_admin_key",
    "message": "Use an EmailBison workspace/user API key; super-admin keys are not accepted.",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "field": "credentials.api_key",
    "details": {}
  }
}

{
  "error": {
    "code": "emailbison_super_admin_key",
    "message": "Use an EmailBison workspace/user API key; super-admin keys are not accepted.",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "field": "credentials.api_key",
    "details": {}
  }
}

Authorizations

Authorization

string

header

default:Bearer pk_test_<your-test-key>

required

Partner API key (pk_live_… or pk_test_…).

Body

application/json

Deterministic keyword generation
Branded AI generation from a website
Generic AI generation from a website or description

keyword

string

required

Brand or search term. Spaces and a trailing TLD are stripped.

Maximum string length: 64

tlds

string[]

Optional TLD list from GET /domains/tlds. Defaults to .com.

Required array length: 1 - 50 elements

limit

integer

default:50

Total number of names across all requested TLDs. Defaults to 50.

Required range: 1 <= x <= 100

Response

Available names grouped by TLD with the requested live pricing subset.

data

object

required

Show child attributes

Last modified on August 25, 2026

curl --request POST \
  --url https://api.peeker.ai/partner/v1/domains/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "keyword": "peeker"
}
'

{
  "data": {
    "domains": {
      "com": [
        "peekerhq.com",
        "getpeeker.com"
      ],
      "ai": [
        "peekerhq.ai"
      ]
    },
    "pricing": [
      {
        "tld": ".com",
        "price_cents": 1300,
        "renewal_price_cents": 1500,
        "currency": "usd"
      },
      {
        "tld": ".ai",
        "price_cents": 6900,
        "renewal_price_cents": 7900,
        "currency": "usd"
      }
    ]
  }
}

{
  "error": {
    "code": "emailbison_super_admin_key",
    "message": "Use an EmailBison workspace/user API key; super-admin keys are not accepted.",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "field": "credentials.api_key",
    "details": {}
  }
}

{
  "error": {
    "code": "emailbison_super_admin_key",
    "message": "Use an EmailBison workspace/user API key; super-admin keys are not accepted.",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "field": "credentials.api_key",
    "details": {}
  }
}

{
  "error": {
    "code": "emailbison_super_admin_key",
    "message": "Use an EmailBison workspace/user API key; super-admin keys are not accepted.",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "field": "credentials.api_key",
    "details": {}
  }
}

{
  "error": {
    "code": "emailbison_super_admin_key",
    "message": "Use an EmailBison workspace/user API key; super-admin keys are not accepted.",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "field": "credentials.api_key",
    "details": {}
  }
}

{
  "error": {
    "code": "emailbison_super_admin_key",
    "message": "Use an EmailBison workspace/user API key; super-admin keys are not accepted.",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "field": "credentials.api_key",
    "details": {}
  }
}

Account

Provider workspaces

Bundles

Domains

Domain pool

Orders

Domain swaps

Generate available keyword or AI domain names

Authorizations

Body

Response