API Reference
Companies
Company directory records with search and firmographic filters.
Search and filter company records. Costs one credit per returned record.
Authorization
apiKey X-API-Key<token>
In: header
Query Parameters
cursor?string
Opaque pagination cursor returned as pagination.nextCursor.
since?string
Return companies created or updated after this ISO-8601 timestamp.
limit?number
Maximum records to return.
Default
20Range
1 <= value <= 100search?string
Keyword search over company name, domain, and description.
domain?string
Exact company domain.
country?string
Headquarters country code.
industryGroup?string
Company industry group.
employeeCountBucket?string
LinkedIn employee count bucket.
foundedYearMin?number
Minimum founded year.
Range
0 <= valuefoundedYearMax?number
Maximum founded year.
Range
0 <= valueResponse Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/companies"{ "success": true, "data": [ { "id": "019e8a3c-2b10-7c44-8a1f-9d8e7c6b5a40", "name": "Acme AI", "domain": "acme.ai", "description": "AI workflow automation for enterprise revenue teams.", "linkedinHandle": "acme-ai", "linkedinUrl": "https://www.linkedin.com/company/acme-ai", "linkedinGeoId": "90000084", "linkedinIndustryId": "4", "hqCity": "San Francisco", "hqCountry": { "code": "US", "name": "United States" }, "industryGroup": "Software Development", "industrySubTags": [ "Artificial Intelligence", "Sales Automation" ], "employeeCountBucket": "51-200", "foundedYear": 2021, "businessModel": "B2B SaaS", "createdAt": "2026-05-01T12:00:00.000Z", "updatedAt": "2026-05-30T12:00:00.000Z" } ], "pagination": { "hasMore": true, "nextCursor": "eyJpZCI6IjAxOWU4YTNjLTJiMTAtN2M0NC04YTFmLTlkOGU3YzZiNWE0MCJ9" }, "meta": { "endpoint": "funding_events.list", "creditsUsed": 20, "creditsRemaining": 980 }}{ "success": false, "error": { "code": "INVALID_INPUT", "message": "limit must not be greater than 100" }, "meta": { "requestId": "019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c" }}{ "success": false, "error": { "code": "UNAUTHORIZED", "message": "Missing or invalid API key." }, "meta": { "requestId": "019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c" }}{ "success": false, "error": { "code": "PAYMENT_REQUIRED", "message": "Workspace has no credits remaining. Top up to continue." }, "meta": { "requestId": "019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c" }}{ "success": false, "error": { "code": "FORBIDDEN", "message": "Request blocked by abuse prevention policy." }, "meta": { "requestId": "019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c" }}{ "success": false, "error": { "code": "TOO_MANY_REQUESTS", "message": "Rate limit exceeded for this workspace and plan." }, "meta": { "requestId": "019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c" }}