Search Companies - Crustdata Docs

curl --request POST \
  --url https://api.crustdata.com/company/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-version: <x-api-version>' \
  --data '
{
  "filters": {
    "field": "basic_info.primary_domain",
    "type": "=",
    "value": "hubspot.com"
  },
  "fields": [
    "basic_info",
    "headcount",
    "funding"
  ],
  "limit": 1
}
'

{
  "companies": [
    {
      "basic_info": {
        "name": "HubSpot",
        "primary_domain": "hubspot.com",
        "website": "https://hubspot.com",
        "professional_network_url": "https://www.linkedin.com/company/hubspot",
        "professional_network_id": "68529",
        "company_type": "Public Company",
        "year_founded": 2006,
        "employee_count_range": "5001-10000",
        "markets": [
          "NYSE"
        ]
      },
      "taxonomy": {
        "professional_network_industry": "Software Development"
      },
      "headcount": {
        "total": 11965,
        "growth_percent": {
          "1m": 0.67,
          "3m": 2.69,
          "6m": 5.5,
          "12m": 12.63
        },
        "growth_absolute": {
          "1m": 81,
          "3m": 318,
          "6m": 634,
          "12m": 1363
        }
      },
      "funding": {
        "total_investment_usd": 130000000,
        "last_round_amount_usd": 100000000,
        "last_fundraise_date": "2021-10-13",
        "last_round_type": "",
        "investors": []
      }
    }
  ],
  "next_cursor": "H4sIAJj5zGkC_xXMMQ7CMAxA0...",
  "total_count": 264
}

POST

https://api.crustdata.com

/

company

/

search

curl --request POST \
  --url https://api.crustdata.com/company/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-version: <x-api-version>' \
  --data '
{
  "filters": {
    "field": "basic_info.primary_domain",
    "type": "=",
    "value": "hubspot.com"
  },
  "fields": [
    "basic_info",
    "headcount",
    "funding"
  ],
  "limit": 1
}
'

{
  "companies": [
    {
      "basic_info": {
        "name": "HubSpot",
        "primary_domain": "hubspot.com",
        "website": "https://hubspot.com",
        "professional_network_url": "https://www.linkedin.com/company/hubspot",
        "professional_network_id": "68529",
        "company_type": "Public Company",
        "year_founded": 2006,
        "employee_count_range": "5001-10000",
        "markets": [
          "NYSE"
        ]
      },
      "taxonomy": {
        "professional_network_industry": "Software Development"
      },
      "headcount": {
        "total": 11965,
        "growth_percent": {
          "1m": 0.67,
          "3m": 2.69,
          "6m": 5.5,
          "12m": 12.63
        },
        "growth_absolute": {
          "1m": 81,
          "3m": 318,
          "6m": 634,
          "12m": 1363
        }
      },
      "funding": {
        "total_investment_usd": 130000000,
        "last_round_amount_usd": 100000000,
        "last_fundraise_date": "2021-10-13",
        "last_round_type": "",
        "investors": []
      }
    }
  ],
  "next_cursor": "H4sIAJj5zGkC_xXMMQ7CMAxA0...",
  "total_count": 264
}

Authorizations

Authorization

string

header

required

API key passed as a Bearer token in the Authorization header.

Headers

x-api-version

enum<string>

default:2025-11-01

required

API version to use. This endpoint currently requires 2025-11-01.

Available options:

2025-11-01

Example:

"2025-11-01"

Body

application/json

Search filters, pagination, sorting, and field selection

Request body for searching the company database using indexed fields.

filters

object

Search filters. Use a single SearchCondition or an and/or SearchConditionGroup.

Option 1
Option 2

Show child attributes

Example:

{
  "field": "basic_info.primary_domain",
  "type": "=",
  "value": "hubspot.com"
}

cursor

string

Pagination cursor from a previous response's next_cursor. Omit on the first page.

Example:

"H4sIAJj5zGkC_xXMMQ7CMAxA0..."

limit

integer

default:20

Required range: 1 <= x <= 1000

sorts

object[]

Sort directives applied to matched companies in order.

Show child attributes

Example:

[
  {
    "field": "headcount.total",
    "order": "desc"
  }
]

fields

string[]

Fields to return in the response. Use dot-notation for nested fields (e.g., "basic_info.name", "headcount.total"). Only requested fields appear in the response. Valid top-level groups for search: basic_info, revenue, headcount, funding, hiring, locations, taxonomy, followers, social_profiles, software_reviews, metadata, updated_at, indexed_at, crustdata_company_id. Some groups are filter-only and cannot be selected here (for example roles, skills, seo, competitors), and groups not in the search index (for example news, people, web_traffic, employee_reviews) are rejected — use /company/enrich for those.

Example:

["basic_info", "headcount", "funding"]

Response

Companies matching the search criteria

Paginated response from the /company/search endpoint.

companies

object[]

required

Show child attributes

next_cursor

string | null

total_count

integer | null

query

object

Related topics

Company Search Batch Search Companies Company Batch Search Company Search reference Search Jobs

⌘I