GET

/api/v1/companies/universal-name-to-id

10 credits

Resolve a company slug (the part after linkedin.com/company/) to its stable org_ id — the dataset id used by /companies/info. For the live company endpoints (posts, similar, affiliated, insights) use /api/v1/companies/entity-id instead; the two ids are not interchangeable. Returns the FULL company record (identical to /companies/info) — read `data.id`.

Try in Playground

Parameters

Name	Type	Required	Description
slug	string	yes	Company public slug — the part after linkedin.com/company/. (e.g. `microsoft`)

Example request

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

Example response

// full company record — identical payload to /companies/info; read data.id
{
  "success": true,
  "statusCode": 200,
  "message": "Company retrieved successfully",
  "errors": null,
  "data": {
    "id": "org_jb3e59e3q21b8",
    "name": "Microsoft",
    "slug": "microsoft",
    "url": "https://www.linkedin.com/company/microsoft/",
    "description": "Every company has a mission. What's ours? To empower every person and every organization to achieve more...",
    "type": "Computer Software",
    "logo_url": "https://media.licdn.com/dms/image/...",
    "headcount": 233255,
    "headcount_range": "10,001+ employees",
    "follower_count": 28718941,
    "industries": ["Computer Software"],
    "industries_v2": ["Software Development"],
    "specialities": ["Cloud Computing", "AI", "Productivity"],
    "website": "https://news.microsoft.com/",
    "hq_city": "Redmond",
    "hq_country_code": "US",
    "headquarter": { "city": "Redmond", "line1": "1 Microsoft Way", "countryCode": "US", "postalCode": "98052", "geographicArea": "Washington", "headquarter": true }
  }
}

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 →