API Documentation - DomainFinder

Introduction

The DomainFinder API provides programmatic access to our database of expired domains. Search using natural language or build complex filters.

Base URL:

https://api.domainfinder.dev/v1

See Pricing for plan details and limits.

Authentication

Authenticate using a Bearer token in the Authorization header. Get your API key from Settings → API Keys.

Authorization: Bearer sk-dft-your_api_key

Rate Limits

Rate limits vary by plan. Headers are included in every response:

X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 7153
X-RateLimit-Reset: 1709251200

Limit	Free	Starter	Pro
Domains/month	1,000	10,000	50,000
Rate limit	10/min	30/min	60/min

When rate limited, you'll receive a 429 response with a Retry-After header.

Search

GET /v1/search

Search domains using natural language. Our AI parses your query and returns matching domains along with the filter parameters it understood.

Query Parameters

Parameter	Type	Description
`q`	string	Required. Natural language search query
`limit`	integer	Results per page (max varies by plan)
`offset`	integer	Pagination offset

Example

curl "https://api.domainfinder.dev/v1/search?q=short+brandable+.com+domains+for+tech" \
  -H "Authorization: Bearer sk-dft-your_api_key"

import requests

response = requests.get(
    "https://api.domainfinder.dev/v1/search",
    headers={"Authorization": "Bearer sk-dft-your_api_key"},
    params={"q": "short brandable .com domains for tech"}
)

Response

{
  "query": "short brandable .com domains for tech",
  "params": {
    "tld": "com",
    "length_lte": 8,
    "brandable": true,
    "keywords": "tech"
  },
  "count": 156,
  "limit": 50,
  "offset": 0,
  "results": [
    {
      "domain": "vexly.com",
      "tld": "com",
      "length": 5,
      "availability": "EXPIRED",
      "drop_date": "2026-02-12"
    }
  ]
}

Domains

GET /v1/domains

List expired domains with optional filters.

Query Parameters

Basic Filters

Parameter	Type	Description
`tld`	string	Filter by TLD (comma-separated): `com`, `ai`, `dev`, `net`, `org`, etc.
`keywords`	string	Keywords to match (comma-separated, word-boundary matching)
`exclude`	string	Keywords to exclude (comma-separated)
`starts_with`	string	Domain name starts with
`ends_with`	string	Domain name ends with
`category`	string	Niche category (comma-separated): `tech`, `finance`, `health`, etc.

Length & Structure

Parameter	Type	Description
`length_gte`	integer	Minimum domain length
`length_lte`	integer	Maximum domain length
`words_gte`	integer	Minimum word count
`words_lte`	integer	Maximum word count
`has_numbers`	boolean	Has numbers (`true`/`false`)
`has_hyphens`	boolean	Has hyphens (`true`/`false`)

Quality & Characteristics

Parameter	Type	Description
`brandable`	boolean	Brandable domains (score ≥ 50)
`is_pronounceable`	boolean	Easy to pronounce
`is_dictionary`	boolean	Dictionary word
`hide_adult`	boolean	Exclude adult domains

Age & Timing

Parameter	Type	Description
`age_gte`	integer	Minimum domain age in years
`drop_days`	integer	Dropping within N days
`expired`	string	Discovered within: `6h`, `24h`, `3d`, `7d`
`registrar`	string	Filter by registrar name

Pagination & Sorting

Parameter	Type	Description
`sort`	string	Sort field: `length`, `-length`, `-drop_date`, `-age`, `-discovered`
`limit`	integer	Results per page (default 50, max varies by plan)
`offset`	integer	Pagination offset

Example

curl "https://api.domainfinder.dev/v1/domains?tld=com,ai&length_lte=8&sort=-length" \
  -H "Authorization: Bearer sk-dft-your_api_key"

import requests

response = requests.get(
    "https://api.domainfinder.dev/v1/domains",
    headers={"Authorization": "Bearer sk-dft-your_api_key"},
    params={
        "tld": "com,ai",
        "length_lte": 8,
        "sort": "-length"
    }
)

Response

{
  "count": 1284,
  "limit": 50,
  "offset": 0,
  "results": [
    {
      "domain": "vexly.com",
      "tld": "com",
      "length": 5,
      "availability": "EXPIRED",
      "drop_date": "2026-02-12"
    }
  ]
}