LinkedIn

Profile

A member's profile: name, headline, location, about, followers and connections, experience and education. Text LinkedIn hides from logged-out visitors (it shows asterisks in its place) is null, and a school it hides is left out.

GET/v1/linkedin/profile1 credit
x-api-key*stringrequiredheader

Your API key, made in the dashboard.

Parameters

2
handlestringoptionalquery

A member's handle: the part of their profile's link after /in/ (williamhgates). Give handle or url.

example: williamhgates

urlstringoptionalquery

A profile's link: linkedin.com/in/<handle>, with anything after it. Give handle or url.

max 300 chars

Response fields

38
dataobject

The result: one object, or a list for the endpoints that return several.

data.idstringnullable

LinkedIn's id for the member: digits, written as text.

data.handlestring

The part of the profile's link after /in/.

data.urlstring

The profile's link.

data.namestringnullable

The member's name.

data.headlinestringnullable

The line under the name.

data.locationstringnullable

Where the member says they are.

data.countrystringnullable

Its country, as a two-letter code (US).

data.aboutstringnullable

The About section, as far as LinkedIn shows it logged out (it may end with …).

data.picturestringnullable

The profile picture's link.

data.coverstringnullable

The cover image's link.

data.websitestringnullable

The first website on the profile.

data.followersintegernullable

Followers.

data.connectionsintegernullable

Connections; 500 means 500 or more, the most LinkedIn shows logged out.

data.experiencearraynullable

The positions in its Experience section, newest first. Text LinkedIn hides logged out is null.

data.experience[].titlestringnullable

The job title.

data.experience[].companystringnullable

The company's name.

data.experience[].company_urlstringnullable

The company's LinkedIn page, when it has one.

data.experience[].startstringnullable

When it started, as the profile shows it: a year, or a month and year (Jan 2016).

data.experience[].endstringnullable

When it ended; null for a position held now.

data.experience[].descriptionstringnullable

What the member wrote about it.

data.educationarraynullable

The schools in its Education section, those LinkedIn shows logged out.

data.education[].schoolstringnullable

The school's name.

data.education[].school_urlstringnullable

The school's LinkedIn page, when it has one.

data.education[].startintegernullable

The year it started.

data.education[].endintegernullable

The year it ended.

data.education[].degreestringnullable

The degree and field of study, as the member wrote them.

pageobjectnullable

Paging, for the endpoints that page; null for the others.

page.next_cursorstringnullable

Send it as the cursor parameter, with the same other parameters, for the next page. Null on the last page.

page.has_morebooleanoptional

Whether another page follows.

default: false

metaobject

About this call.

meta.platformstring

The platform: reddit, threads, tiktok or youtube.

meta.endpointstring

The endpoint's name, such as channel_videos.

meta.paramsobject

The call's parameters, defaults included. Parameters without a value, and the cursor, are left out.

meta.request_idstring

This call's id. Quote it when you report a problem.

meta.api_versionstring

The API version that answered.

meta.fetched_atstring

When the data was fetched from the platform (UTC).

format: date-time

meta.cachedbooleanoptional

Whether it came from our cache; fetched_at says how old it is.

default: false

Code example

curl -X GET 'https://api.socialparse.dev/v1/linkedin/profile?handle=williamhgates' \  -H 'x-api-key: YOUR_API_KEY'

Responses

Successful Response

{  "data": {    "id": "string",    "handle": "string",    "url": "string",    "name": "string",    "headline": "string",    "location": "string",    "country": "string",    "about": "string",    "picture": "string",    "cover": "string",    "website": "string",    "followers": 0,    "connections": 0,    "experience": [      {        "title": "string",        "company": "string",        "company_url": "string",        "start": "string",        "end": "string",        "description": "string"      }    ],    "education": [      {        "school": "string",        "school_url": "string",        "start": 0,        "end": 0,        "degree": "string"      }    ]  },  "page": {    "next_cursor": "string",    "has_more": false  },  "meta": {    "platform": "string",    "endpoint": "string",    "params": {      "property1": "string",      "property2": "string"    },    "request_id": "string",    "api_version": "string",    "fetched_at": "2019-08-24T14:15:22Z",    "cached": false  }}