API Overview

The CronDB API provides programmatic access to domain intelligence data. Use it to enrich domains, search for leads, find emails, detect tech stacks, and manage your CronDB resources.

🎬API OverviewStep 1 of 5

🕰️CronDB API Reference

API Overview

Base URL: https://api.crondb.com/v1/

Content-Type: application/json

Authentication

Authorization: Bearer cdb_your_key

1

See Base URL

All CronDB API calls use the base URL: https://api.crondb.com/v1/

Base URL

All API requests use the following base URL:

https://api.crondb.com/v1/

Versioning

The API version is included in the URL path (/v1/). When breaking changes are introduced, a new version will be released (e.g., /v2/). Previous versions will be supported for at least 12 months after a new version launches.

Content Type

All requests and responses use JSON:

Content-Type: application/json

For GET requests, parameters are passed as query strings. For POST requests, parameters are passed in the JSON body.

Authentication

Every request requires an API key in the Authorization header:

Authorization: Bearer cdb_your_api_key_here

See Authentication for details.

Response Format

Successful Response

All successful responses return a JSON object with the requested data:

{
  "domain": "example.com",
  "industry": "Technology",
  "business_type": "B2B SaaS",
  "confidence": 0.92,
  "website_summary": "...",
  "tech_stack": { ... },
  "contact": { ... }
}

For list endpoints, responses include pagination:

{
  "results": [ ... ],
  "total": 1250,
  "page": 1,
  "per_page": 25,
  "total_pages": 50
}

Error Response

Errors return a JSON object with a detail field:

{
  "detail": "Invalid API key"
}

See Errors for all error codes.

Rate Limits

Every response includes rate limit headers:

X-RateLimit-Limit: 300
X-RateLimit-Remaining: 297
X-RateLimit-Reset: 1710764400

See Rate Limits for details per plan.

Available Endpoints

Enrichment

Endpoint	Method	Description
/v1/enrichment/domain	GET	Enrich a single domain
/v1/enrichment/bulk	POST	Enrich up to 100 domains

Search

Endpoint	Method	Description
/v1/search/domains	POST	Search domains with filters

Contact

Endpoint	Method	Description
/v1/email-finder	GET	Find emails for a domain

Intelligence

Endpoint	Method	Description
/v1/tech-stack	GET	Get tech stack for a domain
/v1/scoring	POST	Score domains against rules
/v1/intent	GET	Get intent signals for a domain

Webhooks

Endpoint	Method	Description
/v1/webhooks	Various	Manage webhook subscriptions

SDKs & Libraries

Official SDKs are coming soon for:

• Python — pip install crondb
• JavaScript/Node.js — npm install @crondb/sdk

In the meantime, use any HTTP client library to interact with the API.

Pagination

List endpoints support pagination:

Parameter	Type	Default	Description
page	integer	1	Page number
per_page	integer	25	Results per page (max 100)

Request IDs

Every response includes a unique request ID in the X-Request-ID header. Include this ID when contacting support about a specific API call.

Next Steps

• Authentication — Set up your API key
• Rate Limits — Understand usage limits
• Search Endpoint — Start searching domains
• Enrichment Endpoint — Enrich your first domain