InsightSocial
GET /v1/linkedin/company

LinkedIn Company API

Returns a LinkedIn company page: company name, description, follower count, headquarters location, website, and logo.

50–80 credits, metered · single call · failed calls free · 10 free calls to start

curl "https://api.insightsocial.app/v1/linkedin/company?url=https%3A%2F%2Fwww.linkedin.com%2Fcompany%2Fmicrosoft%2F" \
-H "x-api-key: $INSIGHTSOCIAL_API_KEY"
200 OKJSON
{
"success": true,
"platform": "linkedin",
"endpoint": "/v1/linkedin/company",
"schema_version": "2",
"data": {
"author": {
"id": "<string>",
"username": "<string | null>",
"display_name": "<string | null>",
"avatar_url": "<string | null>",
"bio": "<string | null>",
"verified": "<boolean | null>",
"followers": "<integer | null>",
"followers_approximate": "<boolean | null>",
"following": "<integer | null>",
"posts_count": "<integer | null>",
"likes_count": "<integer | null>",
"url": "<string | null>",
"location": "<string | null>",
"external_url": "<string | null>",
"private": "<boolean | null>",
"joined_at": "<string | null>",
"last_post_at": "<string | null>",
"ext": "<object | null>"
}
},
"unavailable": [],
"credits_used": "<integer>"
}

When to use it

Use it to look up a company by its page URL, and to get the numeric company_id that the other company endpoints need.

Parameters

Query parameters for GET /v1/linkedin/company. Send your key in the x-api-key header.

NameRequiredDescription
urlYesFull URL of the LinkedIn company page
includeNoSet 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.
max_age_sNoThe oldest cached copy you accept, in seconds. A copy that old or younger is served, with its age in age_s and the X-Cache-Age header. Without it a copy up to 900 seconds old is served; this endpoint keeps copies for 3600 seconds, so a value up to 3600 can save a call. A lower value fetches fresh (billed) when the copy is older, and 0 always fetches live, like Cache-Control: no-cache.

Response fields

The same unified schema every typed endpoint returns, so code written for LinkedIn reads the other platforms too. A field the platform did not provide is null and listed in unavailable.

FieldTypeNotes
idstringAn identifier, always a string. Never parse it as a number: several platforms use ids above 2^53.
usernamestring | null
display_namestring | null
avatar_urlstring | null
biostring | null
verifiedboolean | null
followersinteger | nullA count. null when the platform does not expose it; 0 only when it is really zero.
followers_approximateboolean | null
followinginteger | nullA count. null when the platform does not expose it; 0 only when it is really zero.
posts_countinteger | nullA count. null when the platform does not expose it; 0 only when it is really zero.
likes_countinteger | nullA count. null when the platform does not expose it; 0 only when it is really zero.
urlstring | null
locationstring | null
external_urlstring | null
privateboolean | null
joined_atstring | nullISO-8601 timestamp in UTC, ending in Z.
last_post_atstring | nullISO-8601 timestamp in UTC, ending in Z.
extobject | nullPlatform-specific fields, snake_case.

Every field, error and example is in the LinkedIn Company API reference.

How much does the LinkedIn Company API cost?

Metered: 50–80 credits a call. The ceiling is reserved when the call starts and you are charged what it actually read.

  • Failed calls are free

    A call that errors or finds nothing costs 0 credits.

  • Know the price first

    Add dry_run=1 and the response quotes the call without making it. Nothing is charged.

  • One balance

    API calls and Chrome extension exports share the same credits, on the free plan too.

LinkedIn Company API: frequently asked questions

Send GET /v1/linkedin/company with the url parameter and your key in the x-api-key header. Returns a LinkedIn company page: company name, description, follower count, headquarters location, website, and logo.