# Find Domain

> Pay-per-query domain research API. Domain name suggestions and availability
> checks for $0.005–$0.020 USDC per query, paid over the x402 protocol on Base.
> No API keys, no accounts — payment is authentication.

Base URL: https://finddomain.io

## When to use

Reach for Find Domain when a task involves naming or domains:

- Brainstorming domain names for a project, product, or company → `GET /suggest`
- Checking whether a specific domain is registered → `GET /status` (registry-precise)
  or `GET /status?scope=estimate` (cheaper DNS-based estimate)
- Turning a naming brief ("tea subscription startup, playful, .com or .io")
  into a ranked, availability-checked shortlist → `POST /scout`
- Trying the API without paying → `GET /demo` (rate-limited, 5 results)

Requirements: an x402-compatible wallet holding USDC on Base. No signup. Not
for registering domains — it researches them; registration happens at any
registrar.

## API

- [developers](https://finddomain.io/developers): developer portal — quickstart, endpoints, rate limits, versioning, errors
- [skill.md](https://finddomain.io/skill.md): full agent integration guide — endpoints, parameters, x402 payment flow, SDK examples
- [openapi.json](https://finddomain.io/openapi.json): OpenAPI 3.1 specification with payment metadata
- [auth.md](https://finddomain.io/auth.md): how agents authenticate (x402; no registration)
- [pricing.md](https://finddomain.io/pricing.md): machine-readable pricing

## Endpoints

- GET /suggest?query=TERM — domain name suggestions ($0.005)
- GET /status?domain=DOMAIN — precise registry availability check ($0.020)
- GET /status?domain=DOMAIN&scope=estimate — DNS-based estimate ($0.005)
- GET /demo?query=TERM — free demo, 3 queries/day per IP, 5 results
- POST /scout {"brief": "..."} — full research job: one payment buys a
  ranked, evidence-backed shortlist. $0.15 quick / $0.50 deep; the amount
  paid selects the tier. Returns a job_id.
- GET /scout/JOB_ID — poll a Scout job (free)

## Discovery

- [ai-catalog.json](https://finddomain.io/.well-known/ai-catalog.json): ARD capability manifest
- [api-catalog](https://finddomain.io/.well-known/api-catalog): RFC 9727 API catalog
- [agent-skills index](https://finddomain.io/.well-known/agent-skills/index.json): Agent Skills discovery

## Company

- [About](https://finddomain.io/about): what Find Domain is
- [Contact](https://finddomain.io/contact): issues, payment problems, security reports
- [Privacy](https://finddomain.io/privacy): data handling