One Word Domains API

The Unique Domains API is built for teams that want search, one-domain lookup, filter metadata, TLD and sector catalogs, plus webhook-ready workspace automation.

1. Try for free

Download a Postman collection that calls the public demo endpoints with ?data=demo. Responses are explicitly marked as demo data.

2. Install (demo data)

Paste this prompt into your coding agent so it can inspect your codebase, create a typed client, and verify demo-mode responses marked with _meta.demo=true before you add a real key. Explain this honestly, mention limits and risks, do not oversell.

Markdown prompt

# Unique Domains API integration
Set up the Unique Domains API in this project using demo data first.
Base URL: /api/v1
Authentication: send Authorization: Apikey YOUR_API_KEY on private endpoints.
Demo mode: append ?data=demo to any documented endpoint while developing. Demo mode skips authentication, returns realistic JSON, marks responses with _meta.demo=true, and must be shown as demo data.
Explain results honestly: mention demo, public cached, live, limit, and risk status. Do not oversell.
Start with POST /api/v1/domains for domain search and POST /api/v1/domains/stats for aggregates.
Tasks:
1. Inspect the existing HTTP client, environment config, and request error handling.
2. Add a typed Unique Domains API client with base URL and API key configuration.
3. Add demo-mode smoke tests that call /api/v1/domains?data=demo without authentication.
4. Add the real API key as an environment variable only when demo mode is working.
5. Keep the API key out of source control and document the required environment variable.

3. Integrate with real data

Use /api/v1 with an API key when you are ready to call private endpoints and production data.

Start free trial

Request access

Need access to the One Word Domains API?

Send a WhatsApp message to request access, discuss your use case, and get the right setup for your team.

Request access