Scraper · LinkedIn
linkedin.company
A company's public LinkedIn profile: website, industry, size, headquarters and more. Give its page address or slug.
- Id
linkedin.company- Version
- 1
- Billed per
- request — 1 unit for a charged run
- Runs
- within one request
Start it with POST /v1/scrapers/linkedin.company/runs. How runs work is in Running a scraper; what a run costs is in Usage and units.
Inputs
The fields of input. A field that is not listed here is refused.
| Field | Type | Description |
|---|---|---|
url | string | The company page's address, e.g. https://www.linkedin.com/company/acme.Limit: at most 1000 characters. |
slug | string | The page's name in its address: acme for linkedin.com/company/acme.Limit: at most 200 characters, matches ^[^\s/?#]+$. |
- Give exactly one of
urlandslug. Both, or neither, is refused withinvalid_input.slugis the page's name in its address:acmeforlinkedin.com/company/acme. - It reads the company's public page, as a visitor who is not signed in sees it. What that page does not show — the company's description, its employees, its posts, its funding — is not in the record.
company_size,company_type,foundedandheadquartersare LinkedIn's own words, not parsed into numbers or parts.- A page LinkedIn says does not exist ends the run
failedwith the reasonnot_found, and costs nothing.
Record fields
Every record of a run has these fields. A value that is not known is null — never an empty string and never 0.
| Field | Type | Notes |
|---|---|---|
name | string | Always present. |
slug | string | Always present. |
linkedin_url | string | Always present. |
linkedin_id | string or null | null when not known. |
website | string or null | null when not known. |
industry | string or null | null when not known. |
company_size | string or null | null when not known. |
headquarters | string or null | null when not known. |
company_type | string or null | null when not known. |
founded | string or null | null when not known. |
specialties | string or null | null when not known. |
followers | integer or null | null when not known. |
logo_url | string or null | null when not known. |
fetched_at | string (date-time) | Always present. |
Example request
curl -X POST "https://api.enrichednow.com/v1/scrapers/linkedin.company/runs?wait=60" \
-H "Authorization: Bearer $ENRICHEDNOW_API_KEY" \
-H "Content-Type: application/json" \
-d '{"input":{"slug":"acme"}}'The body on its own:
{
"input": {
"slug": "acme"
}
}Example response
The run, once it has ended. A run that has not ended within wait comes back with 202 and the status queued or running.
{
"id": "run_6cce2b12aaf37a10b5e1b885",
"scraper_id": "linkedin.company",
"scraper_version": 1,
"status": "ok",
"reason": null,
"input": {
"slug": "acme"
},
"record_count": 1,
"units": 1,
"diagnostics": {
"requests": 1,
"bytes": 232779,
"wall_ms": 565,
"facts": {}
},
"created_at": "2026-11-16T20:27:29.009834Z",
"started_at": "2026-11-16T20:27:29.013803Z",
"finished_at": "2026-11-16T20:27:29.582787Z"
}Its records, from GET /v1/runs/{id}/records (the values are an illustration; the fields are the ones above):
{
"records": [
{
"name": "Acme",
"slug": "acme",
"linkedin_url": "https://www.linkedin.com/company/acme",
"linkedin_id": "2416891",
"website": "https://acme.com",
"industry": "Machinery Manufacturing",
"company_size": "1,001-5,000 employees",
"headquarters": "Houston, Texas",
"company_type": "Privately Held",
"founded": "1987",
"specialties": "Industrial pumps, valves and field service",
"followers": 48213,
"logo_url": "https://media.licdn.com/dms/image/acme-logo",
"fetched_at": "2026-11-17T09:30:01Z"
}
],
"next_cursor": null
}A run does not always end ok. Results and statuses lists every status and the reasons every scraper shares; the reasons of the LinkedIn scrapers are in their own section there.