Host.io API Documentation
发布时间:2026-10-19 | 浏览:2
Pagination and Limits
/api/web/:domain
/api/dns/:domain
/api/related/:domain
/api/full/:domain
/api/domains/:field/:value
Your API token is used to authenticate you with our API, and can be provided either as an HTTP Basic Auth username, a bearer token, or alternatively as a token URL parameter.
If no token is provided, you will receive an error message response with an HTTP 400 status code.
Pagination and Limits
API endpoints that return a list of domains (for eg, /api/domains/ip/:domain which returns a list of domains on a particular IP) can be paginated by using query parameters 'page' and 'limit'.
The following code will return 50 domains for the IP 8.8.8.8 starting from 250th.
The max limit is 1000.
It's important to note that the maximum number of domains you can request is subject to your plan . For example, with free plan you can request maximum of 5 domains per page. Please check pricing page to see how many domains you can request per API call.
/api/web/:domain
Metadata scraped from a domain homepage.
Returns the HTTP 404 status code as well as an error message in JSON format if the domain is invalid and/or has no data associated with it.
/api/dns/:domain
Get all the DNS records stored for a domain.
Currently supported records are:
A (IPv4 address)
AAAA (IPv6 address)
MX (mailserver)
NS (nameserver)
Returns the HTTP 404 status code as well as an error message in JSON format if the domain is invalid and/or has no data associated with it.
/api/related/:domain
Get a count of the number of related domains for all supported lookups we offer. See /api/domains/:field for a full list of fields, and details on how to get the list of related domains.
Returns the HTTP 404 status code as well as an error message in JSON format if the domain is invalid and/or has no data associated with it.
/api/full/:domain
A single endpoint that includes the data from /api/web , /api/dns , /api/related and IPinfo .
Returns the HTTP 404 status code as well as an error message in JSON format if the domain is invalid and/or has no data associated with it.
/api/domains/:field/:value
Get all domains associated with :field , and a count of the total. The :value should be according to the :field and not necessarily a domain. Supported fields:
Results are limited to a maxmimum of 1000 per page, and a maximum of 10 million total results.
Also see /api/related/:domain , which returns the count of related domains and the associated values for a domain.
limit : Must be one of 0, 1, 5, 10, 25, 100, 250, or 1000. Default is 25.
page : The page of data to view, 0-indexed. Default is 0. Pagination takes into account the limit .
Returns the HTTP 404 status code as well as an error message in JSON format if the domain is invalid and/or has no data associated with it, or if the limit/page combination is out-of-bounds.