Domain Activity API v2

Daily feeds of newly observed and no-longer-observed gTLD domains derived from public DNS and registry-related activity signals. The API also provides trademark, company-name, brand-name, and other keyword occurrence statistics, TLD information, and bulk ZIP downloads for pipeline ingestion.

Authenticate using the common API v2 flow described in Authentication, then place the returned token in the request path. 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

Returns supported TLDs with registry details, current domain counts, latest add/delete counts, and the last processed date. By default the endpoint returns TLDs processed recently; use listall=true to include the full known TLD list.

Example

# Recently processed/supported TLDs
GET https://api.codepunch.com/dnfeed/v2/TOKEN/tlds

# Full known TLD list as plain text
GET https://api.codepunch.com/dnfeed/v2/TOKEN/tlds?listall=true&format=txt

Representative JSON response

{
  "status":  true,
  "records": 1136,
  "data": [
    {
      "tld":                  "com",
      "tld_ascii":            "com",
      "registry":             "Verisign",
      "registry_url":         "https://www.verisign.com/",
      "whois_server":         "whois.verisign-grs.com",
      "rdap_server":          "https://rdap.verisign.com/com/v1/",
      "domaincount":          158884998,
      "latest_add_count":     136409,
      "latest_delete_count":  113386,
      "last_processed":       "2023-08-29"
    }
  ]
}

Added Domains

Returns domains newly observed in the daily gTLD activity data. If date is omitted, the API uses the current date with the default exact-date comparison.

Examples

# Current-date .com/.net domains containing "bank" or "login"
GET https://api.codepunch.com/dnfeed/v2/TOKEN/added?kw=%25bank%25%7C%25login%25&tlds=com,net&start=0&limit=500&sorton=date&sortorder=asc

# Count matching domains from a supplied date onward
GET https://api.codepunch.com/dnfeed/v2/TOKEN/added?date=YYYYMMDD&dcm=gte&kw=%25bank%25&dm=stats

# Text-format domain list
GET https://api.codepunch.com/dnfeed/v2/TOKEN/added?tlds=com&format=txt&limit=5000

Representative JSON response

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

records is the total number of rows matching the filters; data contains only the current page.

Deleted Domains

Returns domains no longer observed in the daily gTLD activity data. It accepts the same date, kw, tlds, dcm, idn, format, sorton, sortorder, start, limit, and dm parameters as Added Domains.

# Deleted .com domains containing "paypal" from a supplied date onward
GET https://api.codepunch.com/dnfeed/v2/TOKEN/deleted?date=YYYYMMDD&dcm=gte&kw=%25paypal%25&tlds=com&start=0&limit=500

Keyword Statistics

Returns keyword occurrence statistics across daily added or deleted domains, including how many domains start with, end with, contain in the middle, or contain the keyword anywhere. Stored keyword rows are at least four characters long and have more than two total occurrences. The keyword statistics dataset covers non-IDN domains.

Examples

# Exact keyword statistics for "shop" in .com
GET https://api.codepunch.com/dnfeed/v2/TOKEN/keywords?date=YYYYMMDD&kw=shop&tlds=com

# Top 20 keywords in .net for one date
GET https://api.codepunch.com/dnfeed/v2/TOKEN/keywords?date=YYYYMMDD&dm=topkw&tlds=net&sorton=all_count&limit=20

# Aggregate "shop" across matching added-domain statistic rows
GET https://api.codepunch.com/dnfeed/v2/TOKEN/keywords?date=YYYYMMDD&dcm=gte&kw=shop&source=added&dm=aggregate

Representative data response

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

Daily ZIP

Downloads the full added or deleted domain list as a ZIP file. Use the normal undated download for the previous day's completed file, date for a specific dated file, or latest for the current day's partial file containing domains processed so far.

Examples

# Previous day's completed added-domains ZIP
GET https://api.codepunch.com/dnfeed/v2/TOKEN/dailyzip/?source=added

# Deleted-domains ZIP for a specific date
GET https://api.codepunch.com/dnfeed/v2/TOKEN/dailyzip/?source=deleted&date=YYYYMMDD

# Current-day added domains processed so far
GET https://api.codepunch.com/dnfeed/v2/TOKEN/dailyzip/?source=added&latest