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
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.
| Field | Type | Description |
|---|---|---|
activity_type | string | "Post" or "Repost". A repost carries only a shared_post object. |
text | string | Text of the post. |
created_at | string | ISO 8601 time the post was created. |
url | string | Link to the post. |
author | object | Name, headline, username, profile URL, type ("Member" or "Company") and URN of the author. |
attachments | array | Articles, images, videos and documents attached to the post. |
likes, comments, shares | number | Engagement counts on the post. |
reactions | array | Reaction counts by type: LIKE, PRAISE, EMPATHY, INTEREST and others. |
mentions | array | People and companies tagged in the post, by URN. |
job | object | null | The job a post shares: title, company, location, workplace type and link. |
shared_post | object | The original post when the activity reshares one. |
cursor | string | Token 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
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
Get your API key
1 minPOST a profile URL
1 minPage through with the cursor
Instant