Docs / Posts

`get_recent_posts`

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

This action only reads. It changes nothing, so it is safe to try.

What you give it

Input	What it is	Where to get it
`profileUrl` optional	A profile link or a public identifier. LinkedIn profile URL of the person, e.g. a linkedinUrl from search_people_sales_navigator ("https://linkedin.com/in/…").	Open the person's profile on LinkedIn and copy the address from your browser. It looks like https://www.linkedin.com/in/their-name Or run `search_people` and use `people[].profileUrl` from its answer. 37 more places to get it `search_linkedin_people` → `results[].publicIdentifier` `get_my_profile` → `accounts[].profileUrl` `list_connections` → `connections[].profileUrl` `list_sent_invitations` → `pendingInvitations[].profileUrl` `list_received_invitations` → `invitations[].profileUrl` `list_followers` → `followers[].profileUrl` `list_conversations` → `inbox[].participantProfileUrl` `list_chat_attendees` → `attendees[].profileUrl` `list_inmail` → `inmail[].participant.profileUrl` `search_posts` → `posts[].author.profileUrl` `search_linkedin_people` → `results[].publicProfileUrl` `search_linkedin_people` → `results[].profileUrl` `search_linkedin_sales_navigator_people` → `results[].publicProfileUrl` `who_is_waiting_on_me` → `waitingOnYou[].profileUrl` `who_went_cold` → `coldConversations[].profileUrl` `connections_never_messaged` → `leads[].profileUrl` `get_my_profile` → `accounts[].publicIdentifier` `list_sent_invitations` → `pendingInvitations[].publicIdentifier` `get_profile_details` → `publicProfileUrl` `get_conversation` → `participant.profileUrl` `list_chat_participants` → `participants[].profileUrl` `get_chat_attendee` → `profileUrl` `get_inmail_conversation` → `participant.profileUrl` `get_post_engagers` → `reactors[].linkedinUrl` `get_post_engagers` → `commenters[].linkedinUrl` `list_post_comments` → `comments[].authorDetails.profileUrl` `list_post_reactions` → `reactions[].author.profileUrl` `list_job_applicants` → `applicants[].publicProfileUrl` `get_job_applicant` → `publicProfileUrl` `engagers_not_connected` → `leads[].profileUrl` `get_profile_details` → `publicIdentifier` `get_post` → `author.publicIdentifier` `list_job_applicants` → `applicants[].publicIdentifier` `search_people_sales_navigator` → `leads[].linkedinUrl` `find_decision_makers` → `leads[].linkedinUrl` `search_people_sales_navigator` → `leads[].publicIdentifier` `find_decision_makers` → `leads[].publicIdentifier`
`providerId` optional	A member id or a Sales Navigator id. The person's providerId from search_people_sales_navigator (an ACwAA… id). Faster than profileUrl — skips the profile-resolution lookup.	Run `get_profile_details` and use `providerId` from its answer. 22 more places to get it `search_linkedin_sales_navigator_people` → `results[].id` `get_my_profile` → `accounts[].providerId` `list_sent_invitations` → `pendingInvitations[].providerId` `list_chats` → `chats[].attendeeProviderId` `list_messages` → `messages[].senderId` `list_chat_attendees` → `attendees[].providerId` `search_people` → `people[].providerId` `search_posts` → `posts[].author.providerId` `search_linkedin_people` → `results[].id` `get_conversation` → `participant.providerId` `get_chat` → `attendeeProviderId` `list_chat_messages` → `messages[].senderId` `list_chat_participants` → `participants[].providerId` `get_message` → `senderId` `get_chat_attendee` → `providerId` `list_attendee_chats` → `chats[].attendeeProviderId` `list_attendee_messages` → `messages[].senderId` `get_post_engagers` → `reactors[].providerId` `get_post_engagers` → `commenters[].providerId` `list_post_reactions` → `reactions[].author.id` `search_people_sales_navigator` → `leads[].providerId` `find_decision_makers` → `leads[].providerId`
`limit` optional	A number, 1 to 20. Max recent posts to return (1–20, default 2: the newest plus a backup is usually all a personalized opener needs).	You write it.

Call it

curl -X POST https://api.heyreagent.com/v1/actions/get_recent_posts \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "content-type: application/json" \
  -d '{"profileUrl":"PASTE_PROFILE_LINK_HERE"}'

The same call in JavaScript

const response = await fetch("https://api.heyreagent.com/v1/actions/get_recent_posts", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_KEY",
    "content-type": "application/json",
  },
  body: JSON.stringify({
    "profileUrl": "PASTE_PROFILE_LINK_HERE"
  }),
});
const answer = await response.json();
console.log(answer);

The same call in Python

import requests

response = requests.post(
    "https://api.heyreagent.com/v1/actions/get_recent_posts",
    headers={"Authorization": "Bearer YOUR_KEY"},
    json={
        "profileUrl": "PASTE_PROFILE_LINK_HERE",
    },
)
print(response.json())

The same call in n8n

Add an HTTP Request node and fill it in like this:

Method	`POST`
URL	`https://api.heyreagent.com/v1/actions/get_recent_posts`
Send Headers	On. Name `Authorization`, Value `Bearer YOUR_KEY`
Send Body	On. Body Content Type `JSON`, Specify Body `Using JSON`, then paste the body below

{
  "profileUrl": "PASTE_PROFILE_LINK_HERE"
}

Put your own key where it says YOUR_KEY. Put your own value where it says PASTE_…_HERE: the table above says where each one comes from. New here? Start with your first call.

What you get back

When it worked, the answer is { "ok": true, "result": { … } }. Inside result:

`returned`
`source`
`posts`
`note`

A field that does not apply to an answer is left out, or is null.

When it did not work, the answer is { "ok": false, "error": "…", "message": "…" }. What each error means.

Good to know

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.

In Claude or ChatGPT

Once connected, ask in your own words. The assistant sees this action as a tool with the same name, get_recent_posts, and the same inputs.