List hosts sharing a fact
GET/hosts
Pivots from one observed fact to the hosts that have it. Send exactly one of
domain, ip, asn, country, technology, certificate, cookie, header,
or mime. include_apex applies only to domain, and the cookie attribute
filters only to cookie. Cookie and header values are not stored; only names
and attributes match. Quota class host_collection.
Request
Responses
- 200
- 400
- 401
- 403
- 429
- 500
- 502
- 503
- 504
A page of matching hosts.
Response Headers
The minute, hour, and day limits of the governing quota, for example 50;w=60, 500;w=3600, 500;w=86400.
Limit of the governing window.
Requests remaining in the governing window.
Seconds until capacity is available in the governing window.
BAD_REQUEST: a parameter is missing or invalid, or a cursor was reused with different parameters.
MISSING_API_KEY: the x-apikey header is missing.
INVALID_API_KEY (the key is invalid or disabled, or could not be verified) or FORBIDDEN (the key may not use this operation).
RATE_LIMIT_EXCEEDED: a quota is exhausted. Wait Retry-After seconds. Rejected requests are not counted.
Response Headers
The minute, hour, and day limits of the governing quota, for example 50;w=60, 500;w=3600, 500;w=86400.
Limit of the governing window.
Requests remaining in the governing window.
Seconds until capacity is available in the governing window.
Seconds to wait before retrying.
INTERNAL_ERROR: an unexpected gateway failure. Retry later.
BAD_GATEWAY: an internal service failed or returned an invalid response. Retry later.
RATE_LIMIT_UNAVAILABLE: quota enforcement is temporarily unavailable. Retry later.
GATEWAY_TIMEOUT: an internal service timed out. Retry later.