# get_post: Get a post

Read one post. This action only reads; it changes nothing. Plan: Free and Connect.

```
POST https://api.heyreagent.com/v1/actions/get_post
Authorization: Bearer YOUR_KEY
content-type: application/json

{
  "post": "PASTE_POST_LINK_HERE"
}
```

## What you give it

- `post` (needed): a post link or a post social id or a post id. The LinkedIn post: its URL, or its id (socialId) from an earlier result. Where to get it: On LinkedIn, click the More icon (the three dots) at the top right of the post, then "Copy link to post". Or: Run `search_posts` and use `posts[].url`.
- `connectionId` (optional): a connection id. Which of your LinkedIn accounts to act from (its id from list_linkedin_accounts). Omit to use your first live one. Where to get it: Run `list_linkedin_accounts` and use `accounts[].id`.

## What you get back

- `id`: a post id
- `socialId`: a post social id
- `shareUrl`: a post link
- `title`: string
- `text`: string
- `date`: string
- `parsedDatetime`: string
- `reactionCounter`: number
- `commentCounter`: number
- `repostCounter`: number
- `impressionsCounter`: number
- `userReacted`: LIKE | PRAISE | APPRECIATION | EMPATHY | INTEREST | ENTERTAINMENT
- `author.publicIdentifier`: a public identifier
- `author.id`: string or null
- `author.name`: string or null
- `author.isCompany`: boolean
- `author.headline`: string
- `author.profilePictureUrl`: string
- `writtenBy.id`: string
- `writtenBy.publicIdentifier`: string
- `writtenBy.name`: string
- `permissions.canReact`: boolean
- `permissions.canShare`: boolean
- `permissions.canPostComments`: boolean
- `isRepost`: boolean
- `repostId`: string
- `repostParsedDatetime`: string
- `repostedBy.publicIdentifier`: string or null
- `repostedBy.id`: string or null
- `repostedBy.name`: string or null
- `repostedBy.isCompany`: boolean
- `repostedBy.headline`: string
- `repostedBy.profilePictureUrl`: string
- `repostContent.id`: string
- `repostContent.date`: string
- `repostContent.parsedDatetime`: string
- `repostContent.text`: string
- `mentions[].url`: string
- `mentions[].start`: number
- `mentions[].length`: number
- `attachments[].id`: string
- `attachments[].fileSize`: number
- `attachments[].unavailable`: boolean
- `attachments[].mimetype`: string
- `attachments[].url`: string
- `attachments[].urlExpiresAt`: number
- `attachments[].type`: poll
- `attachments[].sticker`: boolean
- `attachments[].gif`: boolean
- `attachments[].duration`: number
- `attachments[].voiceNote`: boolean
- `attachments[].fileName`: string
- `attachments[].startsAt`: number or null
- `attachments[].expiresAt`: number or null
- `attachments[].timeRange`: number or null
- `attachments[].displayName`: string or null
- `attachments[].organization`: string or null
- `poll.id`: string
- `poll.totalVotesCount`: number
- `poll.question`: string
- `poll.isOpen`: boolean
- `group.id`: string
- `group.name`: string
- `group.private`: boolean
- `jobPosting.id`: string or null
- `jobPosting.title`: string
- `jobPosting.location`: string
- `article.id`: string or null
- `article.title`: string
- `article.url`: string
- `article.author`: string
- `article.publishedAt`: string
- `article.excerpt`: string
- `article.pictureUrl`: string
- `analytics.impressions`: number
- `analytics.engagements`: number
- `analytics.engagementRate`: number
- `analytics.clicks`: number
- `analytics.clickthroughRate`: number
- `analytics.pageViewersFromThisPost`: number
- `analytics.followersGainedFromThisPost`: number
- `analytics.membersReached`: number

## Good to know

- This is how a post link becomes a socialId.
- author.id is null for some authors (the published sample shows it for a company page).
- permissions.canPostComments and permissions.canReact say whether a comment or a reaction will be accepted.

Page: https://heyreagent.com/docs/actions/get_post