Search entities

curl --request GET \
  --url https://api-next.dealroom.co/api/data/search \
  --header 'Authorization: Bearer <token>'

{
  "data": {
    "results": [
      {
        "uuid": "<string>",
        "name": "<string>",
        "tagline": "<string>",
        "image": "<string>",
        "is_unicorn": true,
        "investor_rank": 123,
        "website_domain": "<string>",
        "hq_city": "<string>",
        "hq_country": "<string>"
      }
    ]
  }
}

Search entities

Searches the entity index by name and returns a flat ranked array of rows; each row carries its type (company | investor | person | university | gov_ngo) plus display fields website_domain, hq_city, and hq_country (any of which may be null). Scope is controlled by the types= param (comma-separated; defaults to every type the caller may read). Types the caller lacks permission for are silently dropped. Default ranking uses pg_trgm word-similarity on entities.name (gated by SEARCH_RANKING_ENABLED, default on; when off it falls back to full-string similarity). When SEARCH_TYPE=hybrid the endpoint additionally fuses with vector ANN over entity_embeddings via Reciprocal Rank Fusion. See docs/hybrid-search.md.

GET

api

data

Search entities

curl --request GET \
  --url https://api-next.dealroom.co/api/data/search \
  --header 'Authorization: Bearer <token>'

{
  "data": {
    "results": [
      {
        "uuid": "<string>",
        "name": "<string>",
        "tagline": "<string>",
        "image": "<string>",
        "is_unicorn": true,
        "investor_rank": 123,
        "website_domain": "<string>",
        "hq_city": "<string>",
        "hq_country": "<string>"
      }
    ]
  }
}

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

string

required

Search term (minimum 2 characters)

Minimum string length: 2

types

string

Comma-separated entity types to search (investor, person, company, university, gov_ngo). Defaults to every type the caller is permitted to read.

Example:

"company,investor"

limit

number

default:5

Maximum number of results per request (default 5, max 20)

Required range: 1 <= x <= 20

Response

Flat ranked results array, up to limit rows

data

object

required

Show child attributes

Search Ecosystems