PaidWord Intelligence API

Request word

POST/words/{word}/requestMember key

Brings a word into the catalog: checks it now and queues an accepted word for the intake.

Billed Intake=1 only when the gate accepted the word (202 accepted, Retry-After: 600, poll the request); a word already in the catalog answers 200 in_catalog, a queued one 202 queued with its request id, a refused one 422 with the reason as code (not_a_word, brand, offensive), all billed Intake=0. 10 words a UTC day per consumer and 100 for the whole API, refused words included. When the gate cannot answer: 503 gate_unavailable, Retry-After: 60, never billed.

AccessA member key (Founder or Investor) or a paid RapidAPI subscription to this API.

BillingOne call, plus one word intake when the word is accepted.

PlanInvestor plan. A Founder key answers 403 plan_required.

FormatsJSON

Keep a key on a server: a page a visitor loads shows it to everyone.

Connect on RapidAPI

Request

wordstringRequiredPath

One lowercase word of 2 to 63 letters a to z; no slug or id form.

curl -X POST "https://api.unique.domains/v1/words/glimmerly/request" \
  -H "Authorization: Bearer YOUR_MEMBER_KEY"

const response = await fetch("https://api.unique.domains/v1/words/glimmerly/request", {
    method: "POST",
    headers: {
        "Authorization": "Bearer YOUR_MEMBER_KEY",
    },
});

const data = await response.json();
console.log(data);

import requests

response = requests.post(
    "https://api.unique.domains/v1/words/glimmerly/request",
    headers={
        "Authorization": "Bearer YOUR_MEMBER_KEY",
    },
)

print(response.json())

req, err := http.NewRequest("POST", "https://api.unique.domains/v1/words/glimmerly/request", nil)
if err != nil {
    panic(err)
}
req.Header.Set("Authorization", "Bearer YOUR_MEMBER_KEY")

res, err := http.DefaultClient.Do(req)

$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => "https://api.unique.domains/v1/words/glimmerly/request",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer YOUR_MEMBER_KEY",
    ],
]);
$response = curl_exec($ch);

uri = URI("https://api.unique.domains/v1/words/glimmerly/request")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "Bearer YOUR_MEMBER_KEY"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }

Response

statusstring

requestIdstring

On accepted and queued.

pollstring

/v1/words/requests/<requestId>; on accepted.

wordobject

On in_catalog.

Errors

keyed_only403

A paid subscription is required

invalid_word422

Not a word the intake takes

disabled_in_catalog422

The word is disabled in the catalog

not_a_word422

Not a usable word

brand422

A brand

offensive422

An offensive word

consumer_day_cap429

Your intakes for today are spent

intake_day_cap429

Today's intakes are spent

rate_limited429

Too many requests

internal500

Unexpected error

gate_unavailable503

The intake is unavailable

200 · application/jsonExample

{
  "data": {
    "status": "accepted",
    "requestId": "6b0f6e3c-1d2a-4f6e-9a51-0c7d3b8e2f44",
    "poll": "/v1/words/requests/6b0f6e3c-1d2a-4f6e-9a51-0c7d3b8e2f44"
  },
  "meta": {
    "asOf": "2026-11-05T08:00:00Z",
    "cursor": null,
    "limit": null
  },
  "links": {
    "self": "https://api.unique.domains/v1/words/glimmerly/request",
    "next": null,
    "register": null,
    "product": null,
    "dataset": null
  }
}

Request word

Request

Response

Errors

Related endpoints