Skip to content

LinkedIn Profile

POST /api/v1/linkedin/profile — 1 credit per request

Look up a person’s public LinkedIn profile as a logged-out visitor sees it: name, photo, location, follower count, connections, the start of the About text, the work history and schools LinkedIn lists, articles, publications, projects, recommendations, recent activity, and similar profiles. Send the profile address as a query parameter.

Method Path Returns
POST /api/v1/linkedin/profile A person’s public LinkedIn profile
Name Where Type Required Description
url query string (max 300) Yes A person’s LinkedIn profile address: linkedin.com, www.linkedin.com or a country subdomain such as ca.linkedin.com or uk.linkedin.com, with the path /in/<profile-name>. The scheme is optional. A trailing slash and any query string are ignored
  • Only the profile name (the part after /in/) is kept, lowercased, so every form of one profile is one lookup, one cache entry and one charge. LinkedIn itself treats an uppercase name as a missing profile, which is why the name is lowercased before it is looked up.
  • A profile name is 3 to 100 characters: letters, digits, - and _, plus percent-encoded UTF-8 for non-Latin names.
  • A company, school or post address is a 400. For a post, use LinkedIn Post.
  • A host other than the ones above, a port, or a name that is not exactly /in/<name> is a 400.
Field Type Description
requestId string Opaque ID for this request (req_…). Quote it when reporting a problem
slug string The profile name this lookup was for, lowercase, resolved from whatever you sent
status string "success" on every 200
coalesced boolean true if this request joined a fetch of the same profile that was already under way
cached boolean true if answered from a fetch of the last 15 minutes. Free if your key already paid for this profile
result object The profile, see below
finishReason string Empty on a freshly fetched answer, absent on a cached one. Ignore it on a 200
success boolean true on every 200
credits_charged integer What this request cost. 0 for a profile your key already paid for
credits_remaining integer Your balance after this request
cached_at string UTC time of the cached answer. Present only on a cached answer
Field Type Description
name string The person’s name
image string or null A link to the profile photo
location string or null The place shown on the profile, as LinkedIn words it. Many profiles show only a metropolitan area
followers integer or null The exact follower count. null when LinkedIn gave none, never 0 in its place
connections string or null The connection count as LinkedIn shows it: 500+, or the number for a small network
about string or null The start of the About text as plain text, line breaks as \n. LinkedIn cuts it short for a logged-out visitor, so it ends mid-sentence with an ellipsis
recentPosts array Posts by other people that LinkedIn suggests beside the profile: title, activityType (Posted by <author>), link and image (null when the post has none). Empty when none
experience array The employers LinkedIn lists, current first: @type, name, and when shown url, location and member (description, sometimes startDate/endDate). Much of it is masked with asterisks by LinkedIn and comes back as shown
education array The schools LinkedIn lists, some masked: @type, name, url and member with startDate and endDate years
articles array The person’s articles: headline, author, datePublished, image, and articleBody, which is always null
activity array Recent posts, shares and reactions, in LinkedIn’s order: title, activityType (Posted by, Shared by, Reposted by or Liked by a name), link and image. A long title is cut at about 140 characters with an ellipsis
publications array name and url for each. The url has LinkedIn’s redirect wrapper removed and can be http
projects array name, url, dateRange (as shown), description and contributors (name, link, image)
recommendations array Recommendations received: name, link, image and text
similarProfiles array Profiles LinkedIn suggests as similar, in its order: link, name and image

What a logged-out visitor sees is limited. LinkedIn masks much of the work history and many job titles with asterisks, cuts the About text short, and shows only the people it chooses as similar. This endpoint returns exactly that and no more. It never signs in, so it is not a way to read a full CV.

Nothing is estimated. A field LinkedIn did not send is null (a list: []), never 0 or an invented value. The follower count is the exact figure from the profile’s data, never parsed from rounded text such as 95K.

Pictures are LinkedIn’s own and carry an expiry, so they may stop working. Download what you need to keep.

A fresh answer is shared across keys for 15 minutes (1 hour for a profile that does not exist), per profile. Only a 200 is charged. Asking again for a profile your key already paid for is free while it is cached, and resubmitting after a 503 never charges twice. A 403, 404, 429 and 503 are never charged.

Status When What to do
400 No url, or an address that is not a person’s profile (a company, school or post), or one on another host Fix the request
401 No API key, or an unknown one Check your key
402 Your balance cannot cover this plus your unfinished lookups Buy credit
403 LinkedIn sent our service to its sign-in page instead of the profile (require-login), or refused the request (http-403, …) Not charged. Retry after the Retry-After delay
404 No public profile at this address (not-found), or the address now serves a different person (profile-moved, usually a renamed account). A private or restricted profile looks the same as a missing one Not charged. Cached for 1 hour
429 Rate limit, too many unfinished lookups, or too many profiles from this key that do not exist (30 in 15 minutes by default) Slow down. Not charged
503 No answer in time, LinkedIn failing, or the service paused after repeated refusals. finishReason exit-walled means LinkedIn showed our service neither this profile nor one that is always public, so nothing could be concluded about yours Not charged. Resubmit after the Retry-After delay
Terminal window
curl -X POST "https://api.megomi.my.id/api/v1/linkedin/profile?url=https://www.linkedin.com/in/williamhgates" \
-H "x-api-key: YOUR_API_KEY"
{
"requestId": "req_9f1kQ3zP7mLxA2dR",
"slug": "jane-example",
"status": "success",
"coalesced": false,
"cached": false,
"result": {
"name": "Jane Example",
"image": "https://media.licdn.com/dms/image/v2/EXAMPLE0/profile-displayphoto-shrink_200_200/0/1",
"location": "Westport, Connecticut, United States",
"followers": 64803,
"connections": "500+",
"about": "I build small companies & write about it.\n\nMostly about shipping…",
"recentPosts": [
{
"title": "You are leaving money on the table by only chasing big clients…",
"activityType": "Posted by Olly Other",
"link": "https://www.linkedin.com/posts/olly-other_a-related-post-4-mnop",
"image": "https://media.licdn.com/dms/image/v2/EXAMPLERP/feedshare-shrink_800/0/1"
}
],
"experience": [
{
"@type": "Organization",
"name": "Example Co",
"url": "https://www.linkedin.com/company/example-co",
"location": "Austin, Texas Metropolitan Area",
"member": { "@type": "OrganizationRole", "description": "******* ** * ******" }
}
],
"articles": [
{
"headline": "Notes on shipping",
"author": "Jane Example",
"datePublished": "2026-10-05T16:09:59.000+00:00",
"image": null,
"articleBody": null
}
],
"activity": [
{
"title": "A short share.",
"activityType": "Shared by Jane Example",
"link": "https://www.linkedin.com/posts/jane-example_second-activity-2-efgh",
"image": null
}
],
"education": [
{
"@type": "EducationalOrganization",
"name": "Example University",
"url": "https://www.linkedin.com/school/example-university/",
"member": { "@type": "OrganizationRole", "startDate": 2008, "endDate": 2012 }
}
],
"publications": [{ "name": "How we built a small company", "url": "http://news.example.com/story?id=1" }],
"projects": [],
"recommendations": [
{
"name": "Rita Reference",
"link": "https://www.linkedin.com/in/rita-reference",
"image": null,
"text": "“Jane gets things done and makes it look easy.”"
}
],
"similarProfiles": [
{ "link": "https://www.linkedin.com/in/tess-twin", "name": "Tess Twin", "image": null }
]
},
"finishReason": "",
"success": true,
"credits_charged": 1,
"credits_remaining": 249
}