Company API - Superdata Docs

Get a company

GET https://api.superdata.so/v1/company

The Company API returns structured public organization data such as identity, industry, headcount, locations, and specialties. Every request requires a Bearer API key.

Query parameters

Provide at least one identifier. If you send more than one, Superdata uses url, then company.id, then org_id.

Parameter	Type	Default	Description
`url`	URL	—	Public LinkedIn `/company/` or `/school/` URL
`company.id`	positive integer	—	Numeric company ID accepted by Superdata; the dot is part of the parameter name
`org_id`	positive integer	—	LinkedIn company or school ID
`strategy`	enum	`cached`	`cached`, `fetch`, `strict`, or `besteffort`
`maxage`	positive integer	—	Maximum cache age in seconds for `strict` or `besteffort`

Example request

curl --request GET \
  --url 'https://api.superdata.so/v1/company' \
  --get \
  --data-urlencode 'url=https://www.linkedin.com/company/microsoft' \
  --data-urlencode 'strategy=cached' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Accept: application/json'

Example response

Provider fields can vary by organization. The data object below is representative; fields may be absent or null when they are not publicly available.

{
  "request_id": "req_01J...",
  "data": {
    "name": "Microsoft",
    "linkedin_url": "https://www.linkedin.com/company/microsoft",
    "industry": "Software Development",
    "website": "https://www.microsoft.com",
    "employee_count": 10000,
    "locations": [],
    "specialties": []
  },
  "meta": {
    "source": "linkedin",
    "cached": true,
    "credits_used": 1
  }
}

Cache strategies

Strategy	Behavior
`cached`	Return an available fresh cached result without fetching the source
`fetch`	Fetch a fresh result from the source
`strict`	Use cache only when it is newer than `maxage`; otherwise fetch fresh
`besteffort`	Use a sufficiently recent cache, otherwise fetch and fall back to stale cache if the fetch fails

See errors and limits for status codes and retry guidance.