GET

/api/v1/companies/insights

10 credits

Employee-count total + distribution buckets (by department, seniority, location). Keyed by the numeric organization id: pass `slug` and Zooq resolves it for you at no extra credit cost, or pass `id` from /api/v1/companies/entity-id to skip the lookup.

Try in Playground

Parameters

Name	Type	Required	Description
slug	string	no	Company public slug — the part after linkedin.com/company/ — or the full company URL. Resolved to `id` automatically at no extra credit cost. Any company identifier is accepted here and sorted by format (slug, URL, numeric id, org_ id). Provide `id` OR `slug`; `slug` is the simplest. (e.g. `microsoft`)
id	string	no	Numeric organization id from companies_entity_id; the urn:li:organization: form is accepted. An org_ id (dataset namespace, from companies_info) or a slug placed here is recognized and translated automatically. Provide `id` OR `slug`. (e.g. `1035`)

Example request

curl -H "X-API-Key: zq_…" \
  "https://zooq.dev/api/v1/companies/insights?slug=microsoft&id=1035"

Example response

// live-verified shape — grouped buckets, not the old distribution object
{
  "success": true,
  "statusCode": 200,
  "message": "Data retrieved successfully",
  "errors": null,
  "data": {
    "totalResultCount": 233255,
    "groups": [
      { "title": "What they do", "group": [ { "name": "Engineering", "count": 78000, "id": "..." } ] },
      { "title": "Where they live", "group": [ { "name": "United States", "count": 120000, "id": "..." } ] }
    ]
  }
}

Successful responses are wrapped in the standard envelope. The data field carries the actual payload; errors is null on success.

Want to try this endpoint?

300 free credits on signup, no card required. That covers 30 calls.

Get an API key →