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

# Get Social Selling post content

> Everything a tracked post shows, to inspect or reuse it: the text and its links, structured mentions (posts published through Enginy), the reposted original, the author’s first comment (where a "link in the first comment" lives) and every image, video or document in post order. Each media item has a stable `assetId` and, under `access`, a `downloadUrl` any HTTP client can GET without a login or cookies (the original bytes), a `previewUrl`, MIME type, dimensions, size, alt text and expiry. By default each URL is probed first: a URL that does not serve the file is reported UNAVAILABLE with no URL rather than handed out. LinkedIn-hosted URLs expire (`EXPIRING`, `expiresAt`): call `refresh_social_selling_media_access` with the `assetId` for a durable copy. MCP results also carry the images as resource links. Read-only.

    > **Required scope:** `SOCIAL_SELLING_READ`
    >
    > **Rate limit:** 100 requests per minute



## OpenAPI

````yaml https://openapi.enginy.ai/definitions.json get /v1/social-selling/posts/{postId}/content
openapi: 3.1.0
info:
  title: Enginy API
  version: 1.0.0
  description: Public API for Enginy platform
servers:
  - url: https://openapi.enginy.ai
    description: Configured server
security: []
tags:
  - name: AI Variables
    description: >-
      Manage AI variables and discover the entity fields you can reference in
      prompts and entity requests.
  - name: Inbox
    description: >-
      Inbox endpoints for listing contact threads, reading thread messages,
      managing tags, and sending manual replies.
  - name: Workflows
    description: >-
      Build, validate, publish, run, and inspect advanced (graph) workflows,
      plus the block/condition catalog needed to author a workflow plan.
paths:
  /v1/social-selling/posts/{postId}/content:
    get:
      tags:
        - Social Selling
      summary: Get Social Selling post content
      description: >-
        Everything a tracked post shows, to inspect or reuse it: the text and
        its links, structured mentions (posts published through Enginy), the
        reposted original, the author’s first comment (where a "link in the
        first comment" lives) and every image, video or document in post order.
        Each media item has a stable `assetId` and, under `access`, a
        `downloadUrl` any HTTP client can GET without a login or cookies (the
        original bytes), a `previewUrl`, MIME type, dimensions, size, alt text
        and expiry. By default each URL is probed first: a URL that does not
        serve the file is reported UNAVAILABLE with no URL rather than handed
        out. LinkedIn-hosted URLs expire (`EXPIRING`, `expiresAt`): call
        `refresh_social_selling_media_access` with the `assetId` for a durable
        copy. MCP results also carry the images as resource links. Read-only.

            > **Required scope:** `SOCIAL_SELLING_READ`
            >
            > **Rate limit:** 100 requests per minute
      parameters:
        - schema:
            type: integer
            exclusiveMinimum: 0
            description: Tracked post id (`id` in `list_social_selling_posts`).
          required: true
          description: Tracked post id (`id` in `list_social_selling_posts`).
          name: postId
          in: path
        - schema:
            type: boolean
            default: true
            description: >-
              Probe every file URL before answering (confirms access, size, type
              and image dimensions). Default true; false skips the probes.
          required: false
          description: >-
            Probe every file URL before answering (confirms access, size, type
            and image dimensions). Default true; false skips the probes.
          name: verifyMedia
          in: query
      responses:
        '200':
          description: The post content and media
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - success
                  message:
                    type: string
                  data:
                    type: object
                    properties:
                      postId:
                        type: number
                      publishingPostId:
                        type:
                          - number
                          - 'null'
                      identity:
                        type: object
                        properties:
                          id:
                            type: number
                          name:
                            type:
                              - string
                              - 'null'
                        required:
                          - id
                          - name
                      linkedinPostUrn:
                        type: string
                      url:
                        type:
                          - string
                          - 'null'
                      postType:
                        type: string
                      repostKind:
                        type:
                          - string
                          - 'null'
                        enum:
                          - SIMPLE
                          - QUOTE
                          - null
                      postedAt:
                        type:
                          - string
                          - 'null'
                      text:
                        type:
                          - string
                          - 'null'
                      links:
                        type: array
                        items:
                          type: string
                        description: Links in the post text, in order.
                      mentions:
                        type:
                          - array
                          - 'null'
                        items:
                          type: object
                          properties:
                            start:
                              type: number
                            length:
                              type: number
                            kind:
                              type: string
                              enum:
                                - PROFILE
                                - COMPANY
                            urn:
                              type: string
                            label:
                              type: string
                          required:
                            - start
                            - length
                            - kind
                            - urn
                            - label
                        description: >-
                          Structured mentions (offsets in Unicode code points);
                          null when not collected.
                      mentionsAvailability:
                        type: string
                        enum:
                          - AVAILABLE
                          - NOT_COLLECTED
                      firstComment:
                        type:
                          - object
                          - 'null'
                        properties:
                          commentUrn:
                            type: string
                          text:
                            type:
                              - string
                              - 'null'
                          links:
                            type: array
                            items:
                              type: string
                          createdAt:
                            type:
                              - string
                              - 'null'
                        required:
                          - commentUrn
                          - text
                          - links
                          - createdAt
                        description: >-
                          The author’s earliest top-level comment (a "link in
                          the first comment").
                      firstCommentAvailability:
                        type: string
                        enum:
                          - FOUND
                          - NONE
                          - NOT_FETCHED
                        description: >-
                          NOT_FETCHED: the post’s comment threads were not read
                          yet (`sync_social_selling_post_comments`).
                      repostedPost:
                        type:
                          - object
                          - 'null'
                        properties:
                          linkedinPostUrn:
                            type:
                              - string
                              - 'null'
                          url:
                            type:
                              - string
                              - 'null'
                          authorName:
                            type:
                              - string
                              - 'null'
                          authorHeadline:
                            type:
                              - string
                              - 'null'
                          text:
                            type:
                              - string
                              - 'null'
                        required:
                          - linkedinPostUrn
                          - url
                          - authorName
                          - authorHeadline
                          - text
                      media:
                        type: array
                        items:
                          type: object
                          properties:
                            assetId:
                              type: string
                            position:
                              type: number
                              description: 0-based order in the post (or draft).
                            origin:
                              type: string
                              enum:
                                - POST
                                - REPOSTED_POST
                                - UPLOAD
                            type:
                              type: string
                              enum:
                                - IMAGE
                                - VIDEO
                                - DOCUMENT
                                - ARTICLE
                                - POLL
                                - CELEBRATION
                                - REFERENCE
                            mimeType:
                              type:
                                - string
                                - 'null'
                            width:
                              type:
                                - number
                                - 'null'
                            height:
                              type:
                                - number
                                - 'null'
                            sizeBytes:
                              type:
                                - number
                                - 'null'
                            durationMs:
                              type:
                                - number
                                - 'null'
                            pageCount:
                              type:
                                - number
                                - 'null'
                            title:
                              type:
                                - string
                                - 'null'
                            description:
                              type:
                                - string
                                - 'null'
                            altText:
                              type:
                                - string
                                - 'null'
                            altTextSource:
                              type:
                                - string
                                - 'null'
                              enum:
                                - AUTHOR
                                - UPLOADER
                                - null
                              description: >-
                                Who wrote `altText`. Alt text is never generated
                                by Enginy.
                            linkUrl:
                              type:
                                - string
                                - 'null'
                              description: The link of an article or reference card.
                            pollOptions:
                              type:
                                - array
                                - 'null'
                              items:
                                type: string
                            transcript:
                              type: object
                              properties:
                                status:
                                  type: string
                                  enum:
                                    - NOT_COLLECTED
                              required:
                                - status
                              description: >-
                                Video captions and transcripts are not collected
                                from LinkedIn.
                            access:
                              type: object
                              properties:
                                status:
                                  type: string
                                  enum:
                                    - AVAILABLE
                                    - EXPIRING
                                    - EXPIRED
                                    - UNAVAILABLE
                                    - PENDING_UPLOAD
                                    - NOT_DOWNLOADABLE
                                  description: >-
                                    AVAILABLE: `downloadUrl` serves the file.
                                    EXPIRING: served by LinkedIn until
                                    `expiresAt` (refresh for a durable copy).
                                    EXPIRED / UNAVAILABLE: no working URL
                                    (`reason` says why; refresh).
                                    PENDING_UPLOAD: upload not completed.
                                    NOT_DOWNLOADABLE: no file (poll, link card).
                                downloadUrl:
                                  type:
                                    - string
                                    - 'null'
                                  description: >-
                                    HTTPS URL of the original file. Any HTTP
                                    client can GET it without a login, cookies
                                    or headers. Null unless AVAILABLE or
                                    EXPIRING.
                                previewUrl:
                                  type:
                                    - string
                                    - 'null'
                                  description: >-
                                    A smaller rendition to look at (the image
                                    itself; video/document thumbnail).
                                expiresAt:
                                  type:
                                    - string
                                    - 'null'
                                  description: >-
                                    When `downloadUrl` stops working (null =
                                    durable).
                                durable:
                                  type: boolean
                                  description: >-
                                    True when `downloadUrl` is Enginy’s durable
                                    copy.
                                refreshable:
                                  type: boolean
                                  description: >-
                                    True when
                                    `refresh_social_selling_media_access` can
                                    improve it.
                                verifiedAt:
                                  type:
                                    - string
                                    - 'null'
                                  description: >-
                                    When Enginy confirmed the URL serves the
                                    file (null = not probed).
                                reason:
                                  type:
                                    - string
                                    - 'null'
                              required:
                                - status
                                - downloadUrl
                                - previewUrl
                                - expiresAt
                                - durable
                                - refreshable
                                - verifiedAt
                                - reason
                            source:
                              type:
                                - object
                                - 'null'
                              properties:
                                trackedPostId:
                                  type: number
                                position:
                                  type: number
                                credit:
                                  type:
                                    - string
                                    - 'null'
                              required:
                                - trackedPostId
                                - position
                                - credit
                              description: >-
                                For a copy of a post’s media: where it came from
                                and its credit.
                          required:
                            - assetId
                            - position
                            - origin
                            - type
                            - mimeType
                            - width
                            - height
                            - sizeBytes
                            - durationMs
                            - pageCount
                            - title
                            - description
                            - altText
                            - altTextSource
                            - linkUrl
                            - pollOptions
                            - transcript
                            - access
                            - source
                      mediaMetadataStored:
                        type: boolean
                        description: >-
                          False for older posts synced without attachment
                          metadata: `media` may be incomplete.
                      appUrl:
                        type:
                          - string
                          - 'null'
                    required:
                      - postId
                      - publishingPostId
                      - identity
                      - linkedinPostUrn
                      - url
                      - postType
                      - repostKind
                      - postedAt
                      - text
                      - links
                      - mentions
                      - mentionsAvailability
                      - firstComment
                      - firstCommentAvailability
                      - repostedPost
                      - media
                      - mediaMetadataStored
                      - appUrl
                required:
                  - status
                  - message
                  - data
        '403':
          description: >-
            Social Selling is not enabled for this workspace. Ask your workspace
            admin to enable the feature.
        '404':
          description: >-
            Post not found in this workspace or outside the caller’s identity
            scope
      security:
        - apiKey: []
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.