Search Hosts

Accepts queries for host or service attributes provided in the Censys Search Language and returns a list of matching hosts with some summary fields.

Cursor Pagination

Search endpoints rely on using cursors for efficient pagination.

Each search result may return a next and prev cursor value which can be used to fetch additional pages of results.

{
    "links":{ 
        "prev":"prevCursorToken", 
        "next":"nextCursorToken" 
    }, 
    [Rest of Response]
} 

The returned cursor token values can be added to the search endpoint as a cursor parameter to fetch either the next page of results or the previous page.

The entire set of results can be iterated page-by-page using returned cursors. If no cursor is given, the first page will be returned.

Basic Parameters

Parameter	Description
Fields	Comma separated list of up to 25 fields to be returned for each result. (This parameter is only available to paid users.).
Query	Query used to search for hosts with matching attributes. Uses the Censys Search Language.

Advanced Parameters

Parameter	Description
Cursor	Cursor token from the API response, which fetches the next or previous page of hits when added to the endpoint URL.
Per Page	The maximum number of hits to return in each response (minimum of 1, maximum of 100).
Sort	Sort the results.
Virtual Hosts	Determine how to query Virtual Hosts. The default is EXCLUDE which will ignore any virtual hosts entries. When set to INCLUDE or ONLY virtual hosts will be present in the returned list of hits, with the later returning only virtual hosts. To learn more, see the Help Desk article on Virtual Hosts.

Example Output

{
    "code": 200,
    "result": {},
    "status": "OK"
}

Workflow Library Example

Search Hosts with Censys and Send Results Via Email

Preview this Workflow on desktop