Search

Search queries are submitted using Empirical's search syntax.

get

Execute a search query. This query uses Empirical's search syntax and the query portion should be URL-encoded. For example, cURL users can specify -G --data-urlencode "q=score:>90" as part of their command to correctly encode and append the search query.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
qstringOptional

The query to execute, using Empirical search syntax

Example: score:>90 vendor:microsoft exp_activity:true
scoring_modelstringOptional

The key of the scoring/model to use for the search (e.g., epss_v4, global, etc.)

Header parameters
acceptstringOptional

JSON is the default response type. If JSON Lines is preferable, set this header to application/jsonl.

Example: application/jsonl
Responses
200

successful

application/json
get
/api/search
200

successful

Last updated

Was this helpful?