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.
Endpoint
Section titled “Endpoint”| Method | Path | Returns |
|---|---|---|
| POST | /api/v1/linkedin/profile |
A person’s public LinkedIn profile |
Request & Response
Section titled “Request & Response”Request
Section titled “Request”| 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 a400.
Response body
Section titled “Response body”| 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 |
The result object
Section titled “The result object”| 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.
Caching and cost
Section titled “Caching and cost”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.
Errors
Section titled “Errors”| 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 |
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"const params = new URLSearchParams({ url: "https://www.linkedin.com/in/williamhgates" });const res = await fetch(`https://api.megomi.my.id/api/v1/linkedin/profile?${params}`, { method: "POST", headers: { "x-api-key": process.env.MEGOMI_API_KEY }, signal: AbortSignal.timeout(60_000),});const data = await res.json();import requests
res = requests.post( "https://api.megomi.my.id/api/v1/linkedin/profile", params={"url": "https://www.linkedin.com/in/williamhgates"}, headers={"x-api-key": "YOUR_API_KEY"}, timeout=60,)print(res.json())<?php$url = "https://api.megomi.my.id/api/v1/linkedin/profile?" . http_build_query(["url" => "https://www.linkedin.com/in/williamhgates"]);$ch = curl_init($url);curl_setopt($ch, CURLOPT_POST, true);curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-api-key: YOUR_API_KEY"]);curl_setopt($ch, CURLOPT_TIMEOUT, 60);curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);echo curl_exec($ch);q := url.Values{}q.Set("url", "https://www.linkedin.com/in/williamhgates")req, _ := http.NewRequest("POST", "https://api.megomi.my.id/api/v1/linkedin/profile?"+q.Encode(), nil)req.Header.Set("x-api-key", "YOUR_API_KEY")client := &http.Client{Timeout: 60 * time.Second}resp, _ := client.Do(req){ "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}{ "status": 400, "title": "Bad Request", "detail": "url is required: send a LinkedIn profile address such as https://www.linkedin.com/in/williamhgates"}{ "status": 403, "title": "Forbidden", "detail": "LinkedIn sent our service to its sign-in page instead of the profile; you were not charged", "requestId": "req_5mPq1XwK8jVcT4nR", "slug": "jane-example", "finishReason": "require-login"}{ "status": 404, "title": "Not Found", "detail": "the source reports no such profile (or it is not visible to a logged-out visitor); you were not charged. This answer is cached for an hour", "requestId": "req_5mPq1XwK8jVcT4nR", "finishReason": "not-found"}{ "status": 503, "title": "Service Unavailable", "detail": "no data fetched within 45s; you were not charged. The lookup is still running: submitting the same request again shortly may return it from cache, and is never charged twice", "requestId": "req_1qLr6PxV8nWtE3sJ", "finishReason": "no-data-fetched"}