Get post replies/comments

Fetch all comments and replies for a specific published post from a particular social media account.

Fetch all comments and replies for a specific published post from a particular social media account. Specify the target account using network (required) and optionally username. If the post was published to only one account on that network, username can be omitted. When the post was published to multiple accounts on the same network, omitting username returns a 400 with the available usernames to disambiguate. Returns the full thread of replies including author information, content, and timestamps. Comments are not supported on every network - TikTok, Pinterest, and Google Business Profile do not expose a comments API, and YouTube comments are not yet supported; these networks will return an error.

GET/v1/posts/{id}/replies

Path Parameters

idstring

Query Parameters

networkstring

Social network name (e.g., 'x', 'threads')

Length1 <= length
username?string

Username or nickname of the social account that published the post. Optional when the post was published to only one account on the given network.

Length1 <= length
include_replies?boolean

When 'true', nest each comment's replies under it (post → comment → replies). Defaults to top-level comments only. Fetching replies on LinkedIn issues an extra API call per comment.

resolve_author_names?boolean

LinkedIn only: when 'true', resolve each commenter's URN into author_name (plus author_username, author_avatar_url and author_profile_url where LinkedIn provides them). Every other network already returns a readable author and ignores this. Some LinkedIn commenters cannot be resolved (for example members who limit their off-LinkedIn visibility) - those come back with author_name: null and author left as the URN. LinkedIn does not allow member profile data to be stored: cache a resolved name for at most 24 hours and re-fetch after that.

Response Body

fetch("https://api.outstand.so/v1/posts/string/replies?network=x&username=mycompany&include_replies=true&resolve_author_names=true", {  method: "GET"})
{
  "success": true,
  "replies": [
    {
      "id": "x_123456789_1704067200000",
      "author": "johndoe",
      "text": "Great post!",
      "created_at": "2025-01-15T10:30:00Z",
      "like_count": 5,
      "platform_specific": {},
      "replies": [
        {
          "id": "x_123456789_1704067200000",
          "author": "johndoe",
          "text": "Great post!",
          "created_at": "2025-01-15T10:30:00Z",
          "like_count": 5,
          "platform_specific": {},
          "replies": []
        }
      ]
    }
  ],
  "data": [
    {
      "id": "x_123456789_1704067200000",
      "author": "johndoe",
      "author_name": "John Doe",
      "author_username": "johndoe",
      "author_avatar_url": "https://media.licdn.com/dms/image/example.jpg",
      "author_profile_url": "https://www.linkedin.com/in/johndoe",
      "text": "Great post!",
      "created_at": "2025-01-15T10:30:00Z",
      "like_count": 5,
      "platform_specific": {},
      "replies": [
        {
          "id": "x_123456789_1704067200000",
          "author": "johndoe",
          "author_name": "John Doe",
          "author_username": "johndoe",
          "author_avatar_url": "https://media.licdn.com/dms/image/example.jpg",
          "author_profile_url": "https://www.linkedin.com/in/johndoe",
          "text": "Great post!",
          "created_at": "2025-01-15T10:30:00Z",
          "like_count": 5,
          "platform_specific": {},
          "replies": []
        }
      ]
    }
  ]
}
{
  "success": false,
  "error": "Invalid payload",
  "code": "idempotency_key_reuse",
  "details": {
    "content": {
      "_errors": [
        "Required"
      ]
    }
  }
}
{
  "success": false,
  "error": "Invalid payload",
  "code": "idempotency_key_reuse",
  "details": {
    "content": {
      "_errors": [
        "Required"
      ]
    }
  }
}
{
  "success": false,
  "error": "Invalid payload",
  "code": "idempotency_key_reuse",
  "details": {
    "content": {
      "_errors": [
        "Required"
      ]
    }
  }
}
{
  "success": false,
  "error": "Internal server error",
  "code": "idempotency_recovery_failed",
  "message": "Database connection failed"
}