CensEye: Retrieve value counts to discover pivots

Get counts of web assets for specific field-value pairs and combinations of field-value pairs. This is similar to the CensEye functionality available in the Platform web UI, but it allows you to define specific fields of interest rather than the default fields leveraged by the tool in the UI.

Each array can only target fields within the same nested object and may contain at most 5 field-value pairs. For example, you can combine host.services.port=80 and host.services.protocol=SSH in the same array, but you cannot combine host.services.port=80 and host.location.country="United States" in the same array. You can input multiple arrays of objects in each API call.

To use this endpoint, your organization must have access to the Adversary Investigation module. This endpoint costs 1 credit per count condition (array of objects) included in the API call.

Body Params
and_count_conditions
array of objects | null
required

Groups of field-value pairs to count matches for. Each group may contain up to 5 field-value pairs.

and_count_conditions*
string

CenQL query string to filter documents

Query Params
uuid
required

The ID of a Censys organization to associate the request with. See the Getting Started docs for more information.

Headers
uuid

The ID of a Censys organization to associate the request with. See the Getting Started docs for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter.

string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Bearer
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/problem+json