Domain Activity API

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

Daily feeds of newly observed and no-longer-observed gTLD domains derived from public DNS and registry-related activity signals. Also provides trademark, company-name, brand-name, and other keyword occurrence statistics plus a bulk ZIP download for pipeline ingestion.

This is a daily activity feed, not a full gTLD search database. Use this API when you want daily added/deleted domain data. If you need to search the broader indexed DNS/gTLD dataset for trademarks, company names, product names, suspicious terms, nameserver-hosted domain lists, DNS records, PTR, ASN, or observed subdomains, use the DNS API.

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 observed in the daily gTLD activity data 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 no longer observed in the daily gTLD activity data 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.