API

Use your subscription credits via the API. Each domain lookup costs 1 credit.

API Keys

Request

curl -X GET "https://coldemaildomains.com/api/v1/domains?keyword=tech&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

Response

{
  "domains": [
    {
      "domain": "techsolutions.com",
      "infraScore": 9,
      "smtpScore": 7,
      "ageYears": 18.2,
      "createdDate": "2006-10-15",
      "tags": ["tech", "business"],
      "dateAdded": "2024-01-15T10:30:00.000Z",
      "buyUrl": "https://coldemaildomains.com/buy/techsolutions.com"
    },
    {
      "domain": "digitalventures.net",
      "infraScore": 8,
      "smtpScore": 6,
      "ageYears": 12.5,
      "createdDate": "2012-05-20",
      "tags": ["digital", "startup"],
      "dateAdded": "2024-01-14T08:15:00.000Z",
      "buyUrl": "https://coldemaildomains.com/buy/digitalventures.net"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 2,
    "totalPages": 1
  },
  "credits": {
    "used": 2,
    "remaining": 998
  }
}

Query Parameters

keywordSearch domains by keyword (alias: search)

randomSet to "true" for random selection

limitResults per page (default: 50, max: 100)

pagePage number for pagination

sortSort by: age, infraScore, domain, dateAdded

orderSort order: asc or desc

tagFilter by tag

minScoreMinimum infraScore (0-10) *

maxScoreMaximum infraScore (0-10) *

minAgeMinimum domain age in years *

maxAgeMaximum domain age in years *

minCharsMinimum domain name length *

maxCharsMaximum domain name length *

* These filters only work in paginated mode, not with random=true

Error Codes

401Invalid or missing API keyCheck your X-API-Key header

402Insufficient creditsPurchase more credits to continue

429Rate limit exceededWait before making more requests

500Internal server errorTry again or contact support

Rate Limits & Credits

100 requests per minute per API key

Each domain returned costs 1 credit from your subscription. Credits are deducted based on results returned, not requests made.

You get 25 credits/month with your subscription. Buy more at $0.40 each on the Subscription page.