Search LinkedIn posts

Try in Playground

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

GET/v1/linkedin/search/postsx-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

querystringrequiredquery

Keyword or phrase, 1–200 characters.

min 1 chars · max 200 chars

Exampleai agents

date_postedenumquery

last-hour, last-day, last-week, last-month or last-year. When the fallback search index serves the request, last-hour is applied at day granularity with a warning.

one of: last-hour, last-day, last-week, last-month, last-year

Examplelast-month

cursorstringquery

Next page number when another page may exist.

sincenumber | stringquery

Earliest publication time to include, ISO 8601 or Unix seconds. Not combinable with date_posted.

untilnumber | stringquery

Publication time to stop before, ISO 8601 or Unix seconds; later than since.

Response fields

requestIdstring

Operational correlation UUID.

Search request plus one page (and document manifests) per result.

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

Search index endpoint used for discovery; posts are read from www.linkedin.com.

absolute HTTPS URL

fetchedAtstring

UTC retrieval time.

Source is web_search; order is relevance. web_index_selection: results are the search index's selection, not every matching post. post_unavailable marks result pages that could not be read.

coverage.sourceenum

Always included.

one of: public_page, web_search

coverage.completeboolean

Always included.

coverage.warningsstring[]

Always included.

coverage.orderenumoptional

Optional.

one of: newest_first, oldest_first, ranked, relevance, source_order

Optional.

coverage.window.sincestringoptional

Optional.

coverage.window.untilstringoptional

Optional.

querystring

Keyword or phrase, 1–200 characters.

Up to ten posts with the post endpoint shape; can be empty when a window removes a page's results.

up to 10 items

posts.urlstring

Always included.

absolute HTTPS URL

posts.namestringoptional

Optional.

posts.thumbnailUrlstringnullableoptional

Optional.

posts.headlinestringnullableoptional

Optional.

posts.commentCountnumbernullable

Always included.

posts.likeCountnumbernullable

Always included.

posts.datePublishedstringnullable

Always included.

posts.uploadDatestringnullableoptional

Optional.

posts.descriptionstring

Always included.

posts.transcriptstringnullableoptional

Optional.

posts.mediastringnullableoptional

Optional.

posts.imagesstring[]optional

Optional.

posts.imagestringnullableoptional

Optional.

Always included.

posts.author.namestring

Always included.

posts.author.urlstringnullable

Always included.

posts.author.imagestringoptional

Optional.

posts.author.followersnumbernullable

Always included.

up to 100 items

posts.comments.authorstring

Always included.

posts.comments.textstring

Always included.

posts.comments.linkedinUrlstringnullable

Always included.

posts.comments.datePublishedstringnullable

Always included.

posts.comments.publishedTimeAgostringnullable

Always included.

posts.comments.urnstringnullable

Always included.

posts.comments.idstringnullable

Always included.

posts.comments.reactionCountnumbernullable

Always included.

posts.moreArticlesobject[]optional

Optional.

up to 100 items

cursorstringoptional

Next page number when another page may exist.

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/search/posts?query=ai+agents&date_posted=last-month" \
  -H "x-api-key: YOUR_API_KEY"

const response = await fetch(
  "https://api.scrapeatlas.com/v1/linkedin/search/posts?query=ai+agents&date_posted=last-month",
  {
    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/search/posts?query=ai+agents&date_posted=last-month",
  {
    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/search/posts",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "query": "ai agents",
        "date_posted": "last-month"
    },
    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/search/posts?query=ai+agents&date_posted=last-month", 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/search/posts?query=ai+agents&date_posted=last-month"))
            .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": "partial",
  "requestId": "00000000-0000-4000-8000-000000000004",
  "sourceUrl": "https://google.serper.dev/search",
  "fetchedAt": "2026-09-11T00:00:00.000Z",
  "coverage": {
    "source": "web_search",
    "complete": false,
    "warnings": [
      "web_index_selection"
    ],
    "order": "relevance"
  },
  "accounting": {
    "upstreamRequests": 11,
    "responseBytes": 3600000,
    "durationMs": 9000
  },
  "query": "ai agents",
  "posts": [
    {
      "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": "https://media.licdn.com/dms/image/v2/example/feedshare-shrink_800",
      "images": [
        "https://media.licdn.com/dms/image/v2/example/feedshare-shrink_800"
      ],
      "image": "https://media.licdn.com/dms/image/v2/example/feedshare-shrink_800",
      "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",
          "datePublished": "2025-05-14T03:08:48.305Z",
          "publishedTimeAgo": "1y",
          "urn": "urn:li:comment:(urn:li:activity:7328088180820193281,7328254932514451456)",
          "id": "7328254932514451456",
          "reactionCount": 3
        }
      ],
      "likeCount": 172,
      "commentCount": 45
    }
  ],
  "cursor": "2"
}

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."
  }
}