Search for Domain entities based on a filter

Find domains by risk score, risk rules, dates, or list membership with paginated enrichment results.

What this endpoint does

This endpoint searches the Recorded Future Intelligence Cloud for domain entities matching specified criteria. You can filter domains by risk score ranges, specific risk rules (use the Domain Risk Rules endpoint to get valid rule names), first/last seen dates, and Recorded Future list membership. Results can be sorted by risk score, criticality, total or recent reference counts, or chronological fields, enabling prioritized views of the most dangerous or recently active domains. The enrichment fields system lets you control which data is returned per result, such as entity identifiers and risk scoring—consult the Enrichment: Field Attributes reference for all available field options.

Response data

The response contains a paginated array of matching domain entities, each populated with the requested enrichment fields, along with count metadata showing the number of returned and total matching records. When risk data is requested, each domain includes a composite risk score (0-99), criticality level, and a breakdown of every triggered risk rule with supporting evidence—sighting counts, source descriptions, timestamps, and mitigation notes. Paginated with offset-based pagination; limit max 1,000 and limit + from cannot exceed 1,000. Results are under data.results, with counts as a sibling of data. The limit parameter has a default value of 10. The intention is to use pagination to get further results. Though limit can be set to higher values, depending on which fields are used for enrichment, this might result in slower queries and possibly even time outs.

Query Params
string

The enrichment fields requested for the entities returned. Several fields can be given as a comma separated string.

See https://docs.recordedfuture.com/reference/enrichment-field-attributes for a list of values.

enum

Annotates the response with additional metadata explaining the response data elements.

Allowed:
int32
≤ 1000

Maximum number of records returned,

int32
Defaults to 0

Offsets the pagination of the request. Note that there is a limit of returning only the top 10000 results from a search, meaning if limit plus from exceeds 10000, this will result in an Bad Request message.

string

Filters entities based on risk score, e.g. on the form [20, 80] (20 <= risk score <= 80), [20,) (20 <= risk score), or [,90) (risk score < 90). '[' and ']' are inclusive while '(' and ')' are exclusive.

string

Filters entities based on the download of the first reference which is taken into account during risk scoring of the entity. All Elasticsearch compatible date formats are valid.

string

Filters entities based on the download of the latest reference which is taken into account during risk scoring of the entity. All Elasticsearch compatible date formats are valid.

string

Filters entities based on presence in a single list. Requires the list ID, which can be found using the List API

enum

Filters for domains based on a single risk rule.

string

Filters for companies based on parent company. The expected value is a Company ID.

enum

Sorts the search according to the chosen parameter. Results are sorted before pagination.

enum

The direction of the sorting by the orderBy parameter, ascending or descending.

Allowed:
string
deprecated
Response

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