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 creditHeaders
Get your API keyx-api-key*stringrequiredheaderYour API key, made in the dashboard.
Parameters
2handlestringoptionalqueryA member's handle: the part of their profile's link after /in/ (williamhgates). Give handle or url.
example: williamhgates
urlstringoptionalqueryA profile's link: linkedin.com/in/<handle>, with anything after it. Give handle or url.
max 300 chars
Response fields
38dataobjectThe result: one object, or a list for the endpoints that return several.
data.idstringnullableLinkedIn's id for the member: digits, written as text.
data.handlestringThe part of the profile's link after /in/.
data.urlstringThe profile's link.
data.namestringnullableThe member's name.
data.headlinestringnullableThe line under the name.
data.locationstringnullableWhere the member says they are.
data.countrystringnullableIts country, as a two-letter code (US).
data.aboutstringnullableThe About section, as far as LinkedIn shows it logged out (it may end with …).
data.picturestringnullableThe profile picture's link.
data.coverstringnullableThe cover image's link.
data.websitestringnullableThe first website on the profile.
data.followersintegernullableFollowers.
data.connectionsintegernullableConnections; 500 means 500 or more, the most LinkedIn shows logged out.
data.experiencearraynullableThe positions in its Experience section, newest first. Text LinkedIn hides logged out is null.
data.experience[].titlestringnullableThe job title.
data.experience[].companystringnullableThe company's name.
data.experience[].company_urlstringnullableThe company's LinkedIn page, when it has one.
data.experience[].startstringnullableWhen it started, as the profile shows it: a year, or a month and year (Jan 2016).
data.experience[].endstringnullableWhen it ended; null for a position held now.
data.experience[].descriptionstringnullableWhat the member wrote about it.
data.educationarraynullableThe schools in its Education section, those LinkedIn shows logged out.
data.education[].schoolstringnullableThe school's name.
data.education[].school_urlstringnullableThe school's LinkedIn page, when it has one.
data.education[].startintegernullableThe year it started.
data.education[].endintegernullableThe year it ended.
data.education[].degreestringnullableThe degree and field of study, as the member wrote them.
pageobjectnullablePaging, for the endpoints that page; null for the others.
page.next_cursorstringnullableSend it as the cursor parameter, with the same other parameters, for the next page. Null on the last page.
page.has_morebooleanoptionalWhether another page follows.
default: false
metaobjectAbout this call.
meta.platformstringThe platform: reddit, threads, tiktok or youtube.
meta.endpointstringThe endpoint's name, such as channel_videos.
meta.paramsobjectThe call's parameters, defaults included. Parameters without a value, and the cursor, are left out.
meta.request_idstringThis call's id. Quote it when you report a problem.
meta.api_versionstringThe API version that answered.
meta.fetched_atstringWhen the data was fetched from the platform (UTC).
format: date-time
meta.cachedbooleanoptionalWhether 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 }}