Skip to content
scrapeatlas.Dashboard

Social networks

LinkedIn API

Public LinkedIn profiles, company pages, company posts, posts, articles, video transcripts and keyword post search.

6 endpointsx-api-key

Retrieve public LinkedIn profiles, companies, posts and transcripts, and search posts by keyword.

API availability: Available

Base URL · local workerhttp://localhost:3028Public API: https://api.scrapeatlas.com.
Authenticationx-api-keyCustomer key from your account. See Authentication.

Endpoints

GET/v1/linkedin/profile

Get a LinkedIn profile

Public profile as LinkedIn publishes it: name, photo, location, follower count, connection bucket, about text, recent posts, experience, articles, education, publications, projects, recommendations and similar profiles. Job titles and descriptions are returned exactly as the public page shows them.

Reference
GET/v1/linkedin/company

Get a LinkedIn company page

Retrieve a public company, school or showcase page with identity, description, locations, counts, website, images, specialties, related companies and a page of posts with its continuation token.

Reference
GET/v1/linkedin/company/posts

List LinkedIn company posts

Numbered pages of a company's public posts. Page 1 is the structured-data list on the company page; later pages read the public guest feed ten posts at a time, where datePublished is derived from the activity id. Pass the organization_id and paginationToken the company route returned (as organization_id and pagination_token) to read a later page with a single feed request.

Reference
GET/v1/linkedin/search/posts

Search LinkedIn posts

Search public LinkedIn posts by keyword and retrieve each result with the post endpoint's fields.

Reference
GET/v1/linkedin/post

Get a LinkedIn post or article

A public post (linkedin.com/posts/…) or article (linkedin.com/pulse/…). Posts return text, images (including document carousel pages), author, embedded comments and counters; video posts add name, thumbnailUrl, uploadDate, transcript and the video media URL; articles return name, headline, full body text and more articles by the author.

Reference
GET/v1/linkedin/post/transcript

Get a LinkedIn video transcript

Transcript LinkedIn publishes with a public video post. Posts without a video, or videos without published captions, return transcript null and transcriptNotAvailable true.

Reference

Quick start

Create an API key on your account page, then call the public API. Values below are placeholders.

Terminal
curl "https://api.scrapeatlas.com/v1/linkedin/profile?url=https%3A%2F%2Fwww.linkedin.com%2Fin%2Fparrsam" \
  -H "x-api-key: YOUR_API_KEY"

Coverage & limits

  • Stateless retrieval; four concurrent operations, 60-second deadline, 24 MiB combined decoded responses per operation and per-body caps of 2 MiB for pages, 1 MiB for guest feed fragments and search responses and 512 KiB for media manifests. No cookies, login, browser, database or retained content. The worker keeps only a bounded, ten-minute in-memory map of company handle to guest-feed identifiers (organization id and pagination token) so later company post pages skip the company page.
  • Profile and company pages are read through LINKEDIN_PROXY_URL (a residential proxy with up to four fresh-session attempts) where LinkedIn gates direct connections; post pages, guest feeds and media manifests are read directly.
  • Post search uses LINKEDIN_SEARCH_API_KEY (Brave Search API). Each result is read from its LinkedIn page (plus two manifests for document posts); pages are ten results, cursor 1–10.
  • Public pages carry masked job titles, embedded comments, the first page of company posts and current similar-profile lists; later company post pages derive datePublished from the activity id.
Error codes
9
HTTPfailure.codeMeaning
400invalid_requestNot a public LinkedIn profile, company or post URL, or invalid parameters.
401unauthorizedInvalid worker key.
403restrictedLinkedIn redirected to a login page for this resource.
404not_foundThe page does not exist or the search returned no posts.
429upstream_rate_limitedLinkedIn or the search index throttled retrieval.
502upstream_challengedLinkedIn answered with a challenge (HTTP 999/403 or an auth wall), including through the proxy.
502upstream_error unsupported_page unsafe_redirect search_failedSource or search index did not return a usable page.
503search_unavailable busyNo search key configured, or all retrieval slots are busy.
504timeoutThe operation exceeded its deadline.