LinkedIn Profile Scraper

Get LinkedIn profile data as structured JSON. Name, headline, location, about, current company, followers and connections for any public profile — no login, no cookies, no Sales Navigator seat, no browser extension.

What it does

Takes one public LinkedIn profile URL and returns one dataset row. No pagination — one input, one record.

Input

Field	Type	Required	Default	Description
url	string	yes	—	LinkedIn person profile URL, e.g. https://www.linkedin.com/in/username

{ "url": "https://www.linkedin.com/in/williamhgates" }

Country subdomains work — uk.linkedin.com/in/… and ca.linkedin.com/in/… resolve to the same person, and are billed once rather than once per spelling.

Output

One row.

{
  "platform": "linkedin",
  "publicIdentifier": "williamhgates",
  "url": "https://linkedin.com/in/williamhgates",
  "fullName": "Bill Gates",
  "headline": "Chair, Gates Foundation",
  "about": "Co-chair of the Bill & Melinda Gates Foundation…",
  "location": "Seattle, Washington",
  "currentCompany": { "name": "Gates Foundation", "url": "https://www.linkedin.com/company/gates-foundation" },
  "counts": { "followers": 37000000, "connections": 500 },
  "avatarUrl": "https://media.licdn.com/dms/image/…"
}

Field	Type	Notes
platform	string	Always linkedin
publicIdentifier	string	The /in/<slug> segment
url	string	Canonical profile URL
fullName	string	Full name — always present
headline	string	Profile headline — may be absent, see below
about	string	About / summary section
location	string	Stated location
currentCompany	object	name, url — most recent employer
counts.followers	integer	Follower count
counts.connections	integer	Connections, capped at 500 by LinkedIn itself
avatarUrl	string	Profile photo URL

Fields that depend on the source

Two independent upstream sources serve this actor, and they are near-complementary: one carries about, location and employment history; the other carries headline. Whichever answered first decides which of those you get. fullName, url and follower count come from both.

This is stated plainly rather than hidden because a field that is sometimes missing is worse than one that never exists — if you build a pipeline assuming headline is always there, it will break on a fraction of rows.

connections is capped by LinkedIn

LinkedIn stops reporting exact connection counts at 500. A profile showing 500 may have 500 or 50,000. That ceiling is LinkedIn's, not this actor's, and any tool claiming a precise number above it is inventing one.

What it does not do

• Person profiles only. Company pages (/company/…), school pages and post URLs are rejected with BAD_REQUEST rather than charged for a call that cannot fill the fields.
• No email addresses. LinkedIn does not publish them. Tools that return one are guessing from name and employer, and their accuracy is a claim you should test before trusting.
• No connections list, no followers list, no messaging.
• Public profiles only. A profile that is private or requires sign-in returns NOT_FOUND.
• One profile per run.

Pricing

Charged per profile. One run, one charge. Failed runs charge nothing.

Errors

Code	Meaning
BAD_REQUEST	Input missing, malformed, or not a URL this actor serves
NOT_FOUND	The target is private, removed, or does not exist
UNSUPPORTED_OPERATION	The URL resolved to a platform this actor does not serve
UPSTREAM_FAILED	Every upstream source failed — retry shortly
RATE_LIMITED	Too many requests; back off and retry
TIMEOUT	The source took longer than the actor's budget
UNAUTHORIZED	The actor's API credentials are invalid — contact the author
INSUFFICIENT_CREDITS	The account behind this actor is out of credits — contact the author
INTERNAL_ERROR	Unexpected failure

UNAUTHORIZED and INSUFFICIENT_CREDITS are on us, not you. If you see either, the actor is misconfigured on our side.

How it works

Two independent upstream sources serve this operation. If the first returns nothing usable, the second is tried automatically inside the same run — no double charge, no retry on your side.

Profile figures are cached for a day. A LinkedIn profile changes when someone moves job, not by the minute, so a day-old record is still a correct one — and re-fetching it hourly would charge you for a number that did not move.

FAQ

Do I need a LinkedIn account or cookies? No, and no browser extension either.

Do I need Sales Navigator? No.

Can I get email addresses? No. LinkedIn does not publish them; anything that returns one is guessing.

Why is connections exactly 500? That is LinkedIn's own reporting ceiling.

Why is headline missing on some profiles? Only one of the two sources carries it. See "Fields that depend on the source".

Can I scrape a company page? No — this actor is for person profiles only.