Brand2Social API Documentation

Comprehensive guide to Brand2Social API endpoints

Get Next Comments

Retrieve the next batch of comments for a specific social media post using a pagination cursor. Specify the brand_id, connected_profile_id (from social-connect), post_id (from get-published-posts or get-post-details), and pagination (from get-post-details). Supported platforms: Facebook, Instagram, YouTube, LinkedIn (pages only). Response includes comments with nested replies and a new pagination cursor.

  • Method: POST
  • Endpoint: /api/api-services/v1/brand-service/get-next-comments
  • Returns: Next batch of comments with nested replies and pagination cursor

Get Next Comments

POST https://app.brand2social.com/api/api-services/v1/brand-service/get-next-comments

FieldTypeRequiredDescription
Authorizationstring (header)YesBearer token for authentication (requires ORG_ADMIN permission)
brand_idint64YesID of the brand
connected_profile_idint64YesID of the connected social media profile (from social-connect)
post_idstringYesID of the post (from get-published-posts or get-post-details)
paginationstringYesPagination cursor from a previous get-post-details response
    
    
curl --location 'https://app.brand2social.com/api/api-services/v1/brand-service/get-next-comments' \
  --header 'Authorization: Bearer B2S_dummyToken' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "brand_id": 123,
    "connected_profile_id": 98765,
    "post_id": "post_001",
    "pagination": "next_cursor"
}'
    
  

Response (Facebook)

{
  "status": "SUCCESS",
  "http_code": 200,
  "message": "Fetched next comments successfully",
  "data": {
    "comments": [
      {
        "id": "comment_002",
        "username": "user3",
        "user_id": "fb_user_003",
        "created_time": "2025-08-23T05:58:00Z",
        "text": "Amazing post!",
        "image_url": "https://fb.com/user3.jpg",
        "like_count": 3,
        "comment_count": 1,
        "profile_url": "https://fb.com/user3",
        "is_liked": false,
        "nested_comments": [
          {
            "id": "reply_002",
            "username": "user4",
            "user_id": "fb_user_004",
            "created_time": "2025-08-23T06:00:00Z",
            "text": "Totally agree!",
            "image_url": "https://fb.com/user4.jpg",
            "like_count": 1,
            "profile_url": "https://fb.com/user4",
            "comment_count": 0,
            "is_liked": false
          }
        ],
        "pagination": ""
      }
    ],
    "pagination": "next_cursor_2"
  }
}

Response (Instagram)

{
  "status": "SUCCESS",
  "http_code": 200,
  "message": "Fetched next comments successfully",
  "data": {
    "comments": [
      {
        "id": "comment_003",
        "username": "insta_user3",
        "profile_url": "https://ig.com/user3",
        "created_time": "2025-08-23T05:58:00Z",
        "text": "Great content!",
        "like_count": 5,
        "is_liked": false,
        "comment_count": 1,
        "nested_comments": [
          {
            "id": "reply_003",
            "username": "insta_user4",
            "profile_url": "https://ig.com/user4",
            "create_time": "2025-08-23T06:00:00Z",
            "text": "Love this!",
            "like_count": 2,
            "is_liked": false,
            "comment_count": 0
          }
        ],
        "pagination": "",
        "total_comment": 1
      }
    ],
    "pagination": "next_cursor_2"
  }
}

Response (YouTube)

{
  "status": "SUCCESS",
  "http_code": 200,
  "message": "Fetched next comments successfully",
  "data": {
    "comments": [
      {
        "id": "comment_004",
        "username": "yt_user1",
        "user_id": "yt_user_001",
        "created_time": "2025-08-23T05:58:00Z",
        "text": "Awesome video!",
        "image_url": "https://yt.com/user1.jpg",
        "like_count": 4,
        "comment_count": 1,
        "profile_url": "https://yt.com/channel/user1",
        "is_liked": false,
        "nested_comments": [
          {
            "id": "reply_004",
            "username": "yt_user2",
            "user_id": "yt_user_002",
            "created_time": "2025-08-23T06:00:00Z",
            "text": "Great point!",
            "image_url": "https://yt.com/user2.jpg",
            "like_count": 1,
            "profile_url": "https://yt.com/channel/user2",
            "comment_count": 0,
            "is_liked": false
          }
        ],
        "pagination": ""
      }
    ],
    "pagination": "next_page_token_2"
  }
}

Response (LinkedIn)

{
  "status": "SUCCESS",
  "http_code": 200,
  "message": "Fetched next comments successfully",
  "data": {
    "comments": [
      {
        "id": "comment_005",
        "user_name": "user5",
        "user_channel_url": "https://linkedin.com/in/user5",
        "text": "Insightful post!",
        "like_count": 2,
        "comment_count": 1,
        "created_time": "2025-08-23T05:58:00Z",
        "profile_pic": "https://linkedin.com/user5.jpg",
        "pagination": "",
        "nested_comments": [
          {
            "user_name": "user6",
            "id": "reply_005",
            "user_channel_url": "https://linkedin.com/in/user6",
            "text": "Well said!",
            "like_count": 1,
            "created_time": "2025-08-23T06:00:00Z",
            "profile_pic": "https://linkedin.com/user6.jpg"
          }
        ]
      }
    ],
    "pagination": "next_cursor_2"
  }
}

Error Response

{
  "status": "FAILURE",
  "http_code": 400,
  "message": "pagination is required",
  "data": ""
}