canonical: https://jentic.com/apis/domainsdb.info/domainsdb

# Domainsdb Domains-Index API

The Domains-Index API offers a searchable index of registered domain names across many TLDs, with endpoints to search the database, list per-TLD records, download whole-zone datasets, and inspect added or deleted domain updates. Statistics endpoints under /info expose zone-level counts and TLD metadata. The published spec lists no security scheme, so calls are open or rely on a vendor-supplied key managed outside the spec. The service is suited to threat-intelligence enrichment, lead generation, brand monitoring, and registry analytics.

## For AI agents

Search registered domain names, list per-TLD records, and pull added or deleted domain updates from the Domains-Index database via GET endpoints.

## Scope

Does not handle WHOIS contact records, DNS resolution, or domain registration - use for indexed domain search and TLD update feeds only.

## Capabilities

- Search the domain database via GET `/domains/search`
- List domains within a specific TLD with GET `/domains/tld/{zone_id}`
- Download a complete TLD dataset via `/domains/tld/{zone_id}/download`
- Retrieve added or deleted domains for a date via `/domains/updates/added` and /deleted
- List historical update batches with GET `/domains/updates/list`
- Pull TLD-level and zone-level statistics from `/info/stat` and `/info/tld`

## Use cases

### Brand and Trademark Monitoring

Run a daily watchlist by calling GET `/domains/updates/added` with a date and matching the returned domains against trademark patterns. The Domains-Index database covers many TLDs, so a single job can monitor newly registered look-alikes without subscribing to per-registrar feeds. Downloads can be paged or pulled as a whole dataset.

Example prompt: GET `/domains/updates/added` for today and filter results against a regex of brand variants, then alert on each match.

### Threat Intelligence Enrichment

Enrich threat-intel pipelines with first-seen and removed-domain context by polling `/domains/updates/added` and `/domains/updates/deleted.` Combined with `/info/stat`, analysts can correlate suspicious domains to TLD-level baseline volumes to spot abuse-prone zones.

Example prompt: GET `/domains/updates/added` and `/domains/updates/deleted` for the last 24 hours and write each domain plus its zone to a SIEM enrichment table.

### TLD Market Research

Pull GET `/info/tld` and `/info/stat/{zone}` to understand domain volumes per TLD, which supports market research, registry pricing decisions, and content pieces about TLD adoption. Combined with `/domains/tld/{zone_id}` this can power a domain-availability search experience.

Example prompt: GET `/info/tld`, then for each top-10 zone call `/info/stat/{zone}` and produce a CSV summary of domain counts.

### AI Agent Domain Discovery via Jentic

An AI agent uses Jentic to find Domains-Index search and update endpoints, then runs GET requests to support brand-protection or research tasks. Any vendor key is stored in your Jentic One instance, and the agent works directly with structured operation schemas rather than parsing raw API docs.

Example prompt: Search Jentic for 'search registered domains', execute GET `/domains/search` with a brand keyword, and return the top results with their TLDs.

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/domains/search` | Search the domain database |
| GET | `/domains/tld/{zone_id}` | Get TLD records |
| GET | `/domains/updates/added` | Get added domains for a date |
| GET | `/domains/updates/deleted` | Get deleted domains for a date |
| GET | `/info/stat/{zone}` | Get statistics for a specific zone |
| GET | `/info/tld/` | Get overall TLD info |

## Key resources

- **Domains** — Search and per-TLD listing of registered domains
- **Updates** — Added and deleted domain feeds with download support
- **Info** — Zone-level and TLD-level statistics and metadata

## Why Jentic

- **Setup:** Wiring the Domains-Index API by hand means mapping its search, TLD, and update-feed routes and paging through large result sets yourself before you get a clean domain list. Through Jentic you install once, import the Domains-Index API from the API Directory, store any key once, and your agent calls it.
- **Permission scoping:** Every Domains-Index operation here is read-only search and feed retrieval, so scope by operation: limit the agent to the reads it needs, such as searching domains or listing newly added domains, and it never reaches a write. You choose which of these read operations are in its set.
- **Credential handling:** Any Domains-Index key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'search registered domains' or 'list newly added domains', and Jentic returns the matching Domains-Index operation with its parameter schema so the agent calls the right endpoint without consulting the spec by hand.

## Related APIs

- **IP2WHOIS** — WHOIS lookup API for domain registration data
- **BuiltWith** — Website technology profiling and lead-intel data
- **abuse.ch** — Threat intelligence feeds for malware and phishing domains

## FAQ

### What authentication does the Domains-Index API use?

The published OpenAPI spec does not declare a security scheme. Domains-Index typically issues an API key separately for higher quotas; if you have one, store it in your Jentic One instance so it is injected at execution time rather than embedded in agent code.

### Can I find newly registered domains with the Domains-Index API?

Yes. GET `/domains/updates/added` returns the latest batch of added domains, optionally filtered by date. Pair it with `/domains/updates/list` to enumerate the available historical batches.

### What are the rate limits for the Domains-Index API?

Limits are not declared in the spec and depend on your Domains-Index plan. Apply exponential backoff on 429 responses, and prefer the /download endpoints when you need a full TLD snapshot rather than paging through `/domains/tld/{zone_id}.`

### How do I search for a brand keyword across domains via Jentic?

Run pip install jentic and search for 'search registered domains'. Jentic returns GET `/domains/search`; execute it with your keyword and Jentic injects any stored credential and handles pagination so the agent only sees the results.

### Can I download a full TLD dataset?

Yes. GET `/domains/tld/{zone_id}/download` returns the whole zone dataset. This is more efficient than paging `/domains/tld/{zone_id}` when you need a complete snapshot for offline analysis.

### Does the Domains-Index API expose zone statistics?

Yes. GET `/info/stat` returns overall statistics and GET `/info/stat/{zone}` returns per-zone counts. Use these for baseline metrics when monitoring TLD growth or anomaly detection.

### Can I limit what my agent is allowed to do with the Domains-Index API?

Yes. Because you self-host Jentic One, your own rules decide which Domains-Index operations the agent may call, and every operation here is read-only, so you scope by picking the exact reads it gets. You can allow just domain search on GET `/domains/search`, or add the added and deleted update feeds on GET `/domains/updates/added` and `/domains/updates/deleted`, or the zone statistics on GET `/info/stat` and `/info/tld`, and leave everything else out of its set. Any Domains-Index key is stored by your instance and injected only for the operations you permit, never exposed to the agent.