LinkedIn API skill

Read public LinkedIn data as clean JSON. This LinkedIn API skill is the largest surface in the repo: a profile plus twenty sub-resources — experiences, educations, skills, certifications, publications, patents, recommendations, volunteering and more — alongside company data, funding and insights, people search, company search, job search, post reactions and comment threads, and the LinkedIn ad library.

LinkedIn is the hardest mainstream platform to read programmatically and the one most people want most. Each sub-resource is its own endpoint, so you pay for the slice you need instead of pulling a whole profile to read one field.

This skill wraps 38 live LinkedIn endpoints from the ScraperSocial API. Public data only, returned as clean JSON.

When to use this skill

• You are enriching a lead or candidate record from a public profile URL or handle.
• You need one slice of a profile — just the work history, just the skills — rather than everything.
• You are researching a company: headcount, funding, insights, open jobs, employees, posts.
• You are sourcing candidates or prospects through people search or job search.
• You are analysing engagement on a post: reactions, comments and replies.

Do not use this skill when

• Watch the cost. get_profile.js --section=contact costs 25 credits, the most expensive non-video call here. Full profiles and company records cost 10. Fetch the specific section you need instead of the whole profile.
• You are compiling personal data at scale. This returns information about real people. GDPR, CCPA and LinkedIn's own terms apply to what you do with it. Have a lawful basis, honour deletion requests, and do not build unsolicited bulk-contact lists where that is restricted.
• You need to send connection requests or InMail. Read-only.
• You need private profile fields or anything behind a login. Public data only.
• A LinkedIn link appears in passing with no question attached.

Setup

export SCRAPERSOCIAL_KEY=sk_live_...   # https://scrapersocial.com/app/keys

Signing up at scrapersocial.com/signup includes 100 free credits, no card required.

Permissions and scope

These scripts do exactly three things and nothing else: read one environment variable (SCRAPERSOCIAL_KEY), send HTTPS requests to https://api.scrapersocial.com (the host is a constant in the code, not configurable), and print JSON. They run as node scripts/<name>.js with no other shell use, no file writes and no persistence. call_endpoint.js accepts only the 38 documented /v1/linkedin/ paths in the table below and refuses anything else before a request is made.

Scripts

Every script also accepts --limit, --cursor, --fields, --format and --fresh. --limit is clamped to 50: above that the API returns an async job instead of data.

Example

node skills/linkedin-api/scripts/people_search.js "product manager fintech"

Every response uses the same envelope:

{ "data": {}, "meta": { "count": 20, "next_cursor": "..." }, "request_id": "a18e4ef88ad4b00b" }

meta appears on paginated endpoints only. Keep request_id — support traces calls with it.

Endpoints

Costs shown per item for paginated endpoints, per call otherwise. Failed calls are not charged.

FAQ

How do I get a LinkedIn profile as JSON?

get_profile.js with the profile URL or handle returns the core profile for 10 credits; --section=full returns the expanded record. For one slice, use the matching section — --section=experiences, --section=skills, --section=educations and so on.

How do I get someone's contact details?

get_profile.js --section=contact returns the contact record for 25 credits. Separately, the default get_profile.js accepts --include_email, which adds the email to the base profile and reprices that call from 10 credits to 25. --include_email applies only to the default section; it is not accepted anywhere else. Only pull either with a lawful basis for processing that person's data.

Can I search LinkedIn for people, companies or jobs?

Yes: people_search.js (with --section=by-name or --section=by-services), get_company.js --section=search, and job_search.js. Each costs 5 credits per result returned.

How do I get company data?

get_company.js returns the company for 10 credits. Sections cover funding, insights, jobs, people and posts.

Is this an official LinkedIn API?

No. ScraperSocial is independent and not affiliated with LinkedIn or Microsoft. It returns publicly available data only. LinkedIn's own Marketing and Talent APIs are the sanctioned route for partner use cases.

Links

• LinkedIn data on ScraperSocial
• All 33 platform skills
• OpenAPI spec · llms.txt

Disclaimer

ScraperSocial is an independent product and is not affiliated with, endorsed by, or sponsored by any platform named in this repository. All product names, logos and brands are property of their respective owners. These skills return only publicly available data.