Domain Activity API

https://api.codepunch.com/dnfeed/v2

Daily feeds of newly registered and deleted gTLD domains sourced from zone files. Also provides keyword occurrence statistics and a bulk ZIP download for pipeline ingestion.

A legacy v1 API remains active at dnfeed.php for existing subscribers. New integrations should use v2. Existing v1 keys work on v2 without any changes.

List TLDs

GET /{token}/tlds

Returns all supported TLDs with domain counts, latest add and delete counts, and last processed date.

listall boolean optional

Set to true to include unsupported TLDs. Default false.

{
  "status":  true,
  "records": 1136,
  "data": [
    {
      "tld":                  "com",
      "domaincount":         158884998,
      "latest_add_count":    136409,
      "latest_delete_count": 113386,
      "last_processed":      "2023-08-29"
    }
  ]
}

Added Domains

GET /{token}/added

Returns domains newly added to zone files on the specified date. Omit the date parameter for the most recent available data.

date string optional

Date in yyyymmdd format. Omit for the latest available data.

kw string optional

Keyword filter. Separate multiple keywords with | for OR matching. Supports the % wildcard character. Remember to URL-encode % as %25.

tlds string optional

Comma-separated list of TLDs. Example: com,net,org

dcm enum optional

Date comparison mode: eq, lt, gt, lte, gte. Default eq. Use lte to retrieve all domains up to and including the given date (max 45-day range).

idn integer optional

0 = non-IDN only, 1 = IDN only, 2 = all. Default 2.

sorton enum optional

date, domain, length, idn, or tld. Default date. Keep consistent across paginated calls.

dm enum optional

data or stats. Set to stats to return counts only without the full domain list.

{
  "status":  true,
  "date":    "2023-08-23",
  "records": 210413,
  "source":  "added domains",
  "data": [
    {
      "domain": "albadigitalenterprises.scot",
      "name":   "albadigitalenterprises",
      "tld":    "scot",
      "length": 22,
      "idn":    0,
      "ipv4":   null,
      "date":   "2023-08-23"
    }
  ]
}

Deleted Domains

GET /{token}/deleted

Returns domains removed from zone files on the specified date. Accepts the same parameters as the Added Domains endpoint.

Keywords

GET /{token}/keywords

Returns keyword occurrence counts across daily added or deleted domains, showing how many domains contain a keyword at the start, end, middle, or anywhere in the name. Keywords must be 4 or more characters. Non-IDN domains only.

source enum optional

added or deleted. Default added.

dm enum optional

data, stats, topkw, or aggregate. The aggregate mode returns totals for a specific keyword across TLDs and dates. The topkw mode returns the most frequent keywords and ignores tlds and kw parameters.

{
  "status": true,
  "date":   "2024-06-02",
  "data": [
    {
      "keyword":                           "shop",
      "tld":                               "com",
      "domains_starting_with_word":       213,
      "domains_ending_with_word":         405,
      "domains_with_word_in_middle":      95,
      "domains_containing_word_anywhere": 713
    }
  ]
}

Daily ZIP

GET /{token}/dailyzip/

Downloads a ZIP file of the full domain list for a given date. Useful for bulk ingestion pipelines that need to process an entire day's data locally.

date string optional

Date in yyyymmdd format. Omit for the previous day's data.

source enum optional

added or deleted. Default added.

latest flag optional

Add &latest to the query string (no value) to download a ZIP for the current day containing domains processed so far. Only valid when no date parameter is specified.