domains
Find domain names and the extensions that fit a business. Cost: suggest-names 5 credits, suggest-extensions 3 credits, search-extensions 2 credits, check-availability 1 credit, pricing 1 credit, tlds 1 credit.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | Which domain capability to run. | suggest-names |
| tlds | No | Extensions to price (pricing), to check the name across (search-extensions), or to restrict name ideas to (suggest-names). | |
| query | No | An exact name to check across extensions (search-extensions). | |
| offset | No | search-extensions: pagination offset into the catalog. | |
| domains | No | Full domains to check, e.g. ["brewhaven.com"] (check-availability). | |
| purpose | No | What the domain is for (suggest-names / suggest-extensions): website (the site address), cold (a dedicated cold-email domain, kept apart from the site) or extra. Context the model weighs when judging fit; it sets no search options, which are yours to choose (search_options) from what the company needs. | |
| company_id | No | Optional O-mega/Founden company id; pulls the real business brief to ground the fit. | |
| description | No | What the business does; grounds the fit (suggest-* modes). | |
| company_name | No | The business name (suggest-extensions), or for suggest-names a natural-language brief: any ordering or limit it states (for example "shortest" or "renewal under $15") is read and applied beneath your explicit search_options. | |
| search_options | No | Search options, only the fields you set (suggest-names / search-extensions / suggest-extensions): priorities (objective keys in priority order: total_length, annual_price, renewal_price, registration_total, semantic_fit, brandability, label_length), max_total_length and max_label_length (characters), max_annual_price, max_renewal_price and max_registration_total (USD), hacks (include, exclude or only) and allow_premium (boolean). A field you set wins over what the company_name brief asks for; null (or priorities: []) leaves that field to the brief; unknown keys are rejected. Options that do not apply to a mode are ignored there. The response echoes the effective options (search-extensions: search_options; suggest-names: search_plan.search_options). | |
| exact_extension | No | search-extensions: check ONLY the typed extension. |