Get Post Comments

Retrieve comments for a specific social media post. This endpoint should be called after obtaining post IDs from the Social Posts endpoint. Returns detailed information about each commenter including their profile data, follower counts, and geographic region.

GET /api/post/comments

cURL

cURL

curl --request GET \
  --url https://api.recoupable.com/api/post/comments \
  --header 'x-api-key: <api-key>'

200

{
  "status": "success",
  "comments": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "post_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "social_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "comment": "<string>",
      "commented_at": "2023-11-07T05:31:56Z",
      "username": "<string>",
      "profile_url": "<string>",
      "post_url": "<string>",
      "avatar": "<string>",
      "region": "<string>",
      "bio": "<string>",
      "follower_count": 123,
      "following_count": 123
    }
  ],
  "pagination": {
    "total_count": 123,
    "page": 123,
    "limit": 123,
    "total_pages": 123
  }
}

Authorizations

x-api-key · string · header · required

Your Recoup API key. Learn more.

Query Parameters

post_id · string<uuid> · required

The unique identifier of the post to fetch comments for

page · integer · default: 1

The page number to retrieve (default: 1)

limit · integer · default: 20

The number of records per page (default: 20, max: 100)

Required range: x <= 100

Response

200

application/json

Post comments retrieved successfully

status · enum<string> · required

Status of the request

Available options: success

comments · object[] · required

List of comments for the specified post

Show child attributes

pagination · object · required

Pagination metadata for the response

Show child attributes