Brand2Social API Documentation

Comprehensive guide to Brand2Social API endpoints

Get Post Details

Retrieve detailed information for a specific social media post. Specify the brand_id, connected_profile_id (from social-connect), post_type, and post_id (from get-published-posts). Supported platforms: Facebook, Instagram, YouTube, LinkedIn, Pinterest, TikTok, Google My Business. Response format varies by platform, including post details, media, engagement metrics, and comments with nested replies.

  • Method: POST
  • Endpoint: /api/api-services/v1/brand-service/get-post-details
  • Returns: Detailed information for the specified post, including comments and nested replies

Get Post Details

POST https://app.brand2social.com/api/api-services/v1/brand-service/get-post-details

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_typestringYesType of post: POST, REELS, STORY (Facebook); POST, STORY (Instagram); POST (YouTube, LinkedIn, Pinterest, TikTok, Google My Business)
post_idstringYesID of the post to retrieve (from get-published-posts)
    
    
curl --location 'https://app.brand2social.com/api/api-services/v1/brand-service/get-post-details' \
  --header 'Authorization: Bearer B2S_dummyToken' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "brand_id": 123,
    "connected_profile_id": 98765,
    "post_type": "POST",
    "post_id": "post_001"
}'
    
  

Response (Facebook)

{
  "status": "SUCCESS",
  "http_code": 200,
  "message": "Fetched Post Details Successfully",
  "data": {
    "id": "post_001",
    "description": "Check out our new product!",
    "thumbnail": "https://fb.com/thumbnail.jpg",
    "link": "https://fb.com/post/001",
    "media_urls": [
      {
        "media_type": "IMAGE",
        "media_urls": "https://fb.com/media1.jpg"
      }
    ],
    "like_count": 150,
    "comment_count": 20,
    "share_count": 10,
    "created_time": "2025-08-23T04:28:00Z",
    "comments_data": {
      "comments": [
        {
          "id": "comment_001",
          "username": "user1",
          "user_id": "fb_user_001",
          "created_time": "2025-08-23T04:30:00Z",
          "text": "Great product!",
          "like_count": 5,
          "comment_count": 2,
          "nested_comments": [
            {
              "created_time": "2025-08-23T04:32:00Z",
              "like_count": 1,
              "username": "user2",
              "user_id": "fb_user_002",
              "text": "Agreed!",
              "id": "reply_001"
            }
          ],
          "pagination": ""
        }
      ],
      "pagination": "next_cursor"
    }
  }
}

Response (Instagram)

{
  "status": "SUCCESS",
  "http_code": 200,
  "message": "Fetched Post Details Successfully",
  "data": {
    "id": "post_002",
    "description": "New video release!",
    "media_urls": [
      {
        "media_type": "VIDEO",
        "media_urls": "https://ig.com/media1.mp4"
      }
    ],
    "thumbnail": "https://ig.com/thumbnail.jpg",
    "link": "https://ig.com/p/002",
    "like_count": 200,
    "comment_count": 30,
    "is_liked": false,
    "created_time": "2025-08-23T04:28:00Z",
    "total_posts": 50,
    "comments_data": {
      "comments": [
        {
          "id": "comment_002",
          "username": "insta_user1",
          "profile_url": "https://ig.com/user1",
          "created_time": "2025-08-23T04:30:00Z",
          "text": "Awesome video!",
          "like_count": 10,
          "is_liked": false,
          "comment_count": 1,
          "nested_comments": [
            {
              "create_time": "2025-08-23T04:32:00Z",
              "like_count": 2,
              "is_liked": false,
              "profile_url": "https://ig.com/user2",
              "username": "insta_user2",
              "text": "Loved it!",
              "id": "reply_002"
            }
          ],
          "pagination": "",
          "total_comment": 1
        }
      ],
      "pagination": "next_cursor"
    }
  }
}

Response (YouTube)

{
  "status": "SUCCESS",
  "http_code": 200,
  "message": "Fetched Post Details Successfully",
  "data": {
    "id": "video_001",
    "description": "Introducing our latest product!",
    "title": "Product Demo",
    "thambnail": "https://yt.com/thumbnail.jpg",
    "like_count": 120,
    "comment_count": 25,
    "share_count": 10,
    "view_count": 5000,
    "created_time": "2025-08-23T04:28:00Z",
    "link": "https://youtu.be/video_001"
  }
}

Response (LinkedIn)

{
  "status": "SUCCESS",
  "http_code": 200,
  "message": "Fetched Post Details Successfully",
  "data": {
    "id": "post_003",
    "title": "Join our webinar!",
    "description": "Learn about our new features.",
    "thumbnail": "https://linkedin.com/thumbnail.jpg",
    "link": "https://linkedin.com/posts/003",
    "like_count": 50,
    "comment_count": 10,
    "view_count": 1000,
    "created_time": "2025-08-23T04:28:00Z",
    "is_liked": false,
    "comments_data": {
      "comments": [
        {
          "user_name": "user1",
          "id": "comment_003",
          "user_channel_url": "https://linkedin.com/in/user1",
          "text": "Looking forward to it!",
          "like_count": 3,
          "comment_count": 1,
          "created_time": "2025-08-23T04:30:00Z",
          "profile_pic": "https://linkedin.com/user1.jpg",
          "pagination": "",
          "nested_comments": [
            {
              "user_name": "user2",
              "id": "reply_003",
              "user_channel_url": "https://linkedin.com/in/user2",
              "text": "Great topic!",
              "like_count": 1,
              "created_time": "2025-08-23T04:32:00Z",
              "profile_pic": "https://linkedin.com/user2.jpg"
            }
          ]
        }
      ],
      "pagination": "next_cursor"
    }
  }
}

Response (Pinterest)

{
  "status": "SUCCESS",
  "http_code": 200,
  "message": "Fetched Post Details Successfully",
  "data": {
    "id": "pin_001",
    "description": "New product pin",
    "title": "Product Launch",
    "image_url": "https://pinterest.com/pin.jpg",
    "created_time": "2025-08-23T04:28:00Z",
    "link": "https://pinterest.com/pin/001",
    "board_id": "board_456"
  }
}

Response (TikTok)

{
  "status": "SUCCESS",
  "http_code": 200,
  "message": "Fetched Post Details Successfully",
  "data": {
    "id": "video_002",
    "description": "Dance challenge!",
    "title": "Brand Dance",
    "image_url": "https://tiktok.com/thumbnail.jpg",
    "created_time": "2025-08-23T04:28:00Z",
    "link": "https://tiktok.com/video/002",
    "board_id": ""
  }
}

Response (Google My Business)

{
  "status": "SUCCESS",
  "http_code": 200,
  "message": "Fetched Post Details Successfully",
  "data": {
    "id": "post_004",
    "description": "Visit our store!",
    "image_url": "https://gmb.com/post.jpg",
    "topic_type": "STANDARD",
    "created_time": "2025-08-23T04:28:00Z",
    "callToAction": {
      "actionType": "BOOK",
      "url": "https://gmb.com/book"
    }
  }
}

Error Response

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