LinkedIn Profile API: Which Call Returns What
Pass a public LinkedIn profile URL to one call and get experience, education and follower counts back. Posts come from a second call. Here is how to choose.
A LinkedIn profile API takes a public profile URL and returns the member's background as JSON. With SocialCrawl, GET /v1/linkedin/profile/all returns experience, education, skills, recommendations received and follower counts for 5 credits. It has no posts array, so a member's posts come from a second call, profile/with-posts.
Which call returns the background, and which returns the posts?
Pick the call by the object you need. All of them take the member's public /in/ URL in url, except keyword search.
| You need | Call | Credits |
|---|---|---|
| The member card: headline, exact follower count and, where LinkedIn shows them, the About text, verification badge, current position and industry | GET /v1/linkedin/profile | 5 |
| The whole background: roles, schools, skills, received recommendations, similar profiles, exact follower count | GET /v1/linkedin/profile/all | 5 per profile |
| The background plus given recommendations | GET /v1/linkedin/profile/complete | 10 |
| Follower counts plus the member's recent posts | GET /v1/linkedin/profile/with-posts | 10 |
| Only the posts | GET /v1/linkedin/profile/posts | 5 up to 50 posts, then 2 per post |
| Posts about a keyword, from any member | GET /v1/linkedin/search/posts | 5 per page, or 1 per 5 posts with limit |
Credits are listed on the LinkedIn docs page and per endpoint in the pricing table. The profile and posts calls are separate charges, so a request for both costs both.
What does one LinkedIn profile API call return?
profile/all returns the member as an author object, the résumé under background, and LinkedIn's own count for each section under section_totals.
curl "https://www.socialcrawl.dev/v1/linkedin/profile/all?url=https://www.linkedin.com/in/jane-doe" \
-H "x-api-key: sc_your_api_key_here"A trimmed response looks like this:
{
"data": {
"author": {
"display_name": "Jane Doe",
"username": "jane-doe",
"followers": 18250,
"following": 412,
"verified": false,
"joined_at": "2014-03-11",
"ext": { "followers_approximate": false }
},
"background": {
"summary": "Head of data at an ecommerce company.",
"experiences": [
{ "title": "Head of Data", "company": "Example Co", "date": { "start": "2021", "end": "Present" } }
],
"educations": [],
"skills": [],
"recommendations": []
},
"similar_profiles": [],
"section_totals": { "experiences": 3, "educations": 2, "skills": 14, "recommendations": 1 }
}
}Handle four fields with care:
section_totalsis LinkedIn's own count per section. Long sections are cut short at the source, so the array can be shorter than the total. Count withsection_totals, not with array length.author.ext.followers_approximateis true when the follower count came back rounded.GET /v1/linkedin/profilereturns the exact integer.background.skills[].endorsements_is_flooris true when LinkedIn shows a "99+" style label, so the number is a minimum.background.given_recommendationsis not on this call.profile/completecarries the recommendations a member wrote.
Other sections arrive in the same response: Featured, certifications, honors, languages, projects, publications, volunteering, courses, patents, organizations and causes. background.interests is split into top voices, companies, groups, schools and newsletters, and similar_profiles holds up to 20 members from the "people also viewed" rail. An empty array means the member has nothing in that section.
Seven of these sections can also be read on their own: profile/languages, profile/projects, profile/patents, profile/organizations, profile/courses, profile/test-scores and profile/featured each return 20 rows a page for 5 credits, and an empty section is free. profile/skills/endorsers lists the members who endorsed one of a member's skills, 20 a page for 5 credits.
How do you get a member's posts with the profile?
Send the same URL to profile/with-posts. You get the follower and connection counts plus the member's recent posts, in the same shape as profile/posts, for 10 credits. Its background is shorter than profile/all: summary, experiences, educations and skills.
curl "https://www.socialcrawl.dev/v1/linkedin/profile/with-posts?url=https://www.linkedin.com/in/jane-doe" \
-H "x-api-key: sc_your_api_key_here"Each row in data.posts pairs a post object (text, published_at, engagement with likes, comments and shares) with a computed block. author.posts_count is null, so count data.posts instead.
For posts about a topic rather than one member, use search/posts?query=.... Without limit it returns a page of 10 posts for 5 credits. With limit from 1 to 200 it walks the pages for you, removes duplicates and charges 1 credit per 5 posts returned. limit cannot be combined with page or cursor. The LinkedIn post API guide covers keyword search in detail.
Can you look up several profiles in one request?
Yes. Pass up to 10 full profile URLs in urls, separated by commas, and profile/all returns {items, total}. You pay 5 credits for each profile returned. Duplicate URLs are collapsed before the call, and a profile that does not resolve is not charged, so a list with repeats or dead handles costs less than its length.
curl "https://www.socialcrawl.dev/v1/linkedin/profile/all?urls=https://www.linkedin.com/in/jane-doe,https://www.linkedin.com/in/john-roe" \
-H "x-api-key: sc_your_api_key_here"The response shape differs from a single lookup. With url, author and background sit directly under data. With urls, each profile is a row in data.items, so code written for one profile will not find data.author on a batch.
What happens when the member does not exist?
A missing member returns a 404 for 0 credits on profile, profile/experiences, profile/educations and profile/all. It is not an empty profile. Handle the 404 as "no such member" rather than saving a person with no experience. A batch where nothing resolves is also a free 404.
How does it compare with LinkedIn's official Profile API?
The two serve different jobs. Microsoft's Profile API is for approved developers working with a signed-in member's token. Its sample call, GET https://api.linkedin.com/v2/me, returns that member's name, headline, vanity name, id and photo. The published basic-profile fields do not list experience, education, skills or posts.
Looking up another member by public URL is not part of that sample, and Microsoft's page states that you may never store Profile API data for members other than the authenticated member. If you hold the member's token inside an approved LinkedIn app and only need those basic fields, use Microsoft's API. If you start from a public /in/ URL and want a parsed background, use profile/all.
For a wider comparison of providers, see best LinkedIn data APIs, the LinkedIn data API overview and the guide to scraping LinkedIn.
What doesn't the LinkedIn profile API do?
- It reads public profile data only. It does not read private messages, connection lists or anything behind a member's privacy settings.
profile/allhas no posts array. Posts come fromprofile/with-postsorprofile/posts.- Section totals can be higher than the arrays beside them, so long sections are not guaranteed to arrive in full.
- Contact details appear only when the member made them public.
Frequently asked questions
What is a LinkedIn profile API?
A LinkedIn profile API is a call that returns a member's profile as structured data. LinkedIn's official version returns the signed-in member's basic fields. SocialCrawl's GET /v1/linkedin/profile/all takes a public profile URL and returns experience, education, skills, received recommendations, follower counts and similar profiles for 5 credits.
Which call returns the whole LinkedIn profile?
GET /v1/linkedin/profile/all returns the whole public profile for 5 credits: the author object, the background sections and section_totals. It does not include posts or the recommendations a member wrote. For the written recommendations, use profile/complete.
Which call returns LinkedIn posts instead of the profile?
profile/with-posts returns follower counts and the member's recent posts for 10 credits, with a shorter background. profile/posts returns only the posts, for 5 credits up to 50 posts. To find posts by keyword across members, use search/posts.
Does one LinkedIn profile API call include experience and education?
Yes. profile/all returns experience and education, along with skills, certifications, languages, projects and the other profile sections. Use section_totals for the real count of each section, because long sections can be cut short at the source.
Can a LinkedIn profile API return more than one profile in one request?
Yes. Send up to 10 full profile URLs in urls on profile/all. You are charged 5 credits per profile returned. Repeated URLs are collapsed and profiles that do not resolve are not charged.
Related posts
Facebook Comment Scraper: 25 Posts, 8 Platforms, One Call
A Facebook comment scraper API that reads up to 25 posts per request across Instagram, TikTok, YouTube, Reddit, X, Threads and LinkedIn. Billed per page.
Influencer Search Tool API: Rank by Median Views
An influencer search tool needs a measuring engine underneath. See the API call that finds creators by median views, quotes the cost free, and caps the spend.
TikTok Email Finder API: Creator Emails via One Parameter
Add include=contacts to a TikTok or YouTube profile call and get the business email a creator published, with its source and a lookup state you can retry.
