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)

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 domains, all zones combined

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 a list of domains, one domain per line.

dataset - contains additional data (domain, DNS servers, 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 1M 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-letter country code of the website domain, determined by server IP (geolocation)

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: Missing 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: Missing 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: Missing 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/

Get the list of supported DNS providers

GET Request Endpoint:

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

This returns a list of currently supported DNS providers 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 a list of domains, one domain per line

dataset - contains additional data (domain, DNS servers, 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 1M 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-letter country code of the website domain, determined by the server IP (geolocation)

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: Missing 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: Missing 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 a list of domains, one domain per line

dataset - contains additional data (domain, registration date, expiration 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 1M 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 - two-letter country code of the website domain, determined by the server IP (geolocation)

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: Missing 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: Missing 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 registrars 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:

ip

[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 list: ALL compromised IPs/URLs

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 an 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

🆓 Compromised domain list: Download compromised domain lists for a selected TLD.

GET Request Format (single zone, live domains only):

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

Returns a list of currently compromised domains for one domain zone (TLD) only.
Only entries seen in the last 24 hours are included. IP addresses are not included in this export.

Input GET parameters:

zone_tld

[Required] TLD (extension) of the required zone.

Example:

com — .com zone

co.uk — .co.uk zone

⚡ You can get the list of all supported TLDs by using the /api2/?method=zones endpoint (see above).

Output data:

Domain — one per line (CSV download, filename e.g. compromised_com.csv)

Server UTC time: 11:35:24am

Service Status    Domain API    Reports    Terms of Service    Privacy Policy    Contact Us   

Made with favorite in Cyprus