Search Companies
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.
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.
Authorizations
API key passed as a Bearer token in the Authorization header.
Headers
API version to use. This endpoint currently requires 2025-11-01.
2025-11-01 "2025-11-01"
Body
Search filters, pagination, sorting, and field selection
Request body for searching the company database using indexed fields.
Search filters. Use a single SearchCondition or an and/or SearchConditionGroup.
- Option 1
- Option 2
{
"field": "basic_info.primary_domain",
"type": "=",
"value": "hubspot.com"
}
Pagination cursor from a previous response's next_cursor. Omit on the first page.
"H4sIAJj5zGkC_xXMMQ7CMAxA0..."
1 <= x <= 1000Sort directives applied to matched companies in order.
[
{
"field": "headcount.total",
"order": "desc"
}
]
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.
["basic_info", "headcount", "funding"]

