Sign in

v1

latestOpenAPI 3.0.32026-07-222085264.6 KB
Company APIs
Search APIs

Search companies with indexed fields only

Search the Crustdata company database using filter conditions. Supports complex AND/OR filter logic, cursor-based pagination, sorting, and field selection. Only indexed fields are searchable; use /company/enrich for non-indexed fields like news, people, or web_traffic. <Note> Default rate-limit is 30 requests per minute. Send an email to gtm@crustdata.co to discuss higher limits if needed for your use case. </Note>

post/company/search

Headers

x-api-version'2025-11-01' required
Example:2025-11-01

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

Request body

cursorstring

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

limitinteger
fieldsstring[]

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 request

{
  "filters": {
    "field": "basic_info.primary_domain",
    "type": "=",
    "value": "hubspot.com"
  },
  "fields": [
    "basic_info",
    "headcount",
    "funding"
  ],
  "limit": 1
}

Response

Companies matching the search criteria

next_cursorstring nullable
total_countinteger nullable
queryobject

Example response

{
  "companies": [],
  "next_cursor": null,
  "total_count": 0
}