> ## Documentation Index
> Fetch the complete documentation index at: https://docs.theswarm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Reshares

> Pulls all reshares for a given social media post.

<Note>
  This endpoint is in beta. Please report any issues to [support@theswarm.com](mailto:support@theswarm.com)
</Note>

## Endpoint

```text theme={null}
GET https://bee.theswarm.com/social/post/:postUrn/reshares
```

## Parameters

| Parameter  | In    | Type    | Required | Description                                                |
| :--------- | :---- | :------ | :------- | :--------------------------------------------------------- |
| `:postUrn` | path  | string  | Yes      | URN of the post. Available in the [Get Posts](#) response. |
| `page`     | query | integer | No       | 1-indexed page number. Defaults to `1`.                    |
| `perPage`  | query | integer | No       | Number of items per page. Defaults to `10`, maximum `100`. |

## Pagination

Use `page` and `perPage` to walk through reshares in chunks. The response includes `pages` (total page count) and `totalCount` so you can stop when `page > pages`.

## Request Example

```text theme={null}
GET https://bee.theswarm.com/social/post/urn:li:ugcPost:7439318163827339265/reshares
```

```text Paginated theme={null}
GET https://bee.theswarm.com/social/post/urn:li:ugcPost:7439318163827339265/reshares?page=2&perPage=20
```

<RequestExample>
  ```text GET theme={null}
  https://bee.theswarm.com/social/post/urn:li:ugcPost:7439318163827339265/reshares
  ```

  ```text GET (paginated) theme={null}
  https://bee.theswarm.com/social/post/urn:li:ugcPost:7439318163827339265/reshares?page=2&perPage=20
  ```
</RequestExample>

<ResponseExample>
  ```text GET RESHARES theme={null}
  {
      "posts": [
          {
              "urn": "urn:li:ugcPost:7439318163827339265",
              "actor": {
                  "linkedin_url": "https://www.linkedin.com/in/olivier-roth",
                  "name": "Olivier Roth",
                  "entity_type": "person",
                  "image": "https://media.licdn.com/dms/image/v2/D5603AQE7PKvsHmvlzA/profile-displayphoto-shrink_800_800/profile-displayphoto-shrink_800_800/0/1697662162523?e=1775692800&v=beta&t=VnD-jQQgXUJecfx7cwY-ekmChHfSWmNwy_ZR_yWwLLc",
                  "linkedin_id": "olivier-roth"
              },
              "post_range": {
                  "earliest": "2026-03-09T15:15:47.155Z",
                  "latest": "2026-03-16T15:15:47.154Z"
              },
              "post_age": "1 week ago",
              "social_activity_counts": {
                  "comments_count": 6,
                  "shares_count": 3,
                  "reactions_count": 23,
                  "reaction_type_counts": [
                      {
                          "count": 19,
                          "reaction_type": "LIKE"
                      },
                      {
                          "count": 2,
                          "reaction_type": "APPRECIATION"
                      },
                      {
                          "count": 1,
                          "reaction_type": "EMPATHY"
                      },
                      {
                          "count": 1,
                          "reaction_type": "PRAISE"
                      }
                  ]
              },
              "images": [],
              "url": "https://www.linkedin.com/posts/olivier-roth_awesome-chat-with-jared-robin-founder-at-ugcPost-7439318163827339265--HJe?utm_source=social_share_send&utm_medium=member_desktop_web&rcm=ACoAAGH_z2oBIOD4wvyQnR1070geztsOVU_kcjs",
              "video": {
                  "url": "https://dms.licdn.com/playlist/vid/v2/D5605AQEFTpHHmDX1Bw/mp4-720p-30fp-crf28/B56Zz3EhP_H0CI-/0/1773671692232?e=1774886400&v=beta&t=uUqNlN278Oo4DWbVr0K3-VLDwuceAW1hYivZLmX0YG8",
                  "thumbnail": "https://media.licdn.com/dms/image/v2/D5605AQEFTpHHmDX1Bw/videocover-high/B56Zz3EhP_H0BY-/0/1773671688075?e=1774886400&v=beta&t=iJ4wFFS1rQHp5IfDep7IJVIKML3_5hXW-0sd83FSpZU"
              },
              "reshared_post": null,
              "commentary": "Awesome chat with Jared Robin, Founder at RevGenius, on GTN Academy! \n[full interview in the comments] \n\nHe shared how RevGenius grew from a small LinkedIn chat during COVID into one of the largest GTM communities, now with 70,000 members.\n\nWhat stood out to me:\n\n• Culture came first. The early decisions about who to let in, how people interacted, and what behavior was encouraged shaped everything that followed.\n\n• Relationship-led growth beats transactional networking. The strongest communities are built on people helping each other, not extracting value.\n\n• Trust gets harder as you scale. Growth creates noise, so protecting the original spirit of the community becomes intentional work.\n\n• Warm intros matter. The best connections often come through someone who already knows both sides.\n\n• Give before you ask. The people who contribute first tend to build the strongest networks over time.\n\nOne of Jared’s evolving views is that companies shouldn’t just “build a community.”\n\nThey should build an audience and systems that compound, where relationships, content, and introductions reinforce each other over time.\n\nWorth a listen if you care about GTM, networks, or how real communities actually grow! 🤩",
              "header": "Closed Circuit Selling™ (CCS) reposted this",
              "header_entity": {
                  "entity_type": "company",
                  "image": "https://media.licdn.com/dms/image/v2/D560BAQG-MQXoI597zA/company-logo_400_400/company-logo_400_400/0/1718766408519/closedcircuitselling_logo?e=1775692800&v=beta&t=d6uwbYRcR1ybgQs-DZlbqbUEkPVdFpFAolsKVATEAgU",
                  "linkedin_url": "https://www.linkedin.com/company/closedcircuitselling/",
                  "linkedin_id": "closedcircuitselling",
                  "name": "Closed Circuit Selling™ (CCS)"
              }
          },
          {
              "urn": "urn:li:ugcPost:7439318163827339265",
              "actor": {
                  "linkedin_url": "https://www.linkedin.com/in/olivier-roth",
                  "name": "Olivier Roth",
                  "entity_type": "person",
                  "image": "https://media.licdn.com/dms/image/v2/D5603AQE7PKvsHmvlzA/profile-displayphoto-shrink_800_800/profile-displayphoto-shrink_800_800/0/1697662162523?e=1775692800&v=beta&t=VnD-jQQgXUJecfx7cwY-ekmChHfSWmNwy_ZR_yWwLLc",
                  "linkedin_id": "olivier-roth"
              },
              "post_range": {
                  "earliest": "2026-03-09T15:15:47.155Z",
                  "latest": "2026-03-16T15:15:47.154Z"
              },
              "post_age": "1 week ago",
              "social_activity_counts": {
                  "comments_count": 6,
                  "shares_count": 3,
                  "reactions_count": 23,
                  "reaction_type_counts": [
                      {
                          "count": 19,
                          "reaction_type": "LIKE"
                      },
                      {
                          "count": 2,
                          "reaction_type": "APPRECIATION"
                      },
                      {
                          "count": 1,
                          "reaction_type": "EMPATHY"
                      },
                      {
                          "count": 1,
                          "reaction_type": "PRAISE"
                      }
                  ]
              },
              "images": [],
              "url": "https://www.linkedin.com/posts/olivier-roth_awesome-chat-with-jared-robin-founder-at-ugcPost-7439318163827339265--HJe?utm_source=social_share_send&utm_medium=member_desktop_web&rcm=ACoAAGH_z2oBIOD4wvyQnR1070geztsOVU_kcjs",
              "video": {
                  "url": "https://dms.licdn.com/playlist/vid/v2/D5605AQEFTpHHmDX1Bw/mp4-720p-30fp-crf28/B56Zz3EhP_H0CI-/0/1773671692232?e=1774886400&v=beta&t=uUqNlN278Oo4DWbVr0K3-VLDwuceAW1hYivZLmX0YG8",
                  "thumbnail": "https://media.licdn.com/dms/image/v2/D5605AQEFTpHHmDX1Bw/videocover-high/B56Zz3EhP_H0BY-/0/1773671688075?e=1774886400&v=beta&t=iJ4wFFS1rQHp5IfDep7IJVIKML3_5hXW-0sd83FSpZU"
              },
              "reshared_post": null,
              "commentary": "Awesome chat with Jared Robin, Founder at RevGenius, on GTN Academy! \n[full interview in the comments] \n\nHe shared how RevGenius grew from a small LinkedIn chat during COVID into one of the largest GTM communities, now with 70,000 members.\n\nWhat stood out to me:\n\n• Culture came first. The early decisions about who to let in, how people interacted, and what behavior was encouraged shaped everything that followed.\n\n• Relationship-led growth beats transactional networking. The strongest communities are built on people helping each other, not extracting value.\n\n• Trust gets harder as you scale. Growth creates noise, so protecting the original spirit of the community becomes intentional work.\n\n• Warm intros matter. The best connections often come through someone who already knows both sides.\n\n• Give before you ask. The people who contribute first tend to build the strongest networks over time.\n\nOne of Jared’s evolving views is that companies shouldn’t just “build a community.”\n\nThey should build an audience and systems that compound, where relationships, content, and introductions reinforce each other over time.\n\nWorth a listen if you care about GTM, networks, or how real communities actually grow! 🤩",
              "header": "RevGenius reposted this",
              "header_entity": {
                  "entity_type": "company",
                  "image": "https://media.licdn.com/dms/image/v2/D4E0BAQH5Q2_JOW7BFw/company-logo_400_400/B4EZgaAPKYGUAY-/0/1752782926854/revgenius_logo?e=1775692800&v=beta&t=WGskgd8gcO1fU2Ag9YphAx5VKBMJYVwEutAB-qFGu6M",
                  "linkedin_url": "https://www.linkedin.com/company/revgenius/",
                  "linkedin_id": "revgenius",
                  "name": "RevGenius"
              }
          },
          {
              "urn": "urn:li:ugcPost:7439318163827339265",
              "actor": {
                  "linkedin_url": "https://www.linkedin.com/in/olivier-roth",
                  "name": "Olivier Roth",
                  "entity_type": "person",
                  "image": "https://media.licdn.com/dms/image/v2/D5603AQE7PKvsHmvlzA/profile-displayphoto-shrink_800_800/profile-displayphoto-shrink_800_800/0/1697662162523?e=1775692800&v=beta&t=VnD-jQQgXUJecfx7cwY-ekmChHfSWmNwy_ZR_yWwLLc",
                  "linkedin_id": "olivier-roth"
              },
              "post_range": {
                  "earliest": "2026-03-09T15:15:47.155Z",
                  "latest": "2026-03-16T15:15:47.154Z"
              },
              "post_age": "1 week ago",
              "social_activity_counts": {
                  "comments_count": 6,
                  "shares_count": 3,
                  "reactions_count": 23,
                  "reaction_type_counts": [
                      {
                          "count": 19,
                          "reaction_type": "LIKE"
                      },
                      {
                          "count": 2,
                          "reaction_type": "APPRECIATION"
                      },
                      {
                          "count": 1,
                          "reaction_type": "EMPATHY"
                      },
                      {
                          "count": 1,
                          "reaction_type": "PRAISE"
                      }
                  ]
              },
              "images": [],
              "url": "https://www.linkedin.com/posts/olivier-roth_awesome-chat-with-jared-robin-founder-at-ugcPost-7439318163827339265--HJe?utm_source=social_share_send&utm_medium=member_desktop_web&rcm=ACoAAGH_z2oBIOD4wvyQnR1070geztsOVU_kcjs",
              "video": {
                  "url": "https://dms.licdn.com/playlist/vid/v2/D5605AQEFTpHHmDX1Bw/mp4-720p-30fp-crf28/B56Zz3EhP_H0CI-/0/1773671692232?e=1774886400&v=beta&t=uUqNlN278Oo4DWbVr0K3-VLDwuceAW1hYivZLmX0YG8",
                  "thumbnail": "https://media.licdn.com/dms/image/v2/D5605AQEFTpHHmDX1Bw/videocover-high/B56Zz3EhP_H0BY-/0/1773671688075?e=1774886400&v=beta&t=iJ4wFFS1rQHp5IfDep7IJVIKML3_5hXW-0sd83FSpZU"
              },
              "reshared_post": null,
              "commentary": "Awesome chat with Jared Robin, Founder at RevGenius, on GTN Academy! \n[full interview in the comments] \n\nHe shared how RevGenius grew from a small LinkedIn chat during COVID into one of the largest GTM communities, now with 70,000 members.\n\nWhat stood out to me:\n\n• Culture came first. The early decisions about who to let in, how people interacted, and what behavior was encouraged shaped everything that followed.\n\n• Relationship-led growth beats transactional networking. The strongest communities are built on people helping each other, not extracting value.\n\n• Trust gets harder as you scale. Growth creates noise, so protecting the original spirit of the community becomes intentional work.\n\n• Warm intros matter. The best connections often come through someone who already knows both sides.\n\n• Give before you ask. The people who contribute first tend to build the strongest networks over time.\n\nOne of Jared’s evolving views is that companies shouldn’t just “build a community.”\n\nThey should build an audience and systems that compound, where relationships, content, and introductions reinforce each other over time.\n\nWorth a listen if you care about GTM, networks, or how real communities actually grow! 🤩",
              "header": "The Swarm 🔆 reposted this",
              "header_entity": {
                  "entity_type": "company",
                  "image": "https://media.licdn.com/dms/image/v2/C560BAQFBgx84WuOyHQ/company-logo_400_400/company-logo_400_400/0/1669856178475/wearetheswarm_logo?e=1775692800&v=beta&t=S8In7ZW03-RHGnl09NsGfRWaGLqbRTgQg5aFKccKzPA",
                  "linkedin_url": "https://www.linkedin.com/company/wearetheswarm/",
                  "linkedin_id": "wearetheswarm",
                  "name": "The Swarm 🔆"
              }
          }
      ],
      "total_count": 3,
      "pages": 1,
      "pagination_token": ""
  }
  ```
</ResponseExample>


## OpenAPI

````yaml openapi.json GET /social/post/{urn}/reshares
openapi: 3.1.0
info:
  title: Swarm API
  version: 1.0.0
  contact:
    name: The Swarm
    url: https://theswarm.com
    email: hello@theswarm.com
servers:
  - url: https://bee.theswarm.com
security:
  - ApiKeyAuth: []
tags:
  - name: profiles
    description: Operations related to profiles
  - name: companies
    description: Operations related to companies
  - name: teams
    description: Operations for managing teams and connectors
  - name: social
    description: Operations related to social media posts and interactions
  - name: mcp
    description: Model Context Protocol endpoint for AI assistant integrations
  - name: credits
    description: Operations related to credit usage
  - name: network-mapper
    description: Operations for mapping connections and relationships across your network
paths:
  /social/post/{urn}/reshares:
    get:
      tags:
        - social
      summary: Get post reshares
      description: Fetch reshares of a LinkedIn post
      operationId: getPostReshares
      parameters:
        - name: urn
          in: path
          required: true
          description: LinkedIn post URN
          schema:
            type: string
        - name: page
          in: query
          required: false
          description: Page number (1-indexed). Optional.
          schema:
            type: integer
            minimum: 1
            default: 1
        - name: perPage
          in: query
          required: false
          description: Number of items per page. Max 100. Optional.
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 10
      responses:
        '200':
          description: List of reshared posts
          content:
            application/json:
              schema:
                type: object
                properties:
                  posts:
                    type: array
                    items:
                      $ref: '#/components/schemas/SocialPost'
                  total_count:
                    type: integer
                  pages:
                    type: integer
                  pagination_token:
                    type: string
                required:
                  - posts
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        5XX:
          $ref: '#/components/responses/5XX'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    SocialPost:
      type: object
      properties:
        urn:
          type: string
          description: LinkedIn post URN
        actor:
          $ref: '#/components/schemas/SocialActor'
        post_range:
          $ref: '#/components/schemas/SocialPostRange'
        post_age:
          type: string
        social_activity_counts:
          $ref: '#/components/schemas/SocialActivityCounts'
        images:
          type: array
          items:
            type: string
        url:
          type: string
        video:
          $ref: '#/components/schemas/SocialVideo'
        reshared_post:
          $ref: '#/components/schemas/SocialPost'
        commentary:
          type: string
        header:
          type: string
        header_entity:
          $ref: '#/components/schemas/SocialHeaderEntity'
    SocialActor:
      type: object
      properties:
        entity_type:
          type: string
        image:
          type: string
        linkedin_url:
          type: string
        linkedin_id:
          type: string
        name:
          type: string
    SocialPostRange:
      type: object
      properties:
        earliest:
          type: string
        latest:
          type: string
    SocialActivityCounts:
      type: object
      properties:
        comments_count:
          type: integer
        shares_count:
          type: integer
        reactions_count:
          type: integer
        reaction_type_counts:
          type: array
          items:
            $ref: '#/components/schemas/SocialReactionTypeCount'
    SocialVideo:
      type: object
      properties:
        url:
          type: string
        thumbnail:
          type: string
    SocialHeaderEntity:
      type: object
      properties:
        entity_type:
          type: string
        image:
          type: string
        linkedin_url:
          type: string
        linkedin_id:
          type: string
        name:
          type: string
    ErrorResponse:
      type: object
      properties:
        code:
          description: Error status code
          type: integer
        errors:
          type: array
          items:
            type:
              - string
              - object
      required:
        - code
    SocialReactionTypeCount:
      type: object
      properties:
        count:
          type: integer
        reaction_type:
          type: string
  responses:
    '400':
      description: Bad request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    '401':
      description: Unauthorized
    '403':
      description: Forbidden
    5XX:
      description: Unexpected error
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````