LinkedIn Article API
Returns one LinkedIn Pulse article: its text, author, like and comment counts, and publish time.
GET /v1/linkedin/articleLast updated November 2026Maintained by the SocialCrawl team
When to use the LinkedIn Article API
Use it when you have a /pulse/ URL. Comments and reactions are article/comments and article/reactions.
From the API reference
Returns one Pulse article as a canonical Post: text, author, engagement, and publish time. Pass the article's /pulse/ URL. Comments and reactions are separate calls.
Searching 69 platforms in parallel
What can you do with the Article API?
The Article endpoint gives you structured LinkedIn data with computed fields in a single request. No scraping infrastructure to build or maintain.
Example Request
# GET /v1/linkedin/article: 5 credits per call. Cache hits are free and failed calls are refunded.
# Check the price first for 0 credits: add dry_run=1 to the query. Nothing is fetched or charged.
# --max-time 60: the API's own time limit for this endpoint.
# --retry 3: retries timeouts, 429 and 5xx, honoring Retry-After.
# -o response.json keeps only the final attempt's body.
# One Idempotency-Key per request, reused on every retry, so a retried call is never charged twice.
IDEMPOTENCY_KEY=$(od -An -N16 -tx1 /dev/urandom | tr -d ' \n')
curl -sS --max-time 60 --retry 3 -o response.json \
-H "x-api-key: YOUR_API_KEY" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
"https://www.socialcrawl.dev/v1/linkedin/article?url=https%3A%2F%2Fwww.linkedin.com%2Fpulse%2Fhidden-costs-unreliable-electricity-bill-gates%2F" && cat response.json# GET /v1/linkedin/article: 5 credits per call. Cache hits are free and failed calls are refunded.
# Check the price first for 0 credits: add dry_run=1 to the query. Nothing is fetched or charged.
import os
import random
import time
import uuid
import requests
API_KEY = os.environ.get("SOCIALCRAWL_API_KEY", "YOUR_API_KEY")
TIMEOUT_S = 60 # the API's own time limit for this endpoint.
MAX_RETRIES = 3
URL = "https://www.socialcrawl.dev/v1/linkedin/article"
def backoff(attempt):
# Exponential backoff with jitter: about 1 s, 2 s, then 4 s.
return 2 ** attempt * (0.5 + random.random() / 2)
def socialcrawl(params):
# One Idempotency-Key per request, reused on every retry, so a retried call is never charged twice.
idempotency_key = str(uuid.uuid4())
for attempt in range(MAX_RETRIES + 1):
try:
res = requests.get(
URL,
params=params,
headers={"x-api-key": API_KEY, "Idempotency-Key": idempotency_key},
timeout=TIMEOUT_S,
)
body = res.json()
except (requests.RequestException, ValueError):
# A timeout, a dropped connection or a non-JSON gateway page: retry with the same key.
if attempt == MAX_RETRIES:
raise
time.sleep(backoff(attempt))
continue
if body["success"]:
return body
error = body["error"]
# Branch on error["type"], never on the message text.
if error["type"] == "RESOURCE_NOT_FOUND":
return None # refunded: nothing to read
retry_after = res.headers.get("Retry-After")
# SERVICE_UNAVAILABLE without Retry-After is a withdrawn endpoint: permanent.
permanent = error["type"] == "SERVICE_UNAVAILABLE" and retry_after is None
if not error.get("retryable") or permanent or attempt == MAX_RETRIES:
raise RuntimeError(f"{error['type']}: {error['message']} (request_id {body['request_id']})")
# Retry-After (seconds) wins; otherwise back off.
time.sleep(float(retry_after) if retry_after else backoff(attempt))
params = {
"url": "https://www.linkedin.com/pulse/hidden-costs-unreliable-electricity-bill-gates/",
}
body = socialcrawl(params)
if body is not None:
print(body["data"])// GET /v1/linkedin/article: 5 credits per call. Cache hits are free and failed calls are refunded.
// Check the price first for 0 credits: add dry_run=1 to the query. Nothing is fetched or charged.
const API_KEY = process.env.SOCIALCRAWL_API_KEY ?? "YOUR_API_KEY";
const TIMEOUT_MS = 60_000; // the API's own time limit for this endpoint.
const MAX_RETRIES = 3;
type Page = { next_cursor: string | null; has_more: boolean };
type SocialCrawlResponse =
| { success: true; data: any; pagination?: Page; credits_used: number; request_id: string }
| { success: false; error: { type: string; message: string; retryable: boolean }; request_id: string };
const sleep = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms));
// Exponential backoff with jitter: about 1 s, 2 s, then 4 s.
const backoffMs = (attempt: number) => 2 ** attempt * 1000 * (0.5 + Math.random() / 2);
async function socialcrawl(url: URL) {
// One Idempotency-Key per request, reused on every retry, so a retried call is never charged twice.
const idempotencyKey = crypto.randomUUID();
for (let attempt = 0; ; attempt++) {
let res: Response;
let body: SocialCrawlResponse;
try {
res = await fetch(url, {
headers: {
"x-api-key": API_KEY,
"Idempotency-Key": idempotencyKey,
},
signal: AbortSignal.timeout(TIMEOUT_MS),
});
body = (await res.json()) as SocialCrawlResponse;
} catch (error) {
// A timeout, a dropped connection or a non-JSON gateway page: retry with the same key.
if (attempt >= MAX_RETRIES) throw error;
await sleep(backoffMs(attempt));
continue;
}
if (body.success) return body;
// Branch on error.type, never on the message text.
if (body.error.type === "RESOURCE_NOT_FOUND") return null; // refunded: nothing to read
const retryAfter = res.headers.get("Retry-After");
// SERVICE_UNAVAILABLE without Retry-After is a withdrawn endpoint: permanent.
const permanent = body.error.type === "SERVICE_UNAVAILABLE" && retryAfter === null;
if (!body.error.retryable || permanent || attempt >= MAX_RETRIES) {
throw new Error(`${body.error.type}: ${body.error.message} (request_id ${body.request_id})`);
}
// Retry-After (seconds) wins; otherwise back off.
await sleep(retryAfter ? Number(retryAfter) * 1000 : backoffMs(attempt));
}
}
const url = new URL("https://www.socialcrawl.dev/v1/linkedin/article");
url.searchParams.set("url", "https://www.linkedin.com/pulse/hidden-costs-unreliable-electricity-bill-gates/");
const body = await socialcrawl(url);
if (body) console.log(body.data);Parameters
| Parameter | Required | Description |
|---|---|---|
| url | Yes | Full URL of the LinkedIn Pulse article. |
What does the LinkedIn Article API return?
Every response follows one unified schema. Here is a real, unmodified response body, so you can see the exact fields you get back before spending a credit.
Example response
{
"success": true,
"platform": "linkedin",
"endpoint": "/v1/linkedin/article",
"data": {
"post": {
"id": "6564211257702965248",
"url": "https://www.linkedin.com/pulse/hidden-costs-unreliable-electricity-bill-gates/",
"content": {
"text": "The hidden costs of unreliable electricity\n\nThink back to the last time you experienced a power outage.\n\nIt probably wasn’t a great memory. Maybe it involved spending the evening in the dark without anything to do or spending a hot day without air conditioning. If the power was out for a long time, maybe even the food in your fridge began to spoil.\n\nYour power probably came back within a couple minutes or hours. But for the nearly 1 billion people around the world who don’t have access to electricity—or whose access is so unreliable that they can never count on having power—an outage can go on for days or even weeks. And these outages are more than just an inconvenience. They can be deadly.\n\nNOTE: This is a virtual reality film that you can view using a VR headset, or in your browser as a 360° video. Learn more →\n\nMany people without reliable access to electricity live in rural villages where even health clinics can’t count on having power. After an outage, doctors sometimes have no way of telling whether the life-saving vaccines in their refrigerators have spoiled. It can be even more stressful if a power outage occurs at night. Sometimes health workers have no choice but to treat patients by candlelight, or by the light of a mobile phone.\n\nEven recharging a mobile phone is tricky when there isn’t electricity at home. It requires walking to a local store and paying 25 cents or more to plug the phone into a solar-powered outlet. That cost adds up fast. It’s actually hundreds of times more expensive to use charging stations than it is to charge a phone at home. But those without electricity don’t have an alternative. Mobile phones enable families to access services and business opportunities that improve their lives, so many pay whatever they have to in order to use their phones.\n\nThese hidden expenses are a daily reality for the nearly 1 billion people who live in energy poverty. That’s one reason why increasing access to electricity is critical to lifting the world’s poor out of poverty. The good news is that, since 2016, the number of people living without reliable electricity has dropped by more than 200 million. That’s two hundred million more people who can now study after sundown, use electronic appliances, and charge their phones at home.\n\nAt the same time, increased energy consumption means increased greenhouse gas emissions. Methods of generating electricity like coal and natural gas generate carbon dioxide, so unless we decarbonize the way we produce energy, emissions will continue to increase—and climate change will get worse—as energy consumption goes up.\n\nThe problem is that many of today’s low carbon energy technologies aren’t a viable alternative yet. While deploying wind and solar in many places around the world is going to be hugely important for tackling climate change, we need innovation in things like storage to make them realistic solutions for the world’s poorest. Plus, many people experiencing energy poverty live in areas without access to the kind of grids that are needed to make those technologies cheap and reliable enough to replace fossil fuels.\n\nIt’s important to remember that, even with an uptick in energy usage, people living in level 1 and 2 countries are responsible for a pretty modest share of the world’s emissions. If we’re going to stop climate change, the biggest changes will need to come from level 3 and 4 countries. But I believe we can tackle energy poverty and climate change at the same time by developing ways to make clean energy cheaper to produce, store, and transport. I recently wrote about several promising new solutions.\n\nWe want everyone—including the world’s poorest—to have access to cheap, reliable energy. I’m hopeful that innovations in energy technology will help us achieve that while paving the way to a zero-carbon future.\n\nThis originally appeared on gatesnotes.com.",
"media_urls": "https://media.licdn.com/dms/image/v2/C4E12AQEvwyjDskLgtA/article-cover_image-shrink_720_1280/article-cover_image-shrink_720_1280/0/1565029982281?e=1795046400&v=beta&t=IeyivRN6Y301HYkCc5h8VdI_cofs6JFPUvar1V0oXgc",
"thumbnail_url": "https://media.licdn.com/dms/image/v2/C4E12AQEvwyjDskLgtA/article-cover_image-shrink_720_1280/article-cover_image-shrink_720_1280/0/1565029982281?e=1795046400&v=beta&t=IeyivRN6Y301HYkCc5h8VdI_cofs6JFPUvar1V0oXgc",
"duration_seconds": null
},
"author": {
"username": "williamhgates",
"display_name": "Bill Gates",
"avatar_url": "https://media.licdn.com/dms/image/v2/D5603AQF-RYZP55jmXA/profile-displayphoto-shrink_800_800/B56ZRi8g.aGsAc-/0/1736826818808?e=1795046400&v=beta&t=vjlWDhSquN3IE4WjUEIKTJrzCrKe3O8jGgYhBd69uZs",
"verified": null
},
"engagement": {
"views": null,
"likes": 38069,
"comments": 1188,
"shares": 0,
"saves": null
},
"flags": {
"nsfw": null,
"spoiler": null,
"pinned": null,
"deleted": false
},
"published_at": "2019-08-05T18:42:03.000Z",
"ext": {
"author_id": "251749025",
"author_url": "https://www.linkedin.com/in/williamhgates",
"hashtags": null,
"mentions": null,
"reaction_counts": [
{
"count": 35672,
"type": "LIKE"
},
{
"count": 1175,
"type": "INTEREST"
}
],
"activity_id": "6564213787166076928",
"published_at_precision": null,
"author_urn": "ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc",
"author_headline": "Chair, Gates Foundation and Founder, Breakthrough Energy",
"author_type": "user"
}
},
"computed": {
"engagement_rate": null,
"language": "en",
"content_category": "entertainment",
"estimated_reach": null
}
},
"credits_used": 5,
"request_id": "req_example000000",
"cached": false,
"credits_remaining": 9999,
"source": "captured",
"captured_at": "2026-11-02T01:00:03.732Z",
"redacted": true
}Live sample illustrating the unified response shape. Field values reflect the record you query.
How does the LinkedIn Article API work?
Send a GET request with your API key and get back clean, structured JSON in our unified schema. Supported computed fields are populated when the source provides the required inputs.
Method
GET
Response
JSON
How do you scrape social media data in seconds?
The fastest social media scraping API for developers. Scrape profiles, posts, comments, and analytics from 69 platforms covering 10B+ monthly active users.
One schema, every platform
Query 69 platforms with identical response structures. Write your integration once.
Computed fields, not just scraped
When an endpoint supports these metrics and the source provides the required inputs, the normalized record includes engagement_rate, estimated_reach, content_category, and language. Ready to use.
See your data before you code
Visual Data Explorer. Paste any URL, get rich result cards, sortable tables, CSV export.
import requests
response = requests.get(
'https://www.socialcrawl.dev/v1/tiktok/profile',
params={'handle': 'charlidamelio'},
headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json(){
"success": true,
"platform": "tiktok",
"data": {
"author": {
"username": "charlidamelio",
"followers": 152400000
},
"engagement": {
"likes": 12400000000,
"engagement_rate": 0.087
},
"metadata": {
"language": "en",
"content_category": "lifestyle"
}
}
}Have a question? We got answers
Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.
Contact usWhat does the LinkedIn Article API return?
When should I use the LinkedIn Article endpoint?
How much does the LinkedIn Article API cost?
What parameters does the LinkedIn Article API need?
How do I call the LinkedIn Article API?
Ask AI about SocialCrawl
Ready to scrape LinkedIn Article data?
Get your API key and start pulling LinkedIn data in under 60 seconds.
