> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superdata.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Company API

> Retrieve a LinkedIn company or school by URL or numeric identifier.

## Get a company

```http theme={null}
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](/reference/authentication).

## 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

```bash theme={null}
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.

```json theme={null}
{
  "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](/reference/errors-and-limits) for status codes and retry guidance.