List companies
Search and filter company records. Costs one credit per returned record.
Request
- Base URL: https://api.datahyena.com
- URL: https://api.datahyena.com/v1/companies
- Auth: API key in header X-API-Key
Query parameters
Opaque pagination cursor returned as pagination.nextCursor.
Return companies created or updated on or after this date (YYYY-MM-DD). ISO-8601 timestamps are also accepted.
Maximum records to return.
Keyword search over company name, domain, and description.
Company domain. Matches the primary domain or any domain the company has redirected from; a full URL is accepted and reduced to its domain.
Also return pagination.total, the number of records matching these filters across all pages. Costs no credits; adds a count query, so ask for it when you need the list size.
Headquarters country codes (OR). Repeat the query key for multiple values. Use unknown to match companies with no country on file.
[ "US", "GB" ]
Company industry groups (OR). Repeat the query key for multiple values. Values are the LinkedIn industry labels listed here, matched case-insensitively; older LinkedIn names (e.g. Computer Software) and common short forms (e.g. software) map to the current label. Use unknown to match companies with no industry on file.
[ "Software Development", "Financial Services" ]
NAICS 2022 code. Matches the code and everything beneath it, so "51" returns 5132 and 5173 as well. Sector ranges work too: "31-33" returns all manufacturing. Pass "unknown" for companies we could not classify.
LinkedIn employee count buckets (OR). Repeat the query key for multiple values. Use unknown to match companies with no headcount on file.
[ "11-50", "51-200" ]
Minimum founded year.
Maximum founded year.
Sort order. "prominence" ranks by how notable a company is, from recent funding size and recency, acquisition activity and known people. Default "recent" is the delta-sync order and is what you want when paging the whole corpus.
Direction for the prominence sort. Ignored when sort is "recent", which is always ascending so a delta sync never misses a row.
Only companies that raised at least this much (USD, not cents) in the last 12 months. Refreshed nightly.
Only companies with at least this many current known people on record.
Only companies where a current founder is on record.
Response
Request accepted. The number of records returned may be lower than limit when credits or data run out.
Example response
{
"success": true,
"data": [
{
"name": "Acme AI",
"naicsLevel": 4,
"hqCountry": {
"code": "US",
"name": "United States"
},
"industrySubTags": [
"Artificial Intelligence",
"Sales Automation"
],
"verticals": [
"ai",
"fintech"
]
}
],
"pagination": {
"hasMore": true,
"total": 1284
},
"meta": {
"endpoint": "funding_events.list",
"creditsUsed": 20,
"notice": "No events on record for this company."
}
}Changes
No recorded changes to this operation across all 1 revision of this API.