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
Field | Type | Required | Description |
---|---|---|---|
Authorization | string (header) | Yes | Bearer token for authentication (requires ORG_ADMIN permission) |
brand_id | int64 | Yes | ID of the brand |
connected_profile_id | int64 | Yes | ID of the connected social media profile (from social-connect ) |
post_type | string | Yes | Type of post: POST , REELS , STORY (Facebook); POST , STORY (Instagram); POST (YouTube, LinkedIn, Pinterest, TikTok, Google My Business) |
post_id | string | Yes | ID 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": ""
}