Brand2Social API Documentation

Comprehensive guide to Brand2Social API endpoints

Get Social Accounts

Retrieve a list of social profiles connected to a specific brand.

Use this API after integrating accounts via integrate-accounts to fetch details of connected profiles, such as profile names, links, and status.

  • Method: POST
  • Endpoint: /api/api-services/v1/brand-service/get-social-profiles
  • Returns: List of connected social profiles for the specified brand

Get Social Accounts

POST https://app.brand2social.com/api/api-services/v1/brand-service/get-social-profiles

Header / Body ParamTypeRequiredDescription
Authorizationstring (header)YesBearer token
brand_idint64 (body)YesID of the brand
    
    
curl --location 'https://app.brand2social.com/api/api-services/v1/brand-service/get-social-profiles' \
  --header 'Authorization: Bearer B2S_dummyToken' \
  --data-raw '{
    "brand_id": 123
  }'
    
  

Response

{
  "status": "SUCCESS",
  "http_code": 200,
  "message": "Connected profiles retrieved successfully",
  "data": [
    {
      "connected_profile_id": 98765,
      "service_name": "facebook",
      "connected_by": "user@example.com",
      "profile_name": "Brand Page",
      "profile_link": "https://www.facebook.com/brandpage",
      "profile_image": "https://graph.facebook.com/brandpage/picture",
      "profile_type": "PAGE",
      "is_active": true,
      "is_enabled": true,
      "pinterest_boards": []
    },
    {
      "connected_profile_id": 98766,
      "service_name": "linkedin",
      "connected_by": "user@example.com",
      "profile_name": "Brand LinkedIn",
      "profile_link": "https://www.linkedin.com/company/brand",
      "profile_image": "https://media.linkedin.com/dms/image/brand-logo",
      "profile_type": "PAGE",
      "is_active": true,
      "is_enabled": true,
      "pinterest_boards": []
    },
    {
      "connected_profile_id": 98767,
      "service_name": "pinterest",
      "connected_by": "user@example.com",
      "profile_name": "Brand Pinterest",
      "profile_link": "https://www.pinterest.com/brand",
      "profile_image": "https://pinterest.com/brand/profile.jpg",
      "profile_type": "PROFILE",
      "is_active": true,
      "is_enabled": true,
      "pinterest_boards": [
        {
          "board_id": "board_123",
          "name": "Inspiration Board"
        },
        {
          "board_id": "board_456",
          "name": "Product Board"
        }
      ]
    }
  ]
}