Social Fetch
LinkedIn

Get LinkedIn profiles

Get LinkedIn profiles by URL or handle.

GET/v1/linkedin/profiles
x-api-key*stringheader

API key (`sfk_...`)

Parameters
1
url*arrayquery

LinkedIn profile URL.

Response fields
110

Endpoint-specific response payload.

Per-URL profile lookup results.

dataresults[]url
string

Requested profile URL echoed for this result.

min 1 chars

dataresults[]lookupStatus
string

Whether this profile was resolved.

one of: found, not_found, error

Error details when `lookupStatus` is `error`.

dataresults[]errormessage
string

Short customer-safe reason this profile could not be returned.

min 1 chars

Profile details when available.

dataresults[]profileplatform
string

Social platform for this profile.

one of: linkedin

dataresults[]profilehandle
string

LinkedIn public profile handle without the leading @.

dataresults[]profilenumericId
stringnullable

LinkedIn numeric profile id when available.

dataresults[]profiledisplayName
stringnullable

Public display name on the profile when available.

dataresults[]profilefirstName
stringnullable

First name when available.

dataresults[]profilelastName
stringnullable

Last name when available.

dataresults[]profileheadline
stringnullable

Profile headline or position line when available.

dataresults[]profilebio
stringnullable

Profile summary or about text when available.

dataresults[]profileavatarUrl
stringnullable

Best available square avatar image URL when available.

dataresults[]profilebannerUrl
stringnullable

Profile banner image URL when available.

dataresults[]profileprofileUrl
string

Canonical public LinkedIn profile URL for this handle.

min 1 chars

dataresults[]profilelocation
stringnullable

Location label when available.

dataresults[]profilecity
stringnullable

City label when available.

dataresults[]profilecountryCode
stringnullable

ISO country code when available.

dataresults[]profileinfluencer
booleannullable

Whether LinkedIn marks this profile as an influencer.

dataresults[]profilememorialized
booleannullable

Whether this is a memorialized account.

dataresults[]profiledefaultAvatar
booleannullable

Whether the avatar is LinkedIn's default placeholder.

Current company details when available.

dataresults[]profilecurrentCompanyname
stringnullable

Current company name when available.

dataresults[]profilecurrentCompanycompanyId
stringnullable

LinkedIn company slug when available.

dataresults[]profilecurrentCompanytitle
stringnullable

Current role title at the company when available.

dataresults[]profilecurrentCompanyurl
stringnullable

LinkedIn company URL when available.

dataresults[]profilecurrentCompanylocation
stringnullable

Current company location label when available.

External websites linked from the profile.

dataresults[]profilewebsites[]title
stringnullable

Website label when available.

dataresults[]profilewebsites[]url
string

External website URL.

min 1 chars

Work experience entries when available.

dataresults[]profileexperience[]title
stringnullable

Role title when available.

dataresults[]profileexperience[]company
stringnullable

Company name when available.

dataresults[]profileexperience[]companyLogoUrl
stringnullable

Company logo URL when available.

dataresults[]profileexperience[]description
stringnullable

Role description when available.

dataresults[]profileexperience[]startDate
stringnullable

Start date label when available.

dataresults[]profileexperience[]endDate
stringnullable

End date label when available.

Education entries when available.

dataresults[]profileeducation[]title
stringnullable

School or program name when available.

dataresults[]profileeducation[]url
stringnullable

School URL when available.

dataresults[]profileeducation[]startYear
stringnullable

Start year when available.

dataresults[]profileeducation[]endYear
stringnullable

End year when available.

dataresults[]profileeducation[]description
stringnullable

Education description when available.

Language entries when available.

dataresults[]profilelanguages[]name
string

Language name.

min 1 chars

dataresults[]profilelanguages[]proficiency
stringnullable

Proficiency label when available.

Organization memberships when available.

dataresults[]profileorganizations[]title
string

Organization name.

min 1 chars

dataresults[]profileorganizations[]membershipType
stringnullable

Membership type or role when available.

dataresults[]profileorganizations[]startDate
stringnullable

Start date when available.

dataresults[]profileorganizations[]endDate
stringnullable

End date when available.

Publication entries when available.

dataresults[]profilepublications[]title
string

Publication title.

min 1 chars

dataresults[]profilepublications[]publisher
stringnullable

Publisher when available.

dataresults[]profilepublications[]date
stringnullable

Publication date when available.

Project entries when available.

dataresults[]profileprojects[]title
string

Project title.

min 1 chars

dataresults[]profileprojects[]startDate
stringnullable

Start date when available.

dataresults[]profileprojects[]description
stringnullable

Project description when available.

Honors and awards text entries when available.

dataresults[]profilehonorsAndAwards[]
stringoptional

Recommendation text entries when available.

dataresults[]profilerecommendations[]
stringoptional

Certification entries when available.

dataresults[]profilecertifications[]title
string

Entry title.

min 1 chars

dataresults[]profilecertifications[]subtitle
stringnullable

Secondary label when available.

dataresults[]profilecertifications[]meta
stringnullable

Additional metadata when available.

Course entries when available.

dataresults[]profilecourses[]title
string

Entry title.

min 1 chars

dataresults[]profilecourses[]subtitle
stringnullable

Secondary label when available.

dataresults[]profilecourses[]meta
stringnullable

Additional metadata when available.

Volunteer experience entries when available.

dataresults[]profilevolunteerExperience[]title
string

Entry title.

min 1 chars

dataresults[]profilevolunteerExperience[]subtitle
stringnullable

Secondary label when available.

dataresults[]profilevolunteerExperience[]meta
stringnullable

Additional metadata when available.

Profile metrics when available.

dataresults[]metricsfollowers
integernullable

Follower count when available.

≥ 0

dataresults[]metricsconnections
integernullable

Connection count when available.

≥ 0

dataresults[]metricsrecommendationsCount
integernullable

Recommendation count when available.

≥ 0

Recent public activities from the profile when available.

dataresults[]activity[]id
string

Stable activity id for this item when available.

min 1 chars

dataresults[]activity[]url
string

Public URL for this activity.

min 1 chars

dataresults[]activity[]title
stringnullable

Primary text or headline for the activity.

dataresults[]activity[]interactionType
stringnullable

Interaction label when available.

dataresults[]activity[]thumbnailUrl
stringnullable

Thumbnail image URL when available.

dataresults[]activity[]publishedAt
stringnullable

Publication timestamp in ISO-8601 format when provided by the source.

Authored posts from the profile when available.

dataresults[]posts[]id
string

Stable post id when available.

min 1 chars

dataresults[]posts[]url
string

Public URL for this authored post.

min 1 chars

dataresults[]posts[]title
stringnullable

Post title when available.

dataresults[]posts[]excerpt
stringnullable

Post excerpt when available.

dataresults[]posts[]publishedAt
stringnullable

Publication timestamp when available.

dataresults[]posts[]interaction
stringnullable

Engagement summary when available.

Related profile suggestions when available.

dataresults[]relatedProfiles[]url
string

Related profile URL.

min 1 chars

dataresults[]relatedProfiles[]name
string

Related profile display name.

min 1 chars

dataresults[]relatedProfiles[]headline
stringnullable

Related profile headline when available.

dataresults[]relatedProfiles[]location
stringnullable

Related profile location when available.

Summary counts for the profile batch.

datasummaryrequestedUrls
integer

Number of profile URLs requested in this batch.

≥ 0

datasummaryfound
integer

Number of profiles successfully found.

≥ 0

datasummarynotFound
integer

Number of profiles that were not found.

≥ 0

datasummaryerrored
integer

Number of profiles that failed to resolve.

≥ 0

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/linkedin/profiles?url=https://www.linkedin.com/in/marclouvion" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Batch lookup results. Inspect each `data.results[].lookupStatus` for `found`, `not_found`, or `error`.

On this page

No Headings