# LinkedIn Company API (https://www.socialcrawl.dev/platforms/linkedin/company)

> Returns public information about a LinkedIn company page. Canonical fields carry the identity and reach: `author.id` (the numeric company_id the other `/company/*` endpoints take), `username`, `display_name`, `bio` (the company description), `avatar_url` (logo), `followers`, `location` (flattened HQ), and `verified`. The complete **About tab** rides in `author.ext`: `website`, `public_phone` (the phone number the page lists), `employee_count` and `employee_count_range`, `founded_year`, `specialities[]`, `industries[]`, `headquarters` (structured `{country, city, geographic_area, line1, line2, postal_code}`), `locations[]` (every office LinkedIn lists, with lat/long), `hashtags[]`, `cover_url`, and `page_active`. Fields a page has not filled in come back null rather than omitted, so `founded_year` is null on a company that never set a founding date and `public_phone` is null on a page that lists no phone. Add `include=about` for the two About-tab fields the plain call does not reliably carry: `company_type` (LinkedIn's "Type", for example "Public Company" or "Privately Held") and `tagline` (the page's one-line slogan). The plain call sometimes carries them too, when a backup source answered, so do not rely on it for them. `funding` is mapped too, but LinkedIn returned an empty funding block for every company measured on 2026-08-11, so do not depend on it.

TL;DR: `GET /v1/linkedin/company` costs 5 credits for the company page. include=about holds 3 more and keeps them only when it fills the company type or tagline the plain call lacked, refunding them otherwise, so a call with include=about is at most 8 credits; when the plain call already carried both, it settles at 5. Company lookups are cached. and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `url` | yes | Full URL of the LinkedIn company page |
| `include` | no | Set to `about` (one token only) to add the page's company type (`author.ext.company_type`, for example "Public Company") and tagline (`author.ext.tagline`) when the plain call returned without them. 3 extra credits, kept only when one of the two comes back; a page that sets neither is refunded. Adds about 7 to 18 seconds when a lookup runs; read `data.hydration` for the credits held and kept and the time. (about) |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/linkedin/company" \
  --data-urlencode "url=https://www.linkedin.com/company/microsoft/" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I scrape a LinkedIn company page with an API?

Send a GET request to /v1/linkedin/company with the full LinkedIn company URL (e.g. https://www.linkedin.com/company/microsoft/) in the url parameter. The response includes company name, description, industry, employee count, HQ location, website, and logo URL.

### What fields does the LinkedIn Company API return?

Company name, tagline, description, industry, company size range, employee count, founded year, headquarters address, specialties, website URL, and logo URL. Every response uses SocialCrawl's unified schema, so you can reuse the same integration across platforms.

### How much does the LinkedIn Company API cost?

Each company lookup costs 5 credits on the advanced tier. New accounts get 100 credits free with no credit card. That's 20 company page scrapes before you ever need to upgrade.

### Can I use the LinkedIn Company API for B2B enrichment?

Yes, B2B enrichment is the most common use case. Pass a LinkedIn company URL from your CRM, and SocialCrawl returns normalized firmographic data (industry, size, HQ, website) ready for lead scoring, routing, or ICP analysis.

### Is scraping LinkedIn company pages legal?

SocialCrawl reads only public LinkedIn company pages that any logged-out visitor can see. You remain responsible for complying with LinkedIn's User Agreement and applicable data-protection law (GDPR, CCPA) for your use case and jurisdiction.

### Can I pull multiple LinkedIn companies in bulk?

Yes. Run concurrent GET requests to /v1/linkedin/company with different url parameters. SocialCrawl has no per-minute rate limits: you pay per request in credits, so you can saturate bandwidth as fast as your client can send requests.

See the full LinkedIn API: https://www.socialcrawl.dev/platforms/linkedin

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to get LinkedIn company data with SocialCrawl
- What B2B fields does the LinkedIn Company API return
- Best LinkedIn company scraper for firmographic enrichment