Run a search query

post

https://api.platform.censys.io/v3/global/search/query

Run a search query across Censys data. Reference the documentation on Censys Query Language for information about query syntax. Host services that match your search criteria will be returned in a matched_services object.

Body Params

fields

array of strings | null

Specify fields to only return in the response. If you provide fields and omit host.services.port, host.services.transport_protocol, and host.services.protocol, then matched_services will not be returned in the response.

fields

page_size

int64 | null

≥ 0

Number of results to return to per page. The default and maximum is 100.

page_token

string

page token for the requested page of search results

query

string

required

CenQL query string to search upon

Query Params

organization_id

uuid

Headers

X-Organization-ID

uuid

The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. 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

200OK

400Bad request

401Request does not contain a valid Authorization token

403User does not have permission to access this data

422Invalid input

500Internal server error