PERSON ACTIVITY API

What a Person Posts and Engages With

Send a profile URL and get their recent posts and reposts as JSON, with text, attachments, mentions and reaction counts. Set type to read the posts they commented on, the posts they reacted to, or their articles.

POST/api/v1/person/activity

{
  "cursor": "eyJjb3VudCI6MTAwLCJzdGFydCI6MTAw...",
  "message": [
    {
      "activity_type": "Post",
      "created_at": "2025-12-05T22:37:37.579Z",
      "likes": 110,
      "comments": 0
    }
  ]
}

What is the Datamagnet Person Activity API?

The Datamagnet Person Activity API returns a person's recent activity from their public profile URL as structured JSON. By default it lists their posts and reposts; the type parameter switches to posts they commented on, posts they reacted to, or their articles. Each item carries the text, author, attachments, mentions and reaction counts, and a cursor pages through the rest.

Input
Profile URL
Cost
10 credits per page
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/person/activity
  • Input: Profile URL
  • Cost: 10 credits per page
POST /api/v1/person/activity
curl -X POST \
  "https://api.datamagnet.co/api/v1/person/activity" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.linkedin.com/in/gouldjames", "type": "posts"}'

→ 200 OK · 10 credits

{  "cursor": "eyJjb3VudCI6MTAwLCJzdGFydCI6MTAw...",  "message": [    {      "activity_type": "Post",      "text": "Some great words from Alison Bunnell...",      "created_at": "2025-12-05T22:37:37.579Z",      "likes": 110,      "shares": 0,      "reactions": [{ "count": 73, "reaction_type": "LIKE" }, ...],      "shared_post": {...}    }  ]}

What you get

The main fields in the response. The Person Activity reference documents every field.

FieldTypeDescription
activity_typestring"Post" or "Repost". A repost carries only a shared_post object.
textstringText of the post.
created_atstringISO 8601 time the post was created.
urlstringLink to the post.
authorobjectName, headline, username, profile URL, type ("Member" or "Company") and URN of the author.
attachmentsarrayArticles, images, videos and documents attached to the post.
likes, comments, sharesnumberEngagement counts on the post.
reactionsarrayReaction counts by type: LIKE, PRAISE, EMPATHY, INTEREST and others.
mentionsarrayPeople and companies tagged in the post, by URN.
jobobject | nullThe job a post shares: title, company, location, workplace type and link.
shared_postobjectThe original post when the activity reshares one.
cursorstringToken for the next page. Keep requesting until a page comes back empty or without one.

Use cases

Personalise outreach

Read what a prospect posted this month before you write to them, and open with the topic they care about instead of a template.

Follow buyers and champions

Pull the posts a set of people commented on or reacted to, and see which vendors, topics and peers they engage with.

Spot hiring posts

A post that shares a job carries a job object with the title, hiring company, location and link, so hiring announcements are easy to filter out of a feed.

Frequently asked questions

10 credits per successful request, and each request returns one page of activity. A temporary failure is not charged, and neither is the final empty page at the end of a list. A profile that does not exist is answered with error_code profile_not_found and is charged like a successful request.

Set type to posts (the default, the person's posts and reposts), comments (posts the person commented on), reactions (posts the person reacted to) or articles (articles the person published).

Send the cursor from each response as the cursor parameter of the next request. Page size varies up to about 100 items and a short page can appear mid-list, so keep requesting until a page comes back empty or without a cursor.

Yes, with a separate call to the People API, which returns the full profile for 1 credit. The activity endpoint returns posts and engagement, not the profile itself.

Read a person's activity with 10 free credits

No credit card required. Get an API key and pull your first page of activity in a few minutes.

  • 10 credits per page
  • Temporary failures are not charged
  • Posts, comments, reactions or articles

Interactive Demo

~15 minutes

1

Get your API key

1 min
2

POST a profile URL

1 min
3

Page through with the cursor

Instant