Search Domains

Search CronDB's database of newly registered domains with powerful filters.

Endpoint

POST /v1/search/domains

Request

Headers

Header	Value
Authorization	Bearer cdb_your_api_key
Content-Type	application/json

Body Parameters

Parameter	Type	Required	Description
industry	string	No	Filter by AI-classified industry
country	string	No	ISO 2-letter country code
business_type	string	No	B2B, B2C, Marketplace, etc.
tech_stack	string[]	No	Filter domains using these technologies
has_email	boolean	No	Only return domains with contact emails
has_ecommerce	boolean	No	Only return domains with e-commerce platforms
registered_after	string	No	ISO date (e.g., "2026-03-01")
registered_before	string	No	ISO date
confidence_min	number	No	Minimum AI confidence score (0-1)
query	string	No	Full-text search across domain name and summary
page	integer	No	Page number (default: 1)
per_page	integer	No	Results per page (default: 25, max: 100)
sort_by	string	No	Sort field: created_date, confidence, domain
sort_order	string	No	asc or desc (default: desc)

Example Request

curl -X POST \
  -H "Authorization: Bearer cdb_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "industry": "Technology",
    "country": "US",
    "has_email": true,
    "confidence_min": 0.8,
    "registered_after": "2026-03-01",
    "per_page": 10,
    "sort_by": "confidence",
    "sort_order": "desc"
  }' \
  "https://api.crondb.com/v1/search/domains"

Python

import requests

response = requests.post(
    "https://api.crondb.com/v1/search/domains",
    headers={"Authorization": "Bearer cdb_your_api_key_here"},
    json={
        "industry": "Technology",
        "country": "US",
        "has_email": True,
        "confidence_min": 0.8,
        "per_page": 10,
    },
)

data = response.json()
for domain in data["results"]:
    print(f"{domain['domain']} — {domain['industry']} ({domain['confidence']:.0%})")

Node.js

const response = await fetch("https://api.crondb.com/v1/search/domains", {
  method: "POST",
  headers: {
    Authorization: "Bearer cdb_your_api_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    industry: "Technology",
    country: "US",
    has_email: true,
    confidence_min: 0.8,
    per_page: 10,
  }),
});

const data = await response.json();
data.results.forEach((d) => console.log(`${d.domain} — ${d.industry}`));

Ruby

require 'net/http'
require 'json'

uri = URI("https://api.crondb.com/v1/search/domains")
req = Net::HTTP::Post.new(uri, {
  'Authorization' => 'Bearer cdb_your_api_key_here',
  'Content-Type' => 'application/json'
})
req.body = { industry: "Technology", country: "US", has_email: true,
             confidence_min: 0.8, per_page: 10 }.to_json

res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(req) }
data = JSON.parse(res.body)
data['results'].each { |d| puts "#{d['domain']} — #{d['industry']}" }

Response

{
  "results": [
    {
      "domain": "newstartup.com",
      "industry": "Technology",
      "business_type": "B2B SaaS",
      "confidence": 0.94,
      "registrant_country": "US",
      "created_date": "2026-03-15",
      "website_summary": "Cloud-based project management platform for distributed teams.",
      "tech_stack": {
        "cms": "Next.js",
        "analytics": ["Google Analytics", "Mixpanel"],
        "chat": "Intercom",
        "ecommerce": null
      },
      "contact": {
        "emails": ["hello@newstartup.com"],
        "phone": null
      }
    }
  ],
  "total": 1250,
  "page": 1,
  "per_page": 10,
  "total_pages": 125
}

Response Fields

Field	Type	Description
results	array	Array of domain objects
total	integer	Total matching domains
page	integer	Current page number
per_page	integer	Results per page
total_pages	integer	Total pages available

Filter Examples

Find E-commerce Startups in Europe

{
  "business_type": "B2C",
  "has_ecommerce": true,
  "country": "GB",
  "registered_after": "2026-01-01"
}

Find SaaS Companies Using Stripe

{
  "business_type": "B2B SaaS",
  "tech_stack": ["Stripe"],
  "has_email": true
}

Full-Text Search

{
  "query": "artificial intelligence",
  "industry": "Technology"
}

Notes

• Search results are ordered by created_date (newest first) by default
• Each search request counts as 1 API query regardless of results returned
• Maximum 100 results per page
• Use pagination to retrieve all results for large result sets

Next Steps

• Enrichment — Get full details for a specific domain
• Bulk Enrichment — Enrich multiple search results at once
• Email Finder — Find contacts for search results