Domain API v2

🔨 Download domain lists and datasets directly to your server 🔨

Have general questions about our domain datasets? Read our FAQ.

Looking for our legacy API v1? Click here.

Base endpoint: https://netapi.com/api2/ API response format: comma-separated CSV (check sample)

DOMAIN API / List of existing domain zones: Get the list of supported domain zones
DOMAIN API / Domain lists and datasets: Download any domain zone list, dataset, or part of them

DNS API / Known DNS providers: Get the list of supported DNS providers
DNS API / DNS domain lists and datasets: Download lists of domains using particular DNS provider

WHOIS API / Known Registrars: Get the list of known domain registrars
WHOIS API / WHOIS download: Get the list of domains using particular Registrar

Compromised IPs and domains: Download lists of malicious/phishing IPs/URLs

LOOKUP API / Domain Lookup API: Get information about a specific domain
LOOKUP API / IP Lookup API: Get information about a specific IP

List of existing domain zones: Get the list of supported domain zones in .CSV format

GET Request Endpoint:

https://netapi.com/api2/?method=zones

This returns a list of currently supported domain zones in .CSV format with the following fields:

Input GET parameters: ---

Output data (comma-separated .csv):

zoneTLD - zone TLD (extension) (used in download method listed below)

isUpdatedDaily - 1 if the zone is updated daily, 0 if not

isCountryCode - 1 if the zone is country code, 0 if not

* You can also download a list of all supported zones in .CSV format by clicking HERE.

Domain lists and datasets: Download any domain zone list, dataset, or part of them

GET Request Endpoint:

https://netapi.com/api2/?method=download

Input GET parameters:

zone_tld	[Required] TLD (extension) of the required zone. To get a common dataset of all domains (all zones at once), use the all-zones parameter. For IDN-domains, use the original IDN (punycode). Example: all-zones - all domain zones at once com - .com zone xn--3ds443g - IDN zone ( 在线 ) ⚡ You can get the list of all supported TLDs by using the /api2/?method=zones endpoint (see above).
dataset_type	[Required] Dataset type. list - contains only list of domains, one domain per line. dataset - contains additional data (domain, server DNS, IP, emails, phone numbers, etc.) Read more →
filter_type	[Required] Filter. active - full list of domains of the required zone new - domains found for the last 24 hours in this zone (recently delegated) ⚡ New parameter is available only for classic and gTLD zones. For country-code zones, only active parameter is available. Read more →
token	[Required] API access token. This is your unique API token that can be found in the HOME section of your account.
format	[Optional] The format of the response file. By default, you will receive the dataset in the compressed .GZ format. If you require plain-text format, you can add the &format=plain parameter to your request. ⚡ Warning: Plain-text files tend to be very large (for example, the .COM zone file size can be up to several gigabytes). Use this parameter only if necessary.

Output data (comma-separated .csv):

Domain - domain name

Majestic rank - Majestic top 1mln websites rank, integer (if any)

DNS 1 - DNS server 1

DNS 2 - DNS server 2

Hostname - remote server hostname

Emails - emails collected from the website (one field, comma-separated)

Phones - phone numbers collected from the website (one field, comma-separated)

Server IP - remote server IP

Domain country - the two-digit country code of the website domain, determined by the domain IP

Response and Error Codes

Our List/Dataset Download API returns one of the following HTTP response codes:

Code	Description
200	OK
401	401 Unauthorized: Missing user token. Details: https://netapi.com/help/api/
405	405 Method Not Allowed: Missed zone type. Details: https://netapi.com/help/api/
405	405 Method Not Allowed: Invalid zone tld. Details: https://netapi.com/help/api/
405	405 Method Not Allowed: Missed dataset type. Details: https://netapi.com/help/api/
405	405 Method Not Allowed: Invalid dataset type. Details: https://netapi.com/help/api/
405	405 Method Not Allowed: Missed filter type. Details: https://netapi.com/help/api/
405	405 Method Not Allowed: Invalid filter type. Details: https://netapi.com/help/api/
403	403 Forbidden: No active/paid plan. Details: https://netapi.com/dashboard/
403	403 Forbidden: Your current plan does not allow downloading of detailed datasets. Details: https://netapi.com/dashboard/

Known DNS providers: Get the list of supported DNS providers

GET Request Endpoint:

https://netapi.com/api2/?method=dns

This returns a list of currently supported DNS with the following fields:

Input GET parameters: ---

Output data (comma-separated .csv):

alias - DNS provider alias (used in download-dns method)

title - official DNS title

total - known domains for this provider

* You can also download a list of all supported DNS by clicking HERE.

DNS domain lists and datasets: Download lists of domains using particular DNS provider

GET Request Endpoint:

https://netapi.com/api2/?method=download-dns

Input GET parameters:

dns_alias	[Required] Alias of the required DNS provider. Use the `dns` method listed above to get the full list of aliases for all currently supported DNS providers (or download them here).
dataset_type	[Required] Dataset type. list - contains only list of domains, one domain per line dataset - contains additional data (domain, server DNS, IP, emails, phone numbers, etc.) Read more →
token	[Required] API access token. This is your unique API token that can be found in the HOME section of your account.
format	[Optional] The format of the response file. By default, you will receive the dataset in the compressed .GZ format. If you require plain-text format, you can add the &format=plain parameter to your request. ⚡ Warning: Plain-text files tend to be very large (for example, the Cloudflare domain dataset can be up to several gigabytes). Use this parameter only if necessary.

Output data (comma-separated .csv):

Domain - domain name

Majestic rank - Majestic top 1mln websites rank, integer (if any)

DNS 1 - DNS server 1

DNS 2 - DNS server 2

Hostname - remote server hostname

Emails - emails collected from the website (one field, comma-separated)

Phones - phone numbers collected from the website (one field, comma-separated)

Server IP - remote server IP

Domain country - the two-digit country code of the website domain, determined by the domain IP

Response and Error Codes

Our List/Dataset Download API returns one of the following HTTP response codes:

Code	Description
200	OK
401	401 Unauthorized: Missing user token. Details: https://netapi.com/help/api/
405	405 Method Not Allowed: Missed DNS alias. Details: https://netapi.com/help/api/
405	405 Method Not Allowed: Invalid DNS alias. Details: https://netapi.com/help/api/
405	405 Method Not Allowed: Missed dataset type. Details: https://netapi.com/help/api/
405	405 Method Not Allowed: Invalid dataset type. Details: https://netapi.com/help/api/
403	403 Forbidden: No active/paid plan. Details: https://netapi.com/dashboard/
403	403 Forbidden: Your current plan does not allow downloading of DNS datasets. Details: https://netapi.com/dashboard/

Known Domain Registrars: Get the list of supported registrars

GET Request Endpoint:

https://netapi.com/api2/?method=registrars

This returns a list of currently known domain registrars with the following fields:

Input GET parameters: ---

Output data (comma-separated .csv):

id - Registrar ID (used in the download-whois method)

name - official name (legal entity, i.e. 'Tucows Domains Inc.')

brand - known brand name (i.e. 'Godaddy', 'NameCheap', etc)

total - known domains for this registrar

* You can also download a list of all known registrars by clicking HERE.

WHOIS lists and datasets: Download datasets of domains using particular domain Registrar

GET Request Endpoint:

https://netapi.com/api2/?method=download-whois

Input GET parameters:

registrar_id	[Required] ID of the required Registrar. Use the `registrars` method listed above to get the full list of aliases for all currently supported DNS providers (or download them here).
dataset_type	[Required] Dataset type. list - contains only list of domains, one domain per line dataset - contains additional data (domain, registration date, expiring date, server IP, country code, emails, phone numbers, etc.) Read more →
token	[Required] API access token. This is your unique API token that can be found in the HOME section of your account.
format	[Optional] The format of the response file. By default, you will receive the dataset in the compressed .GZ format. If you require plain-text format, you can add the &format=plain parameter to your request. ⚡ Warning: Plain-text files tend to be very large (for example, the GoDaddy domain dataset can be up to several gigabytes). Use this parameter only if necessary.

Output data (comma-separated .csv):

Registrar - registrar name

Domain - domain name

Registration date - domain registration date

Expiration date - domain expiration date

Majestic rank - Majestic top 1mln websites rank, integer (if any)

Emails - emails collected from the website (one field, comma-separated)

Phones - phone numbers collected from the website (one field, comma-separated)

Server IP - remote server IP

Domain country - the two-digit country code of the website domain, determined by the domain IP

Response and Error Codes

Our List/Dataset Download API returns one of the following HTTP response codes:

Code	Description
200	OK
401	401 Unauthorized: Missing user token. Details: https://netapi.com/help/api/
405	405 Method Not Allowed: Missed Registrar ID. Details: https://netapi.com/help/api/
405	405 Method Not Allowed: Invalid Registrar ID. Details: https://netapi.com/help/api/
405	405 Method Not Allowed: Missed dataset type. Details: https://netapi.com/help/api/
405	405 Method Not Allowed: Invalid dataset type. Details: https://netapi.com/help/api/
403	403 Forbidden: No active/paid plan. Details: https://netapi.com/dashboard/
403	403 Forbidden: Your current plan does not allow downloading of WHOIS datasets. Details: https://netapi.com/dashboard/

Domain Lookup API: Get information about a specific domain

GET Request Endpoint:

https://netapi.com/api2/?method=lookup-domain

Returns data for the specified domain in .CSV format:

Input GET parameters:

domain

[Required] Domain name (for example, domain.com)

token

[Required] API access token.

This is your unique API token that can be found in the HOME section of your account.

Output data (comma-separated .csv):

URL - requested domain

DNS1 - DNS server 1

DNS2 - DNS server 2

HOSTNAME - server hostname

IP - server IP

COUNTRY_CODE - two-letter country code (according to the server IP)

REGISTERED_AT - domain registration date (YYYY-MM-DD)

EXPIRING_AT - domain expiration date (YYYY-MM-DD)

REGISTRAR_ID - domain Registrar ID (integer, see the registrar method)

Response and Error Codes

Our Domain Lookup API returns one of the following HTTP response codes:

Code	Description
200	OK
401	401 Unauthorized: Missing user token. Details: https://netapi.com/help/api/
405	405 Method Not Allowed: Invalid domain zone (.tld). Details: https://netapi.com/help/api/
405	405 Method Not Allowed: Domain name is too long. Details: https://netapi.com/help/api/

IP Lookup API: Get information about a specific IP

GET Request Format:

https://netapi.com/api2/?method=lookup-ip

Returns data for the specified IP in .CSV format (one result per line):

Input GET parameters:

[Required] IP (for example, 172.67.69.160)

token

[Required] API access token.

Your unique API token that can be found in the HOME section of your account.

Output data (comma-separated .csv):

DOMAIN - domain name whose IP matches the given IP

HOSTNAME - hostname whose domain matches the given IP

DNS1 - domain / DNS server 1

DNS2 - domain / DNS server 2

Response and Error Codes

Our IP Lookup API returns one of the following HTTP response codes:

Code	Description
200	OK
401	401 Unauthorized: Missing user token. Details: https://netapi.com/help/api/
405	405 Method Not Allowed: IP address is too long. Details: https://netapi.com/help/api/

🆓 Compromised domain lists and datasets: Download lists of compromised domains and IPs

GET Request Format:

https://netapi.com/api2/?method=compromised

This returns a list of compromised IPs or Domain names:

Input GET parameters:

dataset_type

[Required] Dataset type.

ip - Lists of current compromised IP addresses (for 24 hours)

url - Lists of current compromised domain names (for 24 hours)

ip-all - historical list of IPs ever compromised.
⚠️ The presence of a IP in this list does not mean that the IP is compromised at the moment (moreover, it is most likely that it is not).

url-all - historical list of URLs ever compromised.
⚠️ The presence of a URL in this list does not mean that the URL or website is compromised at the moment (moreover, it is most likely that it is not).

Output data:

IP or Domain - one per line