Social Fetch
LinkedIn

Get LinkedIn company page

Looks up a LinkedIn company page by public URL. Availability is indicated in `data.lookupStatus` as `found` or `not_found`.

Operation

GET/v1/linkedin/companies
Cost: 1 credit

Headers

x-api-keystringrequired(header)

API key (`sfk_...`)

Parameters

urlstringrequired(query)

LinkedIn company page URL for this lookup.

min 1 chars · max 4096 chars

Response fields

data
objectrequired

Endpoint-specific response payload.

datalookupStatus
stringrequired

Whether the company page was found.

one of: found, not_found

datacompany
objectrequirednullable

Company details when available.

datacompanyplatform
stringrequired

Social platform for this record.

one of: linkedin

datacompanyid
stringrequired

Company identifier as a string.

min 1 chars

datacompanyhandle
string

Company vanity handle when available.

min 1 chars

datacompanyname
stringrequired

Company display name.

min 1 chars

datacompanycompanyUrl
stringrequired

Canonical public LinkedIn company page URL.

min 1 chars

datacompanydescription
stringrequirednullable

Company description text when available.

datacompanyslogan
stringnullable

Company tagline when available.

datacompanywebsite
stringrequirednullable

Primary external website when available.

datacompanylogoUrl
stringrequirednullable

Company logo image URL when available.

datacompanycoverImageUrl
stringrequirednullable

Cover image URL when available.

datacompanyindustry
stringrequirednullable

Industry label when available.

datacompanycompanyType
stringrequirednullable

Company type label when available.

datacompanyfoundedYear
integernullable

Founded year when available.

datacompanyheadquarters
stringrequirednullable

Headquarters label when available.

datacompanyemployeeRange
stringrequirednullable

Reported employee range label when available.

datacompanyspecialties
arrayrequired

Specialty tags when available.

datacompanyspecialties[]
string

min 1 chars

datacompanylocation
objectrequirednullable

Structured location when available.

datacompanylocationcity
stringrequirednullable

City label when available.

datacompanylocationstate
stringrequirednullable

State or region label when available.

datacompanylocationcountry
stringrequirednullable

Country code or label when available.

datametrics
objectrequirednullable

Company metrics when available.

datametricsfollowers
integerrequired

Follower count for the company page.

≥ 0

datametricsemployees
integerrequired

Reported employee count for the company.

≥ 0

datasimilarCompanies
arrayrequired

Similar company suggestions when available.

datasimilarCompanies[]name
stringrequired

Similar company display name.

min 1 chars

datasimilarCompanies[]companyUrl
stringrequired

Public LinkedIn company page URL.

min 1 chars

datasimilarCompanies[]imageUrl
stringrequirednullable

Logo image URL when available.

datafeaturedEmployees
arrayrequired

Featured employees shown on the company page when available.

datafeaturedEmployees[]name
stringrequired

Person name.

min 1 chars

datafeaturedEmployees[]title
stringrequirednullable

Title or headline shown on the company page.

datafeaturedEmployees[]profileUrl
stringrequired

LinkedIn profile URL.

min 1 chars

datafeaturedEmployees[]imageUrl
stringrequirednullable

Profile image URL when available.

datarecentPosts
arrayrequired

Recent posts from the company page when available.

datarecentPosts[]id
string

Post identifier when available.

datarecentPosts[]postUrl
stringrequired

Public URL for the post.

min 1 chars

datarecentPosts[]publishedAt
stringnullable

Publication time in ISO-8601 when available.

datarecentPosts[]text
stringnullable

Post text when available.

datafunding
objectrequirednullable

Funding summary when available.

datafundingnumberOfRounds
integerrequirednullable

Reported number of funding rounds when available.

≥ 0

datafundinglastRound
objectrequirednullable

Most recent funding round when available.

datafundinglastRoundtype
stringrequirednullable

Funding round label when available.

datafundinglastRounddate
stringrequirednullable

Round date text or ISO string when available.

datafundinglastRoundamount
stringrequirednullable

Round amount label when available.

datafundinginvestors
arrayrequired

Investors associated with funding history when available.

datafundinginvestors[]name
stringrequired

Investor name.

min 1 chars

datafundinginvestors[]crunchbaseUrl
stringrequirednullable

Crunchbase organization URL when available.

datafundinginvestors[]imageUrl
stringrequirednullable

Investor logo URL when available.

meta
objectrequired

Metadata describing the request and billing outcome.

metarequestId
stringrequired

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integerrequired

Credits charged for this request.

≥ 0

metaversion
stringrequired

Public API version that served the response.

one of: v1

Code example

Responses

Lookup result. Check `data.lookupStatus` for `found` or `not_found`.

Error codes

bad_requestinsufficient_creditsinternal_errorlookup_failedtemporarily_unavailableunauthorized

On this page