Domains API | Unified Agent APIs

Overview

Find domain names and the extensions that fit a business

Credits

Suggest names: 5, Suggest extensions: 3, Search extensions: 2, Check availability: 1, Pricing: 1, Extension catalog: 1

Providers

Name.comNamecheap

SDK Method

client.domains(...)

Modes

The mode parameter is a preset that configures optimal provider routing for common use cases. You can also set individual parameters directly for fine-grained control.

Suggest names

5 credits

Brandable domain name ideas.

Luna name ideas + domain hacks, each checked for availability and price, categorized.

Suggest extensions

3 credits

Extensions that fit the business.

The .tld choices that fit what the business does, each with a reason and base price.

Search extensions

2 credits

One name across the catalog.

Availability + price of one exact name across the whole extension catalog, paged 50 at a time.

Check availability

1 credit

Availability for a domain list.

Availability, premium and EAP status for a list of full domains.

Pricing

1 credit

Comparison price per extension.

Namecheap comparison price for a list of extensions.

Extension catalog

1 credit

The full extension catalog.

Every registrable extension, enriched with length, popularity and theme.

Parameters

mode

select (default: suggest-names)

Which domain capability to run.

Suggest names

Suggest extensions

Search extensions

Check availability

Pricing

Extension catalog

company_name

string

The business name (suggest-names / suggest-extensions).

description

string

What the business does; grounds the fit (suggest-* modes).

company_id

string

Optional O-mega/Founden company id; pulls the real business brief to ground the fit.

query

string

An exact name to check across extensions (search-extensions).

domains

array

Full domains to check, e.g. ["brewhaven.com"] (check-availability).

tlds

array

Extensions to price, or to restrict a search to (pricing / search-extensions).

exact_extension

boolean (default: false)

search-extensions: check ONLY the typed extension.

offset

number (default: 0)

search-extensions: pagination offset into the catalog.

Example Response

{
  "success": true,
  "data": {
    "extensions": [
      {
        "tld": "coffee",
        "reason": "Directly identifies a coffee brand.",
        "price": "$32.99/yr"
      }
    ]
  },
  "metadata": {
    "provider_used": "name.com",
    "mode_used": "suggest-extensions",
    "response_time_ms": 1800,
    "request_id": "req_dom123"
  },
  "credits_used": 3
}

Get Started

Use this API through the O-mega platform. Create an API key in your dashboard, then call the endpoint with your key in the Authorization header.

Try Domains

Test Domains in the interactive playground. No setup required.

Open Playground