--- title: "LinkedIn Profile API: real-time structured data | Scrape.ly" description: "Extract public LinkedIn profile details from profile URLs or IDs: names, headlines, locations, about sections, follower counts, experience, and education." url: https://scrape.ly/api/linkedin-profile-api markdown: https://scrape.ly/api/linkedin-profile-api.md --- G2 4.7/5 [Excellent](https://www.trustpilot.com/review/scrape.ly) [Trustpilot](https://www.trustpilot.com/review/scrape.ly) # Turn LinkedIn Profile into structured data Extract public LinkedIn profile details from profile URLs or IDs: names, headlines, locations, about sections, follower counts, experience, and education. [Try LinkedIn Profile API](https://scrape.ly/store/cornerledger/linkedin-profile-scraper.md) 01 Integration ## Integrate LinkedIn Profile API your way Connect to Scrape.ly using Python, JavaScript, HTTP, cURL, OpenAPI, or MCP and start extracting LinkedIn Profile data in minutes. from scrapely_client import ScrapelyClient client = ScrapelyClient ( 'YOUR_TOKEN' , api_url = 'https\://api.scrape.ly' ) run = client. actor ( 'cornerledger/linkedin-profile-scraper' ) . call ( run_input = { 'queries' : \[ 'https\://www\.linkedin.com/in/williamhgates' ] } ) for item in client. dataset ( run.default_dataset_id ) . iterate_items () : print ( item ) 02 Input & Output ## Send a profile URL, get structured profile data Pass profile URLs, public identifiers, and profile IDs into Scrape.ly. Get structured outputs with names and headlines, locations, about sections, experience and education, and follower and connection counts, and more. Input 1 2 3 4 5 ``` { "queries":[ "https://www.linkedin.com/in/williamhgates" ] } ``` Output 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 ``` { "publicIdentifier":"williamhgates", "firstName":"Bill", "lastName":"Gates", "headline":"Chair, Gates Foundation and Founder, Breakthrough Energy", "location":{ "linkedinText":"Seattle, Washington, United States" }, "followerCount":41000000, "currentPosition":[ { "companyName":"Gates Foundation" } ], "linkedinUrl":"https://www.linkedin.com/in/williamhgates" } ``` Reference ## LinkedIn Profile API reference One request returns one public LinkedIn profile per target, as JSON. Send profile URLs, public identifiers (the last part of the URL) or profile IDs; no LinkedIn account or cookie is involved. ### Endpoint `POST https://api.scrape.ly/v2/actors/cornerledger~linkedin-profile-scraper/run-sync-get-dataset-items` Starts a run, waits up to 90 seconds and returns the dataset items. Add `?format=csv` for CSV. For longer jobs, start the run with `POST /v2/actors/{actorId}/runs` and read the dataset when it finishes. From $2.72 per 1,000 profiles. ``` curl -X POST "https://api.scrape.ly/v2/actors/cornerledger~linkedin-profile-scraper/run-sync-get-dataset-items" \ -H "Authorization: Bearer $SCRAPELY_TOKEN" \ -H "Content-Type: application/json" \ -d '{"queries":["https://www.linkedin.com/in/williamhgates"]}' ``` ### Body parameters | Name | Type | Description | | ----------------- | --------- | ------------------------------------------------------------------------------------------------------------------------ | | queries | string\[] | Profile URLs or public identifiers, mixed, for example "https\://www\.linkedin.com/in/williamhgates" or "williamhgates". | | urls | string\[] | Profile URLs. | | publicIdentifiers | string\[] | Public identifiers only. | | profileIds | string\[] | LinkedIn profile IDs. | Send at least one of the four fields. One row per target; error and errorDescription are set when a target cannot be read. Profiles are personal data: process them with a lawful basis and in line with GDPR and CCPA. ### Response fields - id - publicIdentifier - linkedinUrl - firstName - lastName - headline - about - location - connectionsCount - followerCount - currentPosition - experience - education - error - errorDescription ### Status codes | Status | Type | Meaning | | ------ | ------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------- | | 200 | — | The run succeeded. The body is the dataset items, a JSON array. | | 400 | run-failed | The run ended in a status other than SUCCEEDED. | | 401 | token-not-provided / token-not-valid | No Authorization: Bearer header, or an unknown, expired or revoked token. | | 402 | payment-required | The run cannot reserve enough credits. | | 408 | run-timeout-exceeded | The run did not finish within 90 seconds. It keeps going: wait with GET /v2/actor-runs/{runId}?waitForFinish=60 instead of starting another. | | 429 | rate-limit-exceeded / concurrency-limit-exceeded | Too many requests or concurrent runs. Retry with exponential backoff. | Full details in the [Actors API docs](https://scrape.ly/docs/api-actors.md). 03 How it works ## Start extracting LinkedIn Profile data in four simple steps Scrape.ly keeps the setup simple so you can move from signup to live LinkedIn Profile data without wasting time on scraping infrastructure. [Get started for free](https://my.scrape.ly/register) Step 1 ### Create your Scrape.ly account Create your account and get access to ready-made APIs, scrapers, and automation tools. Step 2 ### Get your Scrape.ly API token Copy your API token from the Scrape.ly dashboard and use it to authenticate your requests. Step 3 ### Connect LinkedIn Profile API Choose Python, JavaScript, HTTP, or MCP and connect Scrape.ly to your app or workflow. Step 4 ### Fetch LinkedIn Profile data Send your profile URLs, public identifiers, and profile IDs, then receive clean structured data ready for analysis. 04 Why Scrape.ly ## Everything you need to extract data reliably Scrape.ly gives you ready-made APIs, proxy support, monitoring, exports, integrations, and scalable infrastructure in one platform. ### Never Get Blocked Use built-in proxy support to reduce blocks, rate limits, and failed requests. ### Export Any Format Get results in JSON, CSV, Excel, XML, HTML table, RSS, or other workflow-friendly formats. ### Monitor Every Run Track scraper status, performance, failures, retries, and outputs from one dashboard. ### Built-In Integrations Connect with webhooks, APIs, automation tools, cloud apps, and internal systems. ### Scalable Infrastructure Run small tests or high-volume extraction jobs without rebuilding your scraping stack. ### Developer-Friendly Use clean APIs, SDKs, docs, examples, and structured outputs built for real workflows. 05 AI-Ready Data ## Feed LinkedIn Profile data into your tools instantly Connect Scrape.ly with your apps, dashboards, sheets, agents, and automation workflows to turn LinkedIn Profile data into action. [Browse integrations](https://scrape.ly/integrations.md) [API Reference](https://scrape.ly/docs/api-overview.md) ![AI-ready data workflow illustration](https://scrape.ly/assets/pages/api/ai-ready-data/ai-ready.svg) [7 ready-made scrapers All LinkedIn scrapers on one page Real output, live prices per 1,000 results, and how to run each one. See them](https://scrape.ly/scrapers/linkedin.md) 06 Explore APIs ## More LinkedIn Profile APIs on Scrape.ly Browse ready-made LinkedIn Profile scrapers and APIs available inside Scrape.ly and choose the one that fits your workflow. ![LinkedIn Profile Scraper logo](https://scrape.ly/cdn-cgi/image/width=132,fit=scale-down,format=auto/https://api.scrape.ly/v2/actors/85e965da2b71464e8/picture.webp?v=d90c2bfa89b6ff567ee34e066d9fdb70) ### [LinkedIn Profile Scraper](https://scrape.ly/store/cornerledger/linkedin-profile-scraper.md) scrape.ly/store/cornerledger/linkedin-profile-scraper --- [Corner Ledger](https://scrape.ly/users/cornerledger.md "Developed by Corner Ledger") Lead generation Social media --- 1K monthly users [Try for free](https://my.scrape.ly/store/cornerledger~linkedin-profile-scraper?intent=signup) ![LinkedIn People Search logo](https://scrape.ly/cdn-cgi/image/width=132,fit=scale-down,format=auto/https://api.scrape.ly/v2/actors/86cf22b743e4438bb/picture.webp?v=ddd5244bf0d7f94653afda1b7736751c) ### [LinkedIn People Search](https://scrape.ly/store/cornerledger/linkedin-people-search.md) scrape.ly/store/cornerledger/linkedin-people-search --- [Corner Ledger](https://scrape.ly/users/cornerledger.md "Developed by Corner Ledger") Lead generation Social media --- 96 monthly users [Try for free](https://my.scrape.ly/store/cornerledger~linkedin-people-search?intent=signup) ### Check other related APIs [View all](https://scrape.ly/api.md) [LinkedIn Company API](https://scrape.ly/api/linkedin-company-api.md) [Indeed API](https://scrape.ly/api/indeed-api.md) [Glassdoor API](https://scrape.ly/api/glassdoor-api.md) [Upwork API](https://scrape.ly/api/upwork-api.md) [Trustpilot API](https://scrape.ly/api/trustpilot-api.md) [Yahoo Finance API](https://scrape.ly/api/yahoo-finance-api.md) 07 FAQ ## Common questions about LinkedIn Profile API Quick answers about using Scrape.ly's LinkedIn Profile API, available data, setup, and legal usage. Got more questions? [Reach out to us](mailto:hello@scrape.ly?subject=LinkedIn%20Profile%20API%20question\&body=I%20have%20a%20question%20about%20the%20LinkedIn%20Profile%20API.) ### How is this different from an official LinkedIn Profile API? --- Official APIs, where they exist, usually need approval, keys, or paid tiers and limit which public data you can pull. Scrape.ly's LinkedIn Profile API collects the public data shown on LinkedIn Profile and returns it as structured JSON, with no approval process. ### Can I try the LinkedIn Profile API for free? ### What data can I get from the LinkedIn Profile API? ### Is it legal to scrape LinkedIn Profile data? ### How do I get started with the LinkedIn Profile API? G2 4.7/5 [Excellent](https://www.trustpilot.com/review/scrape.ly) [Trustpilot](https://www.trustpilot.com/review/scrape.ly) ## The internet is full of data. Start owning yours. Scrape.ly gives you the infrastructure, the tooling, and the team to extract, process, and operationalize web data at any scale. Setup takes minutes. [Get Started Free](https://my.scrape.ly/register) [Chat with Support](mailto:hello@scrape.ly?subject=Question%20about%20Scrape.ly\&body=Hi%2C%20I%20have%20a%20question%20about%20Scrape.ly.) No credit card. No setup calls.