Skip to main content
GET
/
api
/
reference
/
filters
/
search
Search filters and values
curl --request GET \
  --url https://api-next.dealroom.co/api/reference/filters/search \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "kind": "value",
      "filter_key": "tag_id",
      "filter_picker_key": "tag_id:industry",
      "filter_label": "Industries",
      "pinned_sub_type": "industry",
      "label": "Fintech",
      "value": "42",
      "entity_count": 1200,
      "source_type": "industry"
    },
    {
      "kind": "year",
      "filter_key": "launch_date",
      "filter_picker_key": "launch_date",
      "filter_label": "Founded Year",
      "label": "Founded Year: After 2020",
      "value": "2020",
      "operator": "gte"
    },
    {
      "kind": "filter",
      "filter_key": "tag_id",
      "filter_picker_key": "tag_id:sector",
      "filter_label": "Sectors",
      "pinned_sub_type": "sector",
      "category": "Sectors"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

OAuth2 client-credentials flow against the Dealroom Auth0 tenant. Use the client_id / client_secret from a Programmatic API key. Tokens are valid for 24h — Swagger UI will reuse the same token across operations.

Query Parameters

​
scope
enum<string>
required

Required. One of: companies, investors, transactions, people, universities, news, jobs

Available options:
companies,
investors,
transactions,
people,
universities,
news,
jobs
Example:

"companies"

​
q
string
required

Search query (min 1 char). Filter labels and year heuristics are matched immediately; value lookup starts at 3 chars.

Minimum string length: 1
Example:

"fintech"

​
limit_per_row
string

Max value matches per picker row (1-10, default 3)

Example:

"3"

​
limit
string

Total result cap (1-50, default 20)

Example:

"20"

Response

Search matches in tier-and-row order

​
data
object[]
required