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
POST /api/v1/post/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.

FieldTypeDescription
urlstringDirect link to the post.
textstringText of the post.
posted_datestringUTC time the post was published. posted_date_timestamp holds it in milliseconds.
repostedbooleanWhether the result is a repost.
authorobjectFull name, username, headline, profile URL, URN and member id of the author.
social_activity_counts_insightobjectTotal reactions, counts per reaction type and number of comments.
videoobjectDuration, thumbnails and streams, when the post has a video.
urn, share_urnstringIdentifiers of the post.
totalintegerTotal number of matching posts.
countintegerNumber 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

10 credits per search, and each request returns one page of results.

keyword, date_posted (past-24h, past-week or past-month), content_type (photos, videos, jobs, liveVideos or documents), author_title, and mentions_organization, an array of company ids. sort_by takes relevance (the default) or date_posted.

Increase page, starting from 1. Each response gives count for the page and total for all matching posts.

Yes. Each result carries its post url. Pass it to the Post Comments or Post Reactions endpoint to list the people behind the engagement.

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

1

Get your API key

1 min
2

POST a keyword and filters

1 min
3

Use the results

Instant