---
title: "Get someone's recent posts"
method: POST
path: "/v1/actions/get_recent_posts"
tags: ["Posts"]
---

# Get someone's recent posts

`POST /v1/actions/get_recent_posts`

## Request

- Base URL: `https://api.heyreagent.com`
- URL: `https://api.heyreagent.com/v1/actions/get_recent_posts`
- Auth: HTTP bearer

Read one person's latest posts, through a shared account.

Pass profileUrl or providerId, one of them. providerId is faster: a link is first resolved to an id.

People only. For a company page use list_posts_by_author with isCompany true.

A post here has no socialId: pass its url to get_post, or straight to comment_on_post and react_to_post.

Docs: https://heyreagent.com/docs/actions/get_recent_posts

## Request body

- object
  - `profileUrl` string: LinkedIn profile URL of the person, e.g. a linkedinUrl from search_people_sales_navigator ("https://linkedin.com/in/…").
  - `providerId` string: The person's providerId from search_people_sales_navigator (an ACwAA… id). Faster than profileUrl — skips the profile-resolution lookup.
  - `limit` number: Max recent posts to return (1–20, default 2: the newest plus a backup is usually all a personalized opener needs).

## Response `200`

It worked. Inside result: returned, source, posts, note.

- Worked
  - `ok` true, required
  - `result` object, required: What was asked for. A field that does not apply is left out, or is null.

## Other responses

- `default`: It did not work. The message says why, in plain English.

---

[API](https://skmtc.dev/heyreagent/apis/heyreagent-api.md) · [All operations](https://skmtc.dev/heyreagent/apis/heyreagent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/heyreagent/apis/heyreagent-api/revisions/917360c5f841?raw)