---
title: "Get person posts"
method: GET
path: "/v2/social/person/posts"
tags: ["Social"]
---

# Get person posts

`GET /v2/social/person/posts`

Get posts from a person's LinkedIn profile. Provide either `linkedinEntityID` or `linkedinID`.

A valid empty result is not charged.

## Query parameters

- `linkedinEntityID` string, nullable — LinkedIn entity ID for the person. The preferred, faster identifier.
- `linkedinID` string, nullable — LinkedIn ID for the person. Slower and less preferred than linkedinEntityID.
- `perPage` integer — Number of items per page
- `paginationToken` string, nullable — Token for pagination, required to return results beyond the first page.
- `apiToken` string, nullable

## Headers

- `x-api-token` string, nullable

## Response `200`

Successful Response

- PersonPostsResult
  - `results` SocialPost[]
    - `urn` string, nullable
    - `actor` SocialActor
      - `linkedinURL` string, nullable
      - `name` string, nullable
      - `entityType` string, nullable
      - `image` string, nullable
      - `linkedinID` string, nullable
    - `postRange` SocialPostRange
      - `earliest` string, date-time, nullable
      - `latest` string, date-time, nullable
    - `postAge` string, nullable
    - `socialActivityCounts` SocialActivityCounts
      - `commentsCount` integer, nullable
      - `sharesCount` integer, nullable
      - `reactionsCount` integer, nullable
      - `reactionTypeCounts` ReactionTypeCount[]
        - `count` integer, nullable
        - `reactionType` string, nullable
    - `images` string[]
    - `url` string, nullable
    - `video` SocialVideo
      - `url` string, nullable
      - `thumbnail` string, nullable
    - `resharedPost` SocialPost — recursive
    - `commentary` string, nullable
    - `header` string, nullable
    - `headerEntity` SocialActor
      - `linkedinURL` string, nullable
      - `name` string, nullable
      - `entityType` string, nullable
      - `image` string, nullable
      - `linkedinID` string, nullable
  - `hasMoreResults` boolean, nullable
  - `paginationToken` string, nullable
  - `creditsUsed` number — Number of credits charged for this request.

## Other responses

- `400` — Bad Request
- `402` — Payment Required
- `403` — Forbidden
- `404` — Not found
- `422` — Validation Error

## Changes

- **2026-09-25** `3ccf293818ca` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/ocean/apis/ocean-io-api-documentation/changes/v2/social/person/posts/get.md)

---

[API](https://skmtc.dev/ocean/apis/ocean-io-api-documentation.md) · [All operations](https://skmtc.dev/ocean/apis/ocean-io-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/ocean/apis/ocean-io-api-documentation/revisions/3ccf293818ca?raw)