100 free credits. No credit card required.Start building
Logo
LinkedIn logo
100 free credits. No credit card required

LinkedIn Article API

Returns one LinkedIn Pulse article: its text, author, like and comment counts, and publish time.

GET /v1/linkedin/article

Last 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

·TikTok logoTikTok·Instagram logoInstagram·YouTube logoYouTube·Facebook logoFacebook·X logoX·LinkedIn logoLinkedIn·Reddit logoReddit·Threads logoThreads·Pinterest logoPinterest·Twitch logoTwitch·Truth Social logoTruth Social·Snapchat logoSnapchat·Kick logoKick·Bluesky logoBluesky·Kwai logoKwai·Rumble logoRumble·Spotify logoSpotify·Apple Music logoApple Music·TikTok Shop logoTikTok Shop·Amazon Shop logoAmazon Shop·Google Shopping logoGoogle Shopping·Trustpilot logoTrustpilot·TripAdvisor logoTripAdvisor·Yelp logoYelp·Linktree logoLinktree·Komi logoKomi·Pillar logoPillar·lnk.bio logolnk.bio·Facebook Ads logoFacebook Ads·Google Ads logoGoogle Ads·LinkedIn Ads logoLinkedIn Ads·Google Search logoGoogle Search·Google News logoGoogle News·Finance logoFinance·Polymarket logoPolymarket·Tavily logoTavily·Hacker News logoHacker News·GitHub logoGitHub·Perplexity logoPerplexity·Naver logoNaver·Utility logoUtility·Universal Search logoUniversal Search
·TikTok logoTikTok·Instagram logoInstagram·YouTube logoYouTube·Facebook logoFacebook·X logoX·LinkedIn logoLinkedIn·Reddit logoReddit·Threads logoThreads·Pinterest logoPinterest·Twitch logoTwitch·Truth Social logoTruth Social·Snapchat logoSnapchat·Kick logoKick·Bluesky logoBluesky·Kwai logoKwai·Rumble logoRumble·Spotify logoSpotify·Apple Music logoApple Music·TikTok Shop logoTikTok Shop·Amazon Shop logoAmazon Shop·Google Shopping logoGoogle Shopping·Trustpilot logoTrustpilot·TripAdvisor logoTripAdvisor·Yelp logoYelp·Linktree logoLinktree·Komi logoKomi·Pillar logoPillar·lnk.bio logolnk.bio·Facebook Ads logoFacebook Ads·Google Ads logoGoogle Ads·LinkedIn Ads logoLinkedIn Ads·Google Search logoGoogle Search·Google News logoGoogle News·Finance logoFinance·Polymarket logoPolymarket·Tavily logoTavily·Hacker News logoHacker News·GitHub logoGitHub·Perplexity logoPerplexity·Naver logoNaver·Utility logoUtility·Universal Search logoUniversal Search
·TikTok logoTikTok·Instagram logoInstagram·YouTube logoYouTube·Facebook logoFacebook·X logoX·LinkedIn logoLinkedIn·Reddit logoReddit·Threads logoThreads·Pinterest logoPinterest·Twitch logoTwitch·Truth Social logoTruth Social·Snapchat logoSnapchat·Kick logoKick·Bluesky logoBluesky·Kwai logoKwai·Rumble logoRumble·Spotify logoSpotify·Apple Music logoApple Music·TikTok Shop logoTikTok Shop·Amazon Shop logoAmazon Shop·Google Shopping logoGoogle Shopping·Trustpilot logoTrustpilot·TripAdvisor logoTripAdvisor·Yelp logoYelp·Linktree logoLinktree·Komi logoKomi·Pillar logoPillar·lnk.bio logolnk.bio·Facebook Ads logoFacebook Ads·Google Ads logoGoogle Ads·LinkedIn Ads logoLinkedIn Ads·Google Search logoGoogle Search·Google News logoGoogle News·Finance logoFinance·Polymarket logoPolymarket·Tavily logoTavily·Hacker News logoHacker News·GitHub logoGitHub·Perplexity logoPerplexity·Naver logoNaver·Utility logoUtility·Universal Search logoUniversal Search
·TikTok logoTikTok·Instagram logoInstagram·YouTube logoYouTube·Facebook logoFacebook·X logoX·LinkedIn logoLinkedIn·Reddit logoReddit·Threads logoThreads·Pinterest logoPinterest·Twitch logoTwitch·Truth Social logoTruth Social·Snapchat logoSnapchat·Kick logoKick·Bluesky logoBluesky·Kwai logoKwai·Rumble logoRumble·Spotify logoSpotify·Apple Music logoApple Music·TikTok Shop logoTikTok Shop·Amazon Shop logoAmazon Shop·Google Shopping logoGoogle Shopping·Trustpilot logoTrustpilot·TripAdvisor logoTripAdvisor·Yelp logoYelp·Linktree logoLinktree·Komi logoKomi·Pillar logoPillar·lnk.bio logolnk.bio·Facebook Ads logoFacebook Ads·Google Ads logoGoogle Ads·LinkedIn Ads logoLinkedIn Ads·Google Search logoGoogle Search·Google News logoGoogle News·Finance logoFinance·Polymarket logoPolymarket·Tavily logoTavily·Hacker News logoHacker News·GitHub logoGitHub·Perplexity logoPerplexity·Naver logoNaver·Utility logoUtility·Universal Search logoUniversal Search
LinkedIn API

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

ParameterRequiredDescription
urlYesFull URL of the LinkedIn Pulse article.
Example Response

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.

API Details

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

Why SocialCrawl

Why use SocialCrawl for LinkedIn Article data?

We handle the complexity of LinkedIn data extraction so you can focus on building. Unified schema, AI enrichment, and zero platform logic in your code.

Developer First

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()
[ .JSON ]
{
  "success": true,
  "platform": "tiktok",
  "data": {
    "author": {
      "username": "charlidamelio",
      "followers": 152400000
    },
    "engagement": {
      "likes": 12400000000,
      "engagement_rate": 0.087
    },
    "metadata": {
      "language": "en",
      "content_category": "lifestyle"
    }
  }
}
+ 69 platforms
FAQ

Have a question? We got answers

Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.

Contact us
What does the LinkedIn Article API return?
Returns one LinkedIn Pulse article: its text, author, like and comment counts, and publish time. The response uses the same JSON envelope as every SocialCrawl endpoint, with the data, credits_used and request_id fields.
When should I use the LinkedIn Article endpoint?
Use it when you have a /pulse/ URL. Comments and reactions are article/comments and article/reactions.
How much does the LinkedIn Article API cost?
Each call costs 5 credits, so the 100 free credits every new account gets cover 20 calls. Credits for failed or empty calls are refunded automatically, and there is no subscription.
What parameters does the LinkedIn Article API need?
The one required parameter is url (full URL of the LinkedIn Pulse article).
How do I call the LinkedIn Article API?
Send a GET request to https://www.socialcrawl.dev/v1/linkedin/article?url=https%3A%2F%2Fwww.linkedin.com%2Fpulse%2Fhidden-costs-unreliable-electricity-bill-gates%2F with your API key in the x-api-key header. An Authorization: Bearer header works too.

Ask AI about SocialCrawl

Ready to scrape LinkedIn Article data?

Get your API key and start pulling LinkedIn data in under 60 seconds.

Start for free

🤖 AI agent or LLM? Read this page as markdown