pricing background

Subdomain Database Documentation

Subdomain Database

ASK AI
Download daily, weekly, or monthly subdomains database updates by providing the date parameter to the /daily, /weekly, or /monthly endpoints.

Tip: Not sure which date to use? The Database Files Status endpoint returns the last_update and available_from dates for daily, weekly, and monthly subdomains database snapshots, so you can verify freshness before triggering a download.

Authorization

You can make authorized requests to our API by passing API key as a query parameter. To get your API key, login to our billing dashboard and get your API key! If your API key has been compromised, you can change it by clicking on reset button in billing dashboard.

Query Parameters

Required
  • apiKey
    Get your API key from our billing dashboard.
Optional
  • date

    Date parameter is optional. The most recent data will be fetched if the link doesn't have a date specified. If you choose to provide a date, use the format (yyyy-MM-dd). To find out the latest available file date and the earliest snapshot still hosted, use the Database Files Status endpoint.

Request

shellnodejsjavapythonphprubyjscsharpgocswiftjquery
SHELL
Loading request...

File Extension: The API returns the result as a gzip-compressed CSV file (.csv.gz) for efficient download and storage. To extract the file, follow this tutorial.

Response

Loading response...

Fields Description

Fields
Details
Data Type
Example
num
Record sequence number
number
1
domain_name
Root domain name
string
sbc.eu
subdomain
Associated subdomain or hostname mapped to the root domain
string
www.static.sbc.eu
query_date
Date when the record was queried
string (YYYY-MM-DD)
2025-05-24
create_date
Domain creation date
string (YYYY-MM-DD)
2019-11-15
inactive_from
Date when the domain/subdomain became inactive (if applicable)
string (YYYY-MM-DD)
insertion_date
Date when the record was inserted into the database
string (YYYY-MM-DD)