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

# Get post

> Returns a public LinkedIn post including author, engagement counts, and up to ~5 inline comments.



## OpenAPI

````yaml /openapi.json get /v1/linkedin/posts/{postId}
openapi: 3.1.0
info:
  title: KonbiniAPI
  version: 1.0.0
  description: >-
    Social media API that normalizes Instagram, TikTok, X, Reddit, and LinkedIn
    data into a consistent ActivityStreams 2.0 format.


    Every authenticated response includes `X-Credits-Remaining` and
    `X-Credits-Used` headers. Each successful request costs 1 credit. Requests
    that fail with 400, 5xx, or upstream errors are refunded (X-Credits-Used:
    0).
  contact:
    name: KonbiniAPI
    email: hello@konbiniapi.com
    url: https://konbiniapi.com
servers:
  - url: https://api.konbiniapi.com
    description: Production
security:
  - apiKey: []
tags:
  - name: Instagram
    description: Instagram data endpoints
  - name: TikTok
    description: TikTok data endpoints
  - name: X
    description: X data endpoints
  - name: Reddit
    description: Reddit data endpoints
  - name: LinkedIn
    description: LinkedIn data endpoints
paths:
  /v1/linkedin/posts/{postId}:
    get:
      tags:
        - LinkedIn
      summary: Get post
      description: >-
        Returns a public LinkedIn post including author, engagement counts, and
        up to ~5 inline comments.
      operationId: linkedinGetPost
      parameters:
        - schema:
            type: string
            description: >-
              LinkedIn post activity ID: the full slug (from
              linkedin.com/posts/{id}), a bare `urn:li:activity:{id}` (from
              linkedin.com/feed/update/{urn}/), or a bare numeric activity ID
              (e.g. `7476310414297968640`)
            example: >-
              stripe_new-providers-on-stripe-projects-are-available-activity-7483253516766109696-xCr3
          required: true
          description: >-
            LinkedIn post activity ID: the full slug (from
            linkedin.com/posts/{id}), a bare `urn:li:activity:{id}` (from
            linkedin.com/feed/update/{urn}/), or a bare numeric activity ID
            (e.g. `7476310414297968640`)
          name: postId
          in: path
      responses:
        '200':
          description: Returns the LinkedIn post
          headers:
            X-Credits-Remaining:
              schema:
                type: integer
              description: Credits remaining after this request
            X-Credits-Used:
              schema:
                type: integer
              description: Credits consumed (1 if charged, 0 if refunded on error)
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      '@context':
                        type: array
                        prefixItems:
                          - type: string
                            enum:
                              - https://www.w3.org/ns/activitystreams#
                          - type: string
                            enum:
                              - https://konbiniapi.com/ns/social#
                        description: ActivityStreams JSON-LD context
                        example:
                          - https://www.w3.org/ns/activitystreams#
                          - https://konbiniapi.com/ns/social#
                      type:
                        type: string
                        description: ActivityStreams object type
                        example: Note
                      id:
                        type: string
                        format: uri
                        description: Post permalink
                        example: >-
                          https://www.linkedin.com/posts/stripe_new-providers-on-stripe-projects-are-available-activity-7483253516766109696-xCr3
                      url:
                        type: string
                        format: uri
                        description: Post permalink
                        example: >-
                          https://www.linkedin.com/posts/stripe_new-providers-on-stripe-projects-are-available-activity-7483253516766109696-xCr3
                      entityId:
                        type: string
                        description: >-
                          Numeric activity ID, usable directly as :postId on GET
                          /posts/:postId
                        example: '7483253516766109696'
                      content:
                        type: string
                        description: Comment text
                        example: |-
                          New providers on Stripe Projects are available now:

                          Chatbase
                          Composio
                          NodeOps
                          Customer.io
                          Datadog
                      published:
                        type: string
                        format: date-time
                        description: Publication date in ISO 8601 format
                        example: '2026-07-15T20:17:50.459Z'
                      likeCount:
                        type: integer
                        description: Number of likes
                        example: 185
                      replyCount:
                        type: integer
                        description: Number of replies
                        example: 39
                      attributedTo:
                        type: object
                        properties:
                          type:
                            type: string
                            description: ActivityStreams object type
                            example: Person
                          id:
                            type: string
                            format: uri
                            description: Author profile URL (stable identifier)
                            example: https://www.linkedin.com/in/janedoe
                          url:
                            type: string
                            format: uri
                            description: Author profile URL
                            example: https://www.linkedin.com/in/janedoe
                          name:
                            type: string
                            description: Author display name
                            example: Jane Doe
                          preferredUsername:
                            type: string
                            description: >-
                              Author username — looks the author up via GET
                              /users/:username
                            example: janedoe
                          followerCount:
                            type: integer
                            description: Author follower count
                            example: 12000
                        required:
                          - type
                        description: Post author
                        example:
                          type: Organization
                          id: https://www.linkedin.com/company/stripe
                          url: https://www.linkedin.com/company/stripe
                          name: Stripe
                          preferredUsername: stripe
                          followerCount: 1601918
                      image:
                        type: array
                        items:
                          allOf:
                            - $ref: '#/components/schemas/LinkedInImage'
                            - description: Image resource
                        description: Thumbnail images
                        example:
                          - type: Image
                            url: >-
                              https://media.licdn.com/dms/image/v2/D4E05AQGnh5Qo2aZfGw/videocover-high/B4EZ9nRqAzJEBM-/0/1784144110876
                      attachment:
                        type: array
                        items:
                          $ref: '#/components/schemas/LinkedInVideoAttachment'
                        description: Video attachment, when present
                        example:
                          - type: Video
                            url:
                              - >-
                                https://dms.licdn.com/playlist/vid/v2/D4E05AQGnh5Qo2aZfGw/mp4-720p-30fp-crf28/B4EZ9nRqAzJEB8-/0/1784144111064
                            mediaType: video/mp4
                            duration: 4
                            preview:
                              type: Image
                              url: >-
                                https://media.licdn.com/dms/image/v2/D4E05AQGnh5Qo2aZfGw/videocover-high/B4EZ9nRqAzJEBM-/0/1784144110876
                      replies:
                        type: array
                        items:
                          $ref: '#/components/schemas/LinkedInComment'
                        description: >-
                          Inline comments — LinkedIn exposes at most ~5
                          anonymously, this is not the full thread
                    required:
                      - '@context'
                      - type
                      - id
                      - url
                      - content
                required:
                  - data
        '400':
          description: Bad Request — Invalid parameters
          headers:
            X-Credits-Remaining:
              schema:
                type: integer
              description: Credits remaining after this request
            X-Credits-Used:
              schema:
                type: integer
              description: Credits consumed (1 if charged, 0 if refunded on error)
          content:
            application/json:
              schema:
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                          enum:
                            - validation_error
                          description: Machine-readable error code
                        message:
                          type: string
                          example: Validation error
                          description: Human-readable error message
                      required:
                        - code
                        - message
                    description: List of errors
                  data:
                    type: 'null'
                    description: Always null for error responses
                required:
                  - errors
                  - data
        '401':
          description: Unauthorized — Missing or invalid API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                          enum:
                            - missing_api_key
                            - invalid_api_key
                          description: Machine-readable error code
                        message:
                          type: string
                          example: Invalid API key
                          description: Human-readable error message
                      required:
                        - code
                        - message
                    description: List of errors
                  data:
                    type: 'null'
                    description: Always null for error responses
                required:
                  - errors
                  - data
        '402':
          description: Payment Required — Credits exhausted
          content:
            application/json:
              schema:
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                          enum:
                            - credits_exhausted
                          description: Machine-readable error code
                        message:
                          type: string
                          example: >-
                            Credits exhausted. Upgrade your plan at
                            konbiniapi.com
                          description: Human-readable error message
                      required:
                        - code
                        - message
                    description: List of errors
                  data:
                    type: 'null'
                    description: Always null for error responses
                required:
                  - errors
                  - data
        '403':
          description: Forbidden — API key disabled or expired
          content:
            application/json:
              schema:
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                          enum:
                            - api_key_disabled
                            - api_key_expired
                          description: Machine-readable error code
                        message:
                          type: string
                          example: API key is disabled
                          description: Human-readable error message
                      required:
                        - code
                        - message
                    description: List of errors
                  data:
                    type: 'null'
                    description: Always null for error responses
                required:
                  - errors
                  - data
        '404':
          description: Not Found
          headers:
            X-Credits-Remaining:
              schema:
                type: integer
              description: Credits remaining after this request
            X-Credits-Used:
              schema:
                type: integer
              description: Credits consumed (1 if charged, 0 if refunded on error)
          content:
            application/json:
              schema:
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                          enum:
                            - not_found
                            - route_not_found
                          description: Machine-readable error code
                        message:
                          type: string
                          example: Not found
                          description: Human-readable error message
                      required:
                        - code
                        - message
                    description: List of errors
                  data:
                    type: 'null'
                    description: Always null for error responses
                required:
                  - errors
                  - data
        '413':
          description: Content Too Large — Request body exceeds 1 MB
          content:
            application/json:
              schema:
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                          enum:
                            - validation_error
                          description: Machine-readable error code
                        message:
                          type: string
                          example: Request body too large
                          description: Human-readable error message
                      required:
                        - code
                        - message
                    description: List of errors
                  data:
                    type: 'null'
                    description: Always null for error responses
                required:
                  - errors
                  - data
        '500':
          description: Internal Server Error
          headers:
            X-Credits-Remaining:
              schema:
                type: integer
              description: Credits remaining after this request
            X-Credits-Used:
              schema:
                type: integer
              description: Credits consumed (1 if charged, 0 if refunded on error)
          content:
            application/json:
              schema:
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                          enum:
                            - internal_error
                          description: Machine-readable error code
                        message:
                          type: string
                          example: Internal error
                          description: Human-readable error message
                      required:
                        - code
                        - message
                    description: List of errors
                  data:
                    type: 'null'
                    description: Always null for error responses
                required:
                  - errors
                  - data
        '502':
          description: Bad Gateway — Upstream platform error
          headers:
            X-Credits-Remaining:
              schema:
                type: integer
              description: Credits remaining after this request
            X-Credits-Used:
              schema:
                type: integer
              description: Credits consumed (1 if charged, 0 if refunded on error)
          content:
            application/json:
              schema:
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                          enum:
                            - platform_error
                          description: Machine-readable error code
                        message:
                          type: string
                          example: Platform error
                          description: Human-readable error message
                      required:
                        - code
                        - message
                    description: List of errors
                  data:
                    type: 'null'
                    description: Always null for error responses
                required:
                  - errors
                  - data
        '503':
          description: Service Unavailable
          headers:
            X-Credits-Remaining:
              schema:
                type: integer
              description: Credits remaining after this request
            X-Credits-Used:
              schema:
                type: integer
              description: Credits consumed (1 if charged, 0 if refunded on error)
          content:
            application/json:
              schema:
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                          enum:
                            - service_unavailable
                          description: Machine-readable error code
                        message:
                          type: string
                          example: Service unavailable
                          description: Human-readable error message
                      required:
                        - code
                        - message
                    description: List of errors
                  data:
                    type: 'null'
                    description: Always null for error responses
                required:
                  - errors
                  - data
        '504':
          description: Gateway Timeout — Upstream platform timed out
          headers:
            X-Credits-Remaining:
              schema:
                type: integer
              description: Credits remaining after this request
            X-Credits-Used:
              schema:
                type: integer
              description: Credits consumed (1 if charged, 0 if refunded on error)
          content:
            application/json:
              schema:
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                          enum:
                            - platform_error
                          description: Machine-readable error code
                        message:
                          type: string
                          example: Platform error
                          description: Human-readable error message
                      required:
                        - code
                        - message
                    description: List of errors
                  data:
                    type: 'null'
                    description: Always null for error responses
                required:
                  - errors
                  - data
components:
  schemas:
    LinkedInImage:
      type: object
      properties:
        type:
          type: string
          description: ActivityStreams object type
          example: Image
        url:
          type: string
          format: uri
          description: Image URL
          example: >-
            https://media.licdn.com/dms/image/v2/D4E03AQExample/profile-displayphoto-shrink_800_800/0/1700000000000
      required:
        - type
        - url
      description: Profile picture
    LinkedInVideoAttachment:
      type: object
      properties:
        type:
          type: string
          description: ActivityStreams object type
          example: Video
        url:
          type: array
          items:
            type: string
            format: uri
          description: Media download URLs
          example:
            - >-
              https://dms.licdn.com/playlist/vid/v2/D4E05AQExample/mp4-720p-30fp-crf28/0/1700000000000
        mediaType:
          type: string
          description: MIME type
          example: video/mp4
        width:
          type: integer
          description: Width in pixels
          example: 576
        height:
          type: integer
          description: Height in pixels
          example: 1024
        duration:
          type: number
          description: Duration in seconds
          example: 45
        preview:
          allOf:
            - $ref: '#/components/schemas/LinkedInImage'
            - description: Video thumbnail
              example:
                type: Image
                url: >-
                  https://media.licdn.com/dms/image/v2/D4E05AQExample/thumbnail.jpg
      required:
        - type
        - url
      description: Post video attachment
    LinkedInComment:
      type: object
      properties:
        type:
          type: string
          description: ActivityStreams object type
          example: Note
        content:
          type: string
          description: Comment text
          example: >-
            Very excited to have Schematic in here and to be building with
            Stripe on this front!
        published:
          type: string
          format: date-time
          description: Publication date in ISO 8601 format
          example: '2026-07-15T20:28:36.758Z'
        likeCount:
          type: integer
          description: Number of likes
          example: 5
        attributedTo:
          type: object
          properties:
            type:
              type: string
              description: ActivityStreams object type
              example: Person
            id:
              type: string
              format: uri
              description: Author profile URL (stable identifier)
              example: https://www.linkedin.com/in/janedoe
            url:
              type: string
              format: uri
              description: Author profile URL
              example: https://www.linkedin.com/in/janedoe
            name:
              type: string
              description: Author display name
              example: Jane Doe
            preferredUsername:
              type: string
              description: Author username — looks the author up via GET /users/:username
              example: janedoe
            followerCount:
              type: integer
              description: Author follower count
              example: 12000
          required:
            - type
          description: Comment author
          example:
            type: Person
            name: Fynn Glover
      required:
        - type
        - content
      description: Inline post comment
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: |-
        Send your API key in the Authorization header as a Bearer token.
        Example: `Authorization: Bearer <your-api-key>`

````