POST SEARCH API
Search Posts by Keyword and Date
Search posts by keyword and narrow by date posted, content type, the author’s job title or the companies a post mentions. Get each match with text, author, publish time and engagement counts.
POST/api/v1/post/search
{
"status": "ok",
"data": {
"count": 10,
"total": 231,
"items": [
{ "url": "...", "text": "...", "author": {...} }
]
}
}What is the Datamagnet Post Search API?
The Datamagnet Post Search API finds posts on the professional network by keyword and returns them as structured JSON. Filters narrow results by date posted, content type, the author’s job title and the companies a post mentions, sorted by relevance or date. Each result includes the post text, URL, author, publish time and reaction and comment counts.
- Input
- Keyword and filters
- Cost
- 10 credits per search
- Freshness
- Live at request time
One request
Authenticate with your API key as a bearer token and send a JSON body. This is the request behind the sample response.
POST /api/v1/post/search- Input: Keyword and filters
- Cost: 10 credits per search
curl -X POST \
"https://api.datamagnet.co/api/v1/post/search" \
-H "Authorization: Bearer {token}" \
-H "Content-Type: application/json" \
-d '{"keyword": "microsoft", "date_posted": "past-week", "sort_by": "date_posted"}'→ 200 OK · 10 credits
{ "status": "ok", "data": { "count": 10, "total": 231, "items": [ { "url": "https://www.linkedin.com/posts/...", "text": "...", "posted_date": "2026-04-12 09:02:30.845 +0000 UTC", "author": { "full_name": "...", "headline": "...", "url": "..." }, "social_activity_counts_insight": { "total_reaction_count": 0, "num_comments": 0, ... } } ] }}
What you get
The main fields in the response. The Post Search reference documents every field.
| Field | Type | Description |
|---|---|---|
url | string | Direct link to the post. |
text | string | Text of the post. |
posted_date | string | UTC time the post was published. posted_date_timestamp holds it in milliseconds. |
reposted | boolean | Whether the result is a repost. |
author | object | Full name, username, headline, profile URL, URN and member id of the author. |
social_activity_counts_insight | object | Total reactions, counts per reaction type and number of comments. |
video | object | Duration, thumbnails and streams, when the post has a video. |
urn, share_urn | string | Identifiers of the post. |
total | integer | Total number of matching posts. |
count | integer | Number of results on this page. |
Use cases
Monitor a topic
Search a keyword with date_posted set to past-24h or past-week and sort_by date_posted to collect what was published on it recently.
Find posts about a company
Pass company ids in mentions_organization to return only posts that mention those companies, such as your brand or a competitor.
Hear from a role
Set author_title to CTO or Head of Sales to see what people in that role post about a keyword, then pull the engagement on the posts that matter.
Frequently asked questions
Run your first post search with 10 free credits
No credit card required. Get an API key and search posts on any topic in a few minutes.
- 10 credits per search
- Filter by date, type and author title
- Results as JSON
Interactive Demo
~15 minutes
Get your API key
1 minPOST a keyword and filters
1 minUse the results
Instant