---
title: "Get profile posts"
method: GET
path: "/social/profile/posts"
tags: ["social"]
---

# Get profile posts

`GET /social/profile/posts`

Fetch LinkedIn posts published by a person

## Query parameters

- `linkedinID` string
- `linkedinName` string
- `linkedinEntityID` string
- `perPage` integer
- `paginationToken` string

## Response `200`

List of posts

- object
  - `posts` SocialPost[], required
    - `urn` string — LinkedIn post URN
    - `actor` SocialActor
      - `linkedin_url` string
      - `name` string
      - `entity_type` string
      - `image` string
      - `linkedin_id` string
    - `post_range` SocialPostRange
      - `earliest` string
      - `latest` string
    - `post_age` string
    - `social_activity_counts` SocialActivityCounts
      - `comments_count` integer
      - `shares_count` integer
      - `reactions_count` integer
      - `reaction_type_counts` SocialReactionTypeCount[]
        - `count` integer
        - `reaction_type` string
    - `images` string[]
    - `url` string
    - `video` SocialVideo
      - `url` string
      - `thumbnail` string
    - `reshared_post` SocialPost — recursive
    - `commentary` string
    - `header` string
    - `header_entity` SocialHeaderEntity
      - `entity_type` string
      - `image` string
      - `linkedin_url` string
      - `linkedin_id` string
      - `name` string
  - `paginationToken` string — Token to retrieve the next page of results

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `5XX` — Unexpected error

---

[API](https://skmtc.dev/theswarm/apis/swarm-api.md) · [All operations](https://skmtc.dev/theswarm/apis/swarm-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/theswarm/swarm-api/revisions/130f0025ff6c/schema)