Search host cohorts
GET/hosts/search
Finds hosts by observation time and incoming or outgoing relation metrics. Time
bounds are inclusive RFC3339 timestamps. Relation count and ratio filters, and sorting
by them, require the corresponding relation type. Minimums cannot exceed maximums.
Quota class host_search.
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.