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

# Get Post Comments

> Retrieve comments on a specific post.

## Overview

Returns the comments on a specific post. Pagination is **offset-based** — set `count` for the page size and `offset` to skip ahead.

<Note>This endpoint consumes **1 credit per 10 results** returned. The platform returns up to **10 comments per internal request**, so larger `count` values trigger multiple upstream calls automatically. Ignore this if you're on per-seat pricing: usage is unlimited.</Note>

## Request

<ParamField header="x-api-key" type="string" required>
  Your API key for authentication.
</ParamField>

<ParamField body="account_id" type="string" required>
  The unique identifier of the account to use.
</ParamField>

<ParamField body="action" type="string" required>
  Must be `"get_comments"`.
</ParamField>

<ParamField body="params" type="object" required>
  <Expandable title="params properties">
    <ParamField body="post_url" type="string" required>
      The URL of the post to retrieve comments from, as shown on the connected platform.
    </ParamField>

    <ParamField body="count" type="integer" default={10}>
      Number of comments to return. Defaults to `10`. **Capped at `1000`** per call.
    </ParamField>

    <ParamField body="offset" type="integer" default={0}>
      Zero-indexed offset into the comments list. Defaults to `0`. Use `pagination.next_offset` from a previous response to fetch the next page.
    </ParamField>
  </Expandable>
</ParamField>

## Response

<ResponseField name="success" type="boolean">
  Indicates whether the request was successful.
</ResponseField>

<ResponseField name="data" type="object">
  <Expandable title="data properties">
    <ResponseField name="comments" type="array">
      List of comments.

      <Expandable title="comment properties">
        <ResponseField name="comment_urn" type="string">Unique identifier of the comment. Use this with the `answer_comment` action.</ResponseField>
        <ResponseField name="tracking_id" type="string">Tracking ID required to reply to the comment via `answer_comment`.</ResponseField>
        <ResponseField name="comment_text" type="string">Plain-text content of the comment.</ResponseField>
        <ResponseField name="created_time" type="integer">Unix epoch (milliseconds) when the comment was posted.</ResponseField>

        <ResponseField name="commenter" type="object">
          <Expandable title="commenter properties">
            <ResponseField name="name" type="string">Display name.</ResponseField>
            <ResponseField name="profile_urn" type="string">Unique identifier of the commenter. Treat it as an opaque string and pass it back exactly as returned.</ResponseField>
            <ResponseField name="linkedin_url" type="string">Public profile URL.</ResponseField>
            <ResponseField name="occupation" type="string">Headline / current role.</ResponseField>
          </Expandable>
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="total_results" type="integer">Number of comments returned in this response.</ResponseField>
    <ResponseField name="total_available_results" type="integer">Total number of comments on the post reported by the platform.</ResponseField>

    <ResponseField name="pagination" type="object">
      <Expandable title="pagination properties">
        <ResponseField name="offset" type="integer">Offset of the first comment in this response.</ResponseField>
        <ResponseField name="count" type="integer">Number of comments returned (mirrors `total_results`).</ResponseField>
        <ResponseField name="next_offset" type="integer">Offset to send as `offset` in the next request. `null` when exhausted.</ResponseField>
        <ResponseField name="has_more" type="boolean">`true` if more comments are available.</ResponseField>
        <ResponseField name="results_per_page" type="integer">Maximum batch size used per upstream request (10).</ResponseField>
        <ResponseField name="pages_fetched" type="integer">Number of internal upstream batches consumed.</ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="metadata" type="object">
  <Expandable title="metadata properties">
    <ResponseField name="action" type="string">The action that was performed (`"get_comments"`).</ResponseField>
    <ResponseField name="account_id" type="string">The account ID used for the request.</ResponseField>
    <ResponseField name="credits_consumed" type="integer">Number of credits consumed (1 per 10 results).</ResponseField>
    <ResponseField name="timestamp" type="string">ISO 8601 timestamp of the response.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": {
      "comments": [
        {
          "comment_urn": "urn:li:comment:(activity:7453382311909445632,7453434056920387584)",
          "tracking_id": "tXyr6F5s8TwZ9U3ezehCwg==",
          "comment_text": "Great post! Very insightful.",
          "created_time": 1777037157279,
          "commenter": {
            "name": "Jane Doe",
            "profile_urn": "urn:li:fsd_profile:ACoAA...",
            "linkedin_url": "https://www.linkedin.com/in/jane-doe-42",
            "occupation": "Product Manager at Acme Corp"
          }
        }
      ],
      "total_results": 1,
      "total_available_results": 10,
      "pagination": {
        "offset": 0,
        "count": 1,
        "next_offset": 1,
        "has_more": true,
        "results_per_page": 10,
        "pages_fetched": 1
      }
    },
    "metadata": {
      "action": "get_comments",
      "account_id": "your-account-id",
      "credits_consumed": 1,
      "timestamp": "2026-04-26T10:35:00Z"
    }
  }
  ```

  ```json 400 theme={null}
  {
    "success": false,
    "error": {
      "code": "INVALID_PARAMS",
      "message": "post_url is required."
    },
    "metadata": {
      "action": "get_comments",
      "account_id": "your-account-id",
      "credits_consumed": 0,
      "timestamp": "2026-04-26T10:35:00Z"
    }
  }
  ```
</ResponseExample>