Warning: This is a legacy API. Do not use it for your new projects. The current version of the API can be found HERE.

Domain API v1 (LEGACY)

🔨 Download domain lists and datasets directly to your server 🔨

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

Base endpoint: https://netapi.com/api/
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 Format:

https://netapi.com/api/zones/

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

Output data:

zoneTLD - zone TLD (extension)
isUpdatedDaily - 1 if the zone is updated daily, 0 if not
isCountryCode - 1 if the zone is a country-code (ccTLD) zone, 0 if not

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

Domain lists and datasets: Download the full list or dataset of any domain zone, or only its new domains

GET Request Format:

https://netapi.com/api/download/zone-tld/dataset-type/data-type/?token=your-token&format=plain

Output data:

Domain - domain name
Majestic rank - Majestic Million rank, integer (empty if not ranked)
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)

Input data:

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 zones, use the punycode form. Example:

all-zones - all domains, all zones combined

com - .com zone

xn--3ds443g - IDN zone ( 在线 )

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 →

data-type

[Required] Data type.

active - full list of domains of the required zone

new - domains found for the last 24 hours in this zone (recently delegated)

⚡ The new filter is available only for daily-updated zones (isUpdatedDaily=1 in the zones method). For zones refreshed monthly, only the active filter is available. Read more →

your-token

[Required] API access token.

This is your unique API token that can be found in the Dashboard.

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.

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 Format:

https://netapi.com/api/dns/

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

Output data:

alias - DNS provider alias (used in download-dns method)
title - DNS provider name
total - known domains for this provider

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

🆓 Compromised IPs and domains: Download all compromised IPs or domain names

GET Request Format:

https://netapi.com/api/compromised/dataset-type/

This returns a list of compromised IPs or domain names:

Output data:

IP or Domain - one per line

Input data:

dataset-type

[Required] Dataset type.

ip - current compromised IP addresses (seen in the last 24 hours)

url - current compromised domain names (seen in the last 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 (most likely it is not).

url-all - historical list of domain names ever compromised.
⚠️ The presence of a domain in this list does not mean that the domain is compromised at the moment (most likely it is not).

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

GET Request Format:

https://netapi.com/api/download-dns/dns-alias/dataset-type/?token=your-token

Output data:

Domain - domain name
Majestic rank - Majestic Million rank, integer (empty if not ranked)
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)

Input data:

dns-alias

[Required] Alias of the required DNS provider.

Find the full list of aliases for all currently supported DNS providers here (.CSV format).

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 →

your-token

[Required] API access token.

This is your unique API token that can be found in the Dashboard.

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/

IP -> Domains Lists (Reverse IP Lists)

GET Request Format:

https://netapi.com/api/download-ip/?token=your-token&format=plain

Returns a list of IP addresses and domains associated with these addresses in .CSV format (two fields):

Output data:

IP - IP (V4 or V6)
"domain1, domain2, domain3" - list of associated domains, comma-separated

Input data:

your-token

[Required] API access token.

This is your unique API token that can be found in the Dashboard.

format

[Optional] The format of the response file.

By default, you will receive the dataset in the compressed .GZ format. If you require the plain-text format, you can add the &format=plain parameter to your request.

⚡ Warning: Plain-text files tend to be very large (up to several gigabytes). Use this parameter only if necessary.

Response and Error Codes

Our IP2Domains 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/
403 403 Forbidden: No active/paid plan. Details: https://netapi.com/dashboard/

Domain Lookup API: Get information about a specific domain

GET Request Format:

https://netapi.com/api/lookup-domain/domain.com/?token=your-token

Returns data for the specified domain in .CSV format:

Output data:

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)

Input data:

domain.com

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

[Required] API access token.

This is your unique API token that can be found in the Dashboard.

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/api/lookup-ip/IP/?token=your-token

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

Output data:

DOMAIN - domain hosted on the given IP
HOSTNAME - server hostname of that domain
DNS1 - DNS server 1 of that domain
DNS2 - DNS server 2 of that domain

Input data:

IP

[Required] IP (for example, 172.67.69.160)
your-token

[Required] API access token.

Your unique API token that can be found in the Dashboard.

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/

Server UTC time: 04:05:47pm

Service Status    Comparisons    Domain API    Top 1M list    Research    Terms of Service    Privacy Policy    Contact Us   

Made with favorite in Cyprus