Search Posts
GET/v1/linkedin/search/posts1 credit
Searches the web for LinkedIn posts matching a query and returns each hit in the same shape as a feed post from `/v1/linkedin/post`.
01Query parameters
| Name | Type | Description |
|---|---|---|
| queryrequired | string | The search text, e.g. `ai agents`. |
| date_postedoptional | string | Limits results to posts from this period.Accepted values:last-hourlast-daylast-weeklast-monthlast-year |
| cursoroptional | string | The page number to fetch, up to 11: pass the `cursor` of the previous answer.Default: 1 |
02Request
curl "https://api.scrapesocial.ai/v1/linkedin/search/posts?query=ai+agents" \ -H "x-api-key: $SCRAPESOCIAL_KEY"
03Responses
Real answers from the API. Lists are shortened to 2 items.
GET /v1/linkedin/search/posts?query=ai%20agents
{
"success": true,
"credits_remaining": 4980,
"credits_charged": 1,
"query": "ai agents",
"posts": [
{
"activityUrn": "urn:li:activity:7315357847985233920",
"contentUrn": "urn:li:ugcPost:7314969666689409024",
"url": "https://www.linkedin.com/posts/jsu05_ai-agents-for-dummies-activity-7315357847985233920-OdO1",
"datePublished": "2025-04-08T13:00:23.706Z",
"description": "What are AI agents?\n\n(for dummies)\n\nAs someone with 0 technical background, I've found the best way to understand AI Agents is to build on concepts I already grasp.\n\nLevel 1️⃣ - Large Language Models\n\nLarge Language Models (LLMs) like ChatGPT are passive systems that generate outputs based on inputs but can't access external information or take autonomous actions.\n\nNote: Technically, ChatGPT is an…",
"media": "https://media.licdn.com/dms/image/v2/D561FAQEFe0kvOtJSyw/feedshare-document-images_1920/B56ZYP94OXHoAU-/1/1744024617941?e=1793836800&v=beta&t=FHM5hKRs6aM9a6g67t6JTQOwC1vIY2hfcMUq1TAr9OQ",
"images": [
"https://media.licdn.com/dms/image/v2/D561FAQEFe0kvOtJSyw/feedshare-document-images_1920/B56ZYP94OXHoAU-/1/1744024617941?e=1793836800&v=beta&t=FHM5hKRs6aM9a6g67t6JTQOwC1vIY2hfcMUq1TAr9OQ",
"https://media.licdn.com/dms/image/v2/D561FAQEFe0kvOtJSyw/feedshare-document-images_1920/B56ZYP94OXHoAU-/2/1744024617941?e=1793836800&v=beta&t=07z7Jg9ro-yGzLinMMIKQ-81O-x63jV9_MtlHucW0cU"
],
"image": "https://media.licdn.com/dms/image/v2/D561FAQEFe0kvOtJSyw/feedshare-document-images_1920/B56ZYP94OXHoAU-/1/1744024617941?e=1793836800&v=beta&t=FHM5hKRs6aM9a6g67t6JTQOwC1vIY2hfcMUq1TAr9OQ",
"author": {
"name": "Jeff Su",
"url": "https://www.linkedin.com/in/jsu05",
"image": "https://media.licdn.com/dms/image/v2/D5603AQEmYEH2_P8UzA/profile-displayphoto-shrink_200_200/profile-displayphoto-shrink_200_200/0/1711179090909?e=2147483647&v=beta&t=B1VHTnZSDoHv_R2q3nJ4nnVY9MNmH1Rf6cDd0axO3jU",
"followers": 99769
},
"comments": [
{
"author": "Varun Negandhi",
"text": "This post helps clarify the different levels, Jeff. For my gaming brain, it helps me understand that LLMs are NPCs (non-playable characters) that only respond when you press a button. AI agents are like friends you play multiplayer with, where they read and play the game to achieve a specific objective. ",
"linkedinUrl": "https://www.linkedin.com/in/vnegandhi"
},
{
"author": "Dean Moon",
"text": "Now on to the 1M followers on LinkedIn.",
"linkedinUrl": "https://au.linkedin.com/in/deanjmoon"
}
],
"likeCount": 642,
"commentCount": 96
},
{
"activityUrn": "urn:li:activity:7345117017508659200",
"contentUrn": "urn:li:share:7345117016170659840",
"url": "https://www.linkedin.com/posts/alexxubyte_systemdesign-coding-interviewtips-activity-7345117017508659200-1dyv",
"datePublished": "2025-06-29T15:52:42.621Z",
"description": "What is an AI Agent?\n\nAn AI agent is a software program that can interact with its environment, gather data, and use that data to achieve predetermined goals. AI agents can choose the best actions to perform to meet those goals.\n\nKey characteristics of AI agents are as follows:\n\nAn agent can perform autonomous actions without constant human intervention. Also, they can have a human in the loop to …",
"media": "https://media.licdn.com/dms/image/v2/D4E22AQGM0sDVYAT_ag/feedshare-shrink_800/B4EZe8Y9d9HIAg-/0/1751212357466?e=2147483647&v=beta&t=F85oOnNrdXB8XkKD1u4FNYxraq85iLV3FCbstQ20UAQ",
"images": [
"https://media.licdn.com/dms/image/v2/D4E22AQGM0sDVYAT_ag/feedshare-shrink_800/B4EZe8Y9d9HIAg-/0/1751212357466?e=2147483647&v=beta&t=F85oOnNrdXB8XkKD1u4FNYxraq85iLV3FCbstQ20UAQ"
],
"image": "https://media.licdn.com/dms/image/v2/D4E22AQGM0sDVYAT_ag/feedshare-shrink_800/B4EZe8Y9d9HIAg-/0/1751212357466?e=2147483647&v=beta&t=F85oOnNrdXB8XkKD1u4FNYxraq85iLV3FCbstQ20UAQ",
"author": {
"name": "Alex Xu",
"url": "https://www.linkedin.com/in/alexxubyte",
"followers": 1038321
},
"comments": [
{
"author": "Delisa Ondo Kéloufaï",
"text": "Conversational AI is impressive. But AI agents are game changers. They're not just programs that respond, they're entities that decide, learn, adapt and cooperate. We're moving from a passive tool to an autonomous strategic player, capable of taking initiatives, memorizing our preferences, reasoning in context and working in teams with other agents. For companies (the SMEs I support), the real iss…",
"linkedinUrl": "https://ca.linkedin.com/in/delisa-ondo-keloufai-marketing-inspire-btob/en"
},
{
"author": "A Mike",
"text": "Alex Xu This is a great breakdown of AI agents—thanks for sharing. What stands out to me is how the evolution from passive AI models to autonomous agents represents a significant shift in how we think about human-machine collaboration. The ability of AI agents to not only perceive and act but also reason, personalise, and collaborate opens up powerful new use cases—from dynamic supply chain orches…",
"linkedinUrl": "https://uk.linkedin.com/in/a-mike-380254213"
}
],
"likeCount": 3526,
"commentCount": 128
}
],
"cursor": "2"
}Common to every endpoint
Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.
GET /v1/cosmos/profile?handle=design
{
"success": false,
"message": "Invalid API key"
}04Notes
The answer has `query`, `posts` (up to 10 per page) and `cursor`, the next page number as a string. Results come from web search, so they depend on what search engines have indexed. No results returns `posts: []` for 0 credits. A cursor above 11 or an unknown `date_posted` is a free 400. Web search engines also answer loosely related pages when nothing matches, so only results that name the query's words (in their title, snippet or URL) are kept: a query nothing matches answers the empty list for 0 credits.
05Errors & credits
Every error has success: false, a real HTTP status and costs no credits.
400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.