Query Malware Intelligence data with natural language

Find sandbox artifacts using plain English instead of structured query syntax.

What this endpoint does

Searches Recorded Future's malware sandbox analysis database using plain English instead of structured query syntax. The API translates your natural language description into a query expression and executes it, returning the same paginated artifact list as Malware Intelligence: Query. Use this to explore sandbox data without learning the query syntax — the response includes the generated query so you can refine it using the structured endpoint. For specific IOC lookups, use Malware Intelligence: Query by IOCs instead.

Response data

Returns matching sandbox artifacts with the auto-generated structured query that was executed. Fields use camelCase (executedQuery, totalPages). Paginated; use totalPages to determine iteration bounds.

Body Params
string
required

Query in natural language to filter the Malware Intelligence data with

string
enum
required

Field of Malware Intelligence data to return data for

date
required

Earliest date to include in the query (cannot be before 2023-11-01)

date

Latest date to include in the query, defaults to today in UTC

boolean

Only include samples submitted by your enterprise in the query (defaults to false)

integer

Page number to return. Pages are zero-indexed. (Defaults to 0)

boolean

Include sandbox score in the response

boolean
boolean

Whether to sanitize returned results. When omitted the service will default to false.

Response

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