Post
Search Posts
POST
/search-posts$0.009/calljson responserest · mcp
01// about this endpoint
Search LinkedIn posts by keywords, hashtags, and content filters. Discover trending professional discussions, monitor brand mentions, and track industry conversations at scale. Essential for social listening, content intelligence, and trend analysis workflows.
02// code samples
Call it over REST
Authenticate with a bearer token against https://api.superagnt.com. Swap the placeholders for your key and parameter values.
curlbash
curl -s -X POST "https://api.superagnt.com/search-posts" \
-H "Authorization: Bearer <YOUR_AGNTDATA_API_KEY>" \
-H "Content-Type: application/json" \
-d '{ "keyword": "<string>", "sortBy": "<string>" }'03// give it to your agent
Copy-paste prompt
Paste this into a coding agent. It connects the superagnt MCP server, finds the tool data_linkedin_search_posts, and runs a first call — with the REST fallback if MCP is unavailable.
agent prompttext
You are wiring up the superagnt "LinkedIn" API to use this endpoint: Search Posts.
1. CONNECT over MCP (preferred). No token to paste either way.
On Claude (claude.ai, the desktop app, or Claude Code signed in with a Claude
account), the server is a connector: give the user this link, they click Add
and approve:
https://claude.ai/customize/connectors/yours?modal=add-custom-connector&connectorName=superagnt&connectorUrl=https%3A%2F%2Fmcp.superagnt.com%2Fmcp&open_in_browser=1
Any other MCP client (or Claude Code signed in with an API key): add the server
and let the client run the browser sign-in:
claude mcp add --scope user --transport http superagnt https://mcp.superagnt.com/mcp
claude mcp login superagnt
MCP endpoint: https://mcp.superagnt.com/mcp
After connecting, the tool you want is named exactly:
data_linkedin_search_posts
Call agnt_tools_search or agnt_tools_list_enabled to confirm it is available.
2. REST fallback (if you are not using MCP):
POST https://api.superagnt.com/search-posts
Header: Authorization: Bearer <YOUR_AGNTDATA_API_KEY>
Required parameters:
- (none)
Optional parameters:
- keyword (string, optional)
- sortBy (string, optional)
- datePosted (string, optional)
- page (integer, optional)
- contentType (string, optional)
- fromMember (array, optional)
- fromCompany (array, optional)
- mentionsMember (array, optional)
- mentionsOrganization (array, optional)
- authorIndustry (array, optional)
- authorCompany (array, optional)
- authorTitle (string, optional)
3. COST & KEY. Each successful call costs $0.009 in credits. Only successful calls are charged.
Get a superagnt API key at https://app.superagnt.com.
4. TEST. Connect the server (or set the key), discover the tool
(data_linkedin_search_posts), run one minimal call with just the required parameters,
and report back the shape of the JSON response (top-level fields).
Reference (machine-readable variant): https://www.superagnt.com/docs/apis/social/linkedin/endpoints/Search_Posts.mdmcp tool definitionjson
{
"name": "search_posts",
"description": "Search Posts",
"parameters": {
"type": "object",
"properties": {
"keyword": {
"type": "string"
},
"sortBy": {
"type": "string"
},
"datePosted": {
"type": "string"
},
"page": {
"type": "integer"
},
"contentType": {
"type": "string"
},
"fromMember": {
"type": "array",
"items": {
"type": "string"
}
},
"fromCompany": {
"type": "array",
"items": {
"type": "integer"
}
},
"mentionsMember": {
"type": "array",
"items": {
"type": "string"
}
},
"mentionsOrganization": {
"type": "array",
"items": {
"type": "integer"
}
},
"authorIndustry": {
"type": "array",
"items": {
"type": "integer"
}
},
"authorCompany": {
"type": "array",
"items": {
"type": "integer"
}
},
"authorTitle": {
"type": "string"
}
},
"required": []
}
}04// parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
keyword | body | string | optional | |
sortBy | body | string | optional | |
datePosted | body | string | optional | |
page | body | integer | optional | |
contentType | body | string | optional | |
fromMember | body | array | optional | |
fromCompany | body | array | optional | |
mentionsMember | body | array | optional | |
mentionsOrganization | body | array | optional | |
authorIndustry | body | array | optional | |
authorCompany | body | array | optional | |
authorTitle | body | string | optional |
05// responses
200
200json
{
"type": "object",
"properties": {
"success": {
"type": "boolean"
},
"message": {
"type": "string"
},
"data": {
"type": "object",
"properties": {
"total": {
"type": "integer"
},
"count": {
"type": "integer"
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"urn": {
"type": "string"
},
"url": {
"type": "string"
},
"template": {
"type": "string"
},
"text": {
"type": "string"
},
"postedAt": {
"type": "string"
},
"postedDate": {
"type": "string"
},
"postedDateTimestamp": {
"type": "integer"
},
"reposted": {
"type": "boolean"
},
"resharedPost": {
"type": "object"
},
"video": {
"type": "object",
"properties": {
"thumbnails": {
"type": "null"
},
"video": {
"type": "null"
}
}
},
"entity": {
"type": "object"
},
"article": {
"type": "object"
},
"object": {
"type": "object"
},
"author": {
"type": "object",
"properties": {
"fullName": {
"type": "string"
},
"headline": {
"type": "string"
},
"username": {
"type": "string"
},
"url": {
"type": "string"
},
"profilePictures": {
"type": "array",
"items": {
"type": "object",
"properties": {
"width": {
"type": "integer"
},
"height": {
"type": "integer"
},
"url": {
"type": "string"
}
}
}
},
"type": {
"type": "string"
}
}
},
"socialActivityCountsInsight": {
"type": "object",
"properties": {
"numComments": {
"type": "integer"
},
"likeCount": {
"type": "integer"
},
"appreciationCount": {
"type": "integer"
},
"empathyCount": {
"type": "integer"
},
"InterestCount": {
"type": "integer"
},
"praiseCount": {
"type": "integer"
},
"funnyCount": {
"type": "integer"
},
"maybeCount": {
"type": "integer"
},
"totalReactionCount": {
"type": "integer"
}
}
}
}
}
}
}
}
}
}06// pricing
$0.009per successful request
Credits are deducted from your superagnt balance on each successful call. Failed requests (4xx/5xx) are not charged.
Get started at app.superagnt.com.
08// more from LinkedIn
GETGet Company By Domain/get-company-by-domainGETGet Company Details by ID/get-company-details-by-idGETGet Company Details/get-company-detailsPOSTGet Profile School Interests/profiles/interests/schoolsPOSTGet Profile Newsletter Interests/profiles/interests/newslettersGETGet Similar Profiles/similar-profiles
start calling
Point your client at https://mcp.superagnt.com/mcp and your agent has this endpoint, plus every other source on one balance.
LinkedIn post search APIsocial listening APIprofessional content searchLinkedIn monitoring APILinkedIn APILinkedIn data APILinkedIn scraper API