{ "openapi": "3.0.1", "info": { "title": "Domain Hunter: The Best Available Domains for Any Niche", "description": "Generate hundreds of domain ideas, check registry availability live, compare public asking prices and rank short, brandable names by transparent scores. Includes dated registrar prices, history, trademark search evidence and signed-out social checks when sources answer.", "version": "0.1", "x-build-id": "Iw2uMWbZn511HpC80" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/zaiq~domain-hunter/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-zaiq-domain-hunter", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/zaiq~domain-hunter/runs": { "post": { "operationId": "runs-sync-zaiq-domain-hunter", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/zaiq~domain-hunter/run-sync": { "post": { "operationId": "run-sync-zaiq-domain-hunter", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "niche" ], "properties": { "niche": { "title": "Niche or category", "type": "string", "description": "Describe the business or market in plain words." }, "country": { "title": "Country (optional)", "type": "string", "description": "Two-letter country code. ZA adds co.za to the default suffixes; local naming variants may reference the country or its regions." }, "tlds": { "title": "Domain extensions (optional)", "type": "array", "description": "Leave empty for com, the country extension when mapped, ai, io, co, app and net. A DNS-only check never proves availability.", "items": { "type": "string" } }, "styles": { "title": "Name styles", "type": "array", "description": "Select the naming styles to favour. The overall rank prioritizes brandability and resale patterns.", "items": { "type": "string", "enum": [ "short brandable", "exact-match keyword", "local", "premium/investor", "one-word", "two-word" ], "enumTitles": [ "Short brandable", "Exact-match keyword", "Local", "Premium / investor", "One word", "Two words" ] }, "default": [ "short brandable", "premium/investor" ] }, "maxLength": { "title": "Maximum core-name length", "minimum": 4, "maximum": 24, "type": "integer", "description": "Letters before the extension. Shorter names usually score better; suffix length is excluded.", "default": 12 }, "includeForSale": { "title": "Include domains for sale", "type": "boolean", "description": "Read public marketplace listings. Only a published USD price within your budget qualifies for recommendation.", "default": true }, "includeAuctions": { "title": "Include expiring / auction domains", "type": "boolean", "description": "Read public auctions. Current bids are not final acquisition prices; end times retain the source timezone label.", "default": true }, "maxDomainBudgetUsd": { "title": "Domain purchase budget (USD)", "minimum": 0, "maximum": 1000000, "type": "number", "description": "Maximum published acquisition price or current auction bid. This is separate from Actor and model charges. Unknown-price and non-USD listings are excluded, without guessed exchange rates.", "default": 2500 }, "maxResults": { "title": "Maximum recommendations", "minimum": 1, "maximum": 30, "type": "integer", "description": "Up to this many strong names. Returns fewer if evidence or quality is insufficient.", "default": 20 }, "language": { "title": "Naming language", "type": "string", "description": "Language for AI naming. v1 generates Latin-letter domains; dictionary and phonetic heuristics are English-biased.", "default": "English" }, "maxChecks": { "title": "Maximum live checks", "minimum": 20, "maximum": 240, "type": "integer", "description": "Offline candidates are cut to this shortlist. Up to 240 checks are included in one hunt; registry rate limits can reduce completed checks.", "default": 200 }, "useAI": { "title": "AI brainstorm", "type": "boolean", "description": "Use the newest dated Haiku-family model for investor-style brainstorming and a final quality review of actual actionable names. Failures use a labelled conservative heuristic fallback.", "default": true }, "maxAiCostUsd": { "title": "AI token allowance (USD)", "minimum": 0, "maximum": 3, "type": "number", "description": "Skip a model step if the combined brainstorm and quality-review token ceilings exceed this allowance. Gateway plan multipliers may apply separately; no automatic paid retries.", "default": 0.5 }, "checkSocialHandles": { "title": "Check social handles", "type": "boolean", "description": "Signed-out Instagram, TikTok and X pages only. Explicit absence is labelled looks free, never guaranteed. Opaque or blocked platforms become unknown.", "default": true }, "includeRegistered": { "title": "Include registered names with no sale listing", "type": "boolean", "description": "Include strong registered names for reference if no sale listing was found. They are not actionable acquisition offers. Default off.", "default": false } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }