100 free credits. No credit card required.Start building
Logo
Back to blog

LinkedIn Profile API: Which Call Returns What

··9 min read

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.

LinkedIn Profile API: Which Call Returns What

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 needCallCredits
The member card: headline, exact follower count and, where LinkedIn shows them, the About text, verification badge, current position and industryGET /v1/linkedin/profile5
The whole background: roles, schools, skills, received recommendations, similar profiles, exact follower countGET /v1/linkedin/profile/all5 per profile
The background plus given recommendationsGET /v1/linkedin/profile/complete10
Follower counts plus the member's recent postsGET /v1/linkedin/profile/with-posts10
Only the postsGET /v1/linkedin/profile/posts5 up to 50 posts, then 2 per post
Posts about a keyword, from any memberGET /v1/linkedin/search/posts5 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.

bash
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:

json
{
  "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_totals is LinkedIn's own count per section. Long sections are cut short at the source, so the array can be shorter than the total. Count with section_totals, not with array length.
  • author.ext.followers_approximate is true when the follower count came back rounded. GET /v1/linkedin/profile returns the exact integer.
  • background.skills[].endorsements_is_floor is true when LinkedIn shows a "99+" style label, so the number is a minimum.
  • background.given_recommendations is not on this call. profile/complete carries 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.

bash
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.

A tall stack of post cards in front of a thin resume folder, showing that the LinkedIn profile call returns the background and the posts call returns the posts.

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.

bash
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/all has no posts array. Posts come from profile/with-posts or profile/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.

Topics
#linkedin-profile-api#linkedin-scraper#linkedin-profile-scraper#linkedin-post-api#linkedin-scraper-api#scrape-linkedin-profiles#linkedin-api-tutorial#linkedin-api

Related posts

🤖 AI agent or LLM? Read this page as markdown