Read a LinkedIn profile

The request

The only data parameter is url, and it is required. The shape is linkedin.com/in/<slug>. There is no name search on this route. LinkedIn sometimes turns requests away, and a member who hides their profile looks the same, so both answer upstream_blocked (503, free).

Retry later; a member who keeps answering it may have hidden their profile. A URL this route does not accept is unsupported_url. A broken parameter is invalid_params. Do not retry those two.

The recorded request is a profile URL.

1curl -G "https://api.socialscrape.dev/v1/linkedin/profile" \2  -H "x-api-key: $SOCIALSCRAPE_API_KEY" \3  --data-urlencode "url=https://www.linkedin.com/in/williamhgates"

1import os2import requests34params = {5    "url": "https://www.linkedin.com/in/williamhgates",6}7res = requests.get(8    "https://api.socialscrape.dev/v1/linkedin/profile",9    headers={"x-api-key": os.environ["SOCIALSCRAPE_API_KEY"]},10    params=params,11)12body = res.json()1314if body["ok"]:15    print(body["data"])16else:17    print(body["error"]["code"], body["error"]["message"])

1const url = new URL("https://api.socialscrape.dev/v1/linkedin/profile");2url.search = new URLSearchParams({3  "url": "https://www.linkedin.com/in/williamhgates"4}).toString();5const res = await fetch(url, {6  headers: { "x-api-key": process.env.SOCIALSCRAPE_API_KEY! },7});8const body = await res.json();910if (body.ok) {11  console.log(body.data);12} else {13  console.error(body.error.code, body.error.message);14}

trim, raw and max_age_days work as on other GETs. This endpoint is cacheable for 30 days. A cached hit costs 0 credits. See caching.

What you get

data is a profile. platform is linkedin. Shared fields: id, handle, name, headline, url, bio (the about text), avatar_url, banner_url, location, verified, is_private, external_url, links, created_at.

stats.followers is the follower count on the page. stats.following, stats.posts, stats.likes and stats.views are null when the page does not have them.

The LinkedIn-specific blocks are in extra:

• experience: title, company, company_slug, company_url, start, duration, is_current.
• education: school, school_url, start_year, end_year.
• current_companies: strings.
• articles: title, url, summary, published_at, likes, comments, image_url.
• recent_posts: id, text, url, likes, published_at.
• similar_profiles: name, headline, location, url, followers.
• connections and connections_count. connections is the text LinkedIn prints, not an array of members.
• badges and source.

The endpoint description also lists skills, courses and recommendations. The recorded sample is shortened and does not include those keys. If a live response omits them, they were not on the page. Do not backfill.

extra.recent_posts is a short list, not the member's archive. To read one of them in full, pass url to GET /v1/linkedin/post. That returns the full text, reactions, comment count and the top comments in extra.top_comments.

Company pages are a different route, GET /v1/linkedin/company, and their posts are GET /v1/linkedin/company/posts. A person URL will not work on the company route.