Brand2Social API Documentation

Comprehensive guide to Brand2Social API endpoints

Fetch All Reviews

Retrieve all reviews for a Google My Business profile. Specify the brand_id and connected_profile_id (from social-connect). Optionally include a pagination token to fetch subsequent pages. Returns review details, including reviewer information, star ratings, comments, and replies. Supported platform: Google My Business only.

  • Method: POST
  • Endpoint: /api/api-services/v1/brand-service/fetch-all-review
  • Returns: List of reviews with details and pagination information

Fetch All Reviews

POST https://app.brand2social.com/api/api-services/v1/brand-service/fetch-all-review

FieldTypeRequiredDescription
Authorizationstring (header)YesBearer token for authentication (requires ORG_ADMIN permission)
brand_idint64YesID of the brand
connected_profile_idint64YesID of the connected Google My Business profile (from social-connect)
paginationstringNoPagination token for fetching subsequent pages of reviews
    
    
curl --location 'https://app.brand2social.com/api/api-services/v1/brand-service/fetch-all-review' \
  --header 'Authorization: Bearer B2S_dummyToken' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "brand_id": 123,
    "connected_profile_id": 98769,
    "pagination": ""
}'
    
  

Response

{
  "status": "SUCCESS",
  "http_code": 200,
  "message": "Fetched all reviews successfully",
  "data": {
    "id": "gmb_001",
    "name": "Example Business",
    "url": "https://example.com/profile.jpg",
    "pagination": "next_page_token_123",
    "reviews": [
      {
        "review_id": "review_001",
        "reviewer": {
          "name": "John Doe",
          "profile_url": "https://example.com/johndoe"
        },
        "star_rating": "FIVE",
        "comment": "Great service!",
        "created_time": "2025-08-23T12:00:00Z",
        "updated_time": "2025-08-23T12:00:00Z",
        "review_reply": {
          "comment": "Thank you for your feedback!",
          "update_time": "2025-08-23T12:30:00Z"
        },
        "name": "Review for Example Business"
      },
      {
        "review_id": "review_002",
        "reviewer": {
          "name": "Jane Smith",
          "profile_url": "https://example.com/janesmith"
        },
        "star_rating": "FOUR",
        "comment": "Good experience overall.",
        "created_time": "2025-08-22T15:00:00Z",
        "updated_time": "2025-08-22T15:00:00Z",
        "review_reply": null,
        "name": "Review for Example Business"
      }
    ],
    "average_rating": 4.5,
    "total_review_count": 2
  }
}

Error Response

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