Get a LinkedIn post or article

Try in Playground

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.

GET/v1/linkedin/postx-api-key

Headers

Get your API key

x-api-keystringrequiredheader

Your ScrapeAtlas customer key. Create one on /account/ and set SCRAPEATLAS_API_KEY.

Query parameters

urlstringrequiredquery

Public post or article URL.

min 1 chars · max 500 chars

Examplehttps://www.linkedin.com/posts/parrsam_careers-activity-7328088180820193281-3j6g

Response fields

requestIdstring

Operational correlation UUID.

Post page plus up to two media manifests for document posts.

accounting.upstreamRequestsinteger

Always included.

≥ 0

accounting.responseBytesinteger

Always included.

≥ 0

accounting.durationMsnumber

Always included.

≥ 0

successboolean

True when usable data is returned.

statusenum

success or partial; failed/challenged on errors.

one of: success, partial

sourceUrlstring

Canonical www.linkedin.com page read.

absolute HTTPS URL

fetchedAtstring

UTC retrieval time.

document_pages_unavailable when carousel pages fall back to cover images.

coverage.sourceenum

Always included.

one of: public_page, web_search

coverage.completeboolean

Always included.

coverage.warningsstring[]

Always included.

urlstring

Public post or article URL.

absolute HTTPS URL

namestringoptional

Video or article title.

thumbnailUrlstringnullableoptional

Video poster (video posts).

headlinestringnullableoptional

Article lead (articles).

commentCountnumbernullable

Comment counter.

likeCountnumbernullable

Reaction counter.

datePublishedstringnullable

Publication time.

uploadDatestringnullableoptional

Video upload time (video posts).

descriptionstring

Post text, video description or full article body text.

transcriptstringnullableoptional

Video transcript or null (video posts).

mediastringnullableoptional

Video URL, first image or null.

imagesstring[]optional

Image or carousel page URLs.

imagestringnullableoptional

First image or null.

name, url, image (when shown) and followers.

author.namestring

Always included.

author.urlstringnullable

Always included.

author.imagestringoptional

Optional.

author.followersnumbernullable

Always included.

Comments embedded in the public page: author, text and profile URL.

up to 100 items

comments.authorstring

Always included.

comments.textstring

Always included.

comments.linkedinUrlstringnullable

Always included.

moreArticlesobject[]optional

More articles by the author (articles only).

up to 100 items

HTTP 200 returns the success variant. Check status: partial means usable data with warnings, and failed or challenged requests carry a failure object described in Errors & responses.

Error codes

HTTP	failure.code	Meaning
400	`invalid_request`	Not a public LinkedIn profile, company or post URL, or invalid parameters.
401	`unauthorized`	Invalid worker key.
403	`restricted`	LinkedIn redirected to a login page for this resource.
404	`not_found`	The page does not exist or the search returned no posts.
429	`upstream_rate_limited`	LinkedIn or the search index throttled retrieval.
502	`upstream_challenged`	LinkedIn answered with a challenge (HTTP 999/403 or an auth wall), including through the proxy.
502	`upstream_error` `unsupported_page` `unsafe_redirect` `search_failed`	Source or search index did not return a usable page.
503	`search_unavailable` `busy`	No search key configured, or all retrieval slots are busy.
504	`timeout`	The operation exceeded its deadline.

Code example

curl "https://api.scrapeatlas.com/v1/linkedin/post?url=https%3A%2F%2Fwww.linkedin.com%2Fposts%2Fparrsam_careers-activity-7328088180820193281-3j6g" \
  -H "x-api-key: YOUR_API_KEY"

const response = await fetch(
  "https://api.scrapeatlas.com/v1/linkedin/post?url=https%3A%2F%2Fwww.linkedin.com%2Fposts%2Fparrsam_careers-activity-7328088180820193281-3j6g",
  {
    headers: {
      "x-api-key": "YOUR_API_KEY"
    }
  }
);

const data = await response.json();
console.log(data.status, data);

type Result = {
  status: "success" | "partial" | "failed" | "challenged";
  requestId: string;
  [field: string]: unknown;
};

const response = await fetch(
  "https://api.scrapeatlas.com/v1/linkedin/post?url=https%3A%2F%2Fwww.linkedin.com%2Fposts%2Fparrsam_careers-activity-7328088180820193281-3j6g",
  {
    headers: {
      "x-api-key": process.env.SCRAPEATLAS_API_KEY!
    }
  }
);

const data = (await response.json()) as Result;
if (data.status === "failed" || data.status === "challenged") {
  throw new Error(`LinkedIn request failed: ${data.requestId}`);
}
console.log(data);

import requests

response = requests.get(
    "https://api.scrapeatlas.com/v1/linkedin/post",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "url": "https://www.linkedin.com/posts/parrsam_careers-activity-7328088180820193281-3j6g"
    },
    timeout=60,
)
data = response.json()
print(data["status"], data)

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.scrapeatlas.com/v1/linkedin/post?url=https%3A%2F%2Fwww.linkedin.com%2Fposts%2Fparrsam_careers-activity-7328088180820193281-3j6g", nil)
	req.Header.Set("x-api-key", "YOUR_API_KEY")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	var data map[string]interface{}
	json.NewDecoder(resp.Body).Decode(&data)
	fmt.Println(data["status"], data)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        var client = HttpClient.newHttpClient();
        var request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.scrapeatlas.com/v1/linkedin/post?url=https%3A%2F%2Fwww.linkedin.com%2Fposts%2Fparrsam_careers-activity-7328088180820193281-3j6g"))
            .GET()
            .header("x-api-key", "YOUR_API_KEY")
            .build();
        var response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

Use your sa_live_… customer key at https://api.scrapeatlas.com.

Responses

Successful result. Synthetic example validated against the runtime contract.

{
  "success": true,
  "status": "success",
  "requestId": "00000000-0000-4000-8000-000000000005",
  "sourceUrl": "https://www.linkedin.com/posts/example-person_careers-activity-7328088180820193281-3j6g",
  "fetchedAt": "2026-09-11T00:00:00.000Z",
  "coverage": {
    "source": "public_page",
    "complete": true,
    "warnings": []
  },
  "accounting": {
    "upstreamRequests": 1,
    "responseBytes": 175000,
    "durationMs": 900
  },
  "url": "https://www.linkedin.com/posts/example-person_careers-activity-7328088180820193281-3j6g",
  "datePublished": "2025-05-13T16:06:11.566Z",
  "description": "If you live in SF\n\n...and want to lead",
  "media": null,
  "images": [],
  "image": null,
  "author": {
    "name": "Example Person",
    "url": "https://www.linkedin.com/in/example-person",
    "image": "https://media.licdn.com/dms/image/v2/example/profile-displayphoto-shrink_200_200",
    "followers": 90898
  },
  "comments": [
    {
      "author": "Commenter One",
      "text": "DMed you something",
      "linkedinUrl": "https://www.linkedin.com/in/commenter-one"
    }
  ],
  "likeCount": 172,
  "commentCount": 45
}

Not a public LinkedIn profile, company or post URL, or invalid parameters.

{
  "requestId": "9d2f1c0a-6b1e-4c7d-9a8e-2f3b4c5d6e7f",
  "accounting": {
    "upstreamRequests": 0,
    "responseBytes": 0,
    "durationMs": 0
  },
  "success": false,
  "status": "failed",
  "failure": {
    "code": "invalid_request",
    "message": "Invalid request: missing, duplicate, unsupported or malformed parameters."
  }
}