Get Brand Info (V2)

​

Brand profile — identity, categorisation, per-platform follower counts, social handles — plus the artists whose audience best matches the brand.

Replaces GET /api/brand/{brandId}. The two do not share a brand universe, so a brandId from V1 is not valid here.

V1 V2
Artist list only (brandName, total, artists) Full brand profile plus the artist list
Instagram followers only instagram_followers, tiktok_followers, youtube_followers
affinity, a ratio around 1.0 audience_similarity, a 0-100 Affinity score
overlap, overlap_percent, instagram_likers.* no equivalent — the affinity model was rebuilt

Returns null in obj when the brand ID is unknown.

Path Parameters
  • brandId
    Type: integer
    min:  
    0
    max:  
    2147483647
    required

    Chartmetric brand ID.

Query Parameters
  • sortColumn
    Type: string enum

    Column used to sort the artist list. One of followers, name, audienceSimilarity. Defaults to followers.

    values
    • followers
    • name
    • audienceSimilarity
  • sortOrderDesc
    Type: boolean

    If true (default), sort sortColumn in descending order.

  • limit
    Type: integer
    min:  
    1
    max:  
    100

    Maximum number of artists to return. Defaults to 10, max 100.

  • offset
    Type: integer
    min:  
    0

    Number of items to skip from the start of the result set; pair with limit to paginate.

  • platform
    Type: string enum

    Platform each artist's followers count is reported on, which also determines the followers sort order. One of instagram, tiktok, youtube. Defaults to instagram. Does not affect audience_similarity, which always reflects the strongest platform pair.

    values
    • instagram
    • tiktok
    • youtube
Responses
  • application/json
Request Example for get/api/brand/v2/{brandId}
curl https://api.chartmetric.com/api/brand/v2/1 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": {
    "id": 138,
    "name": "Apple",
    "image_url": "https://storage.googleapis.com/cm-brand-images/138.jpg",
    "country": "US",
    "category": "Electronics & Computers",
    "sub_categories": [
      "Smartphones",
      "Computers"
    ],
    "description": "Consumer electronics and software company.",
    "instagram_followers": 33500000,
    "tiktok_followers": 2100000,
    "youtube_followers": 19800000,
    "social_links": {
      "instagram": "https://www.instagram.com/apple",
      "tiktok": "https://www.tiktok.com/@apple",
      "youtube": "https://www.youtube.com/@Apple"
    },
    "artist_count": 98864,
    "artists": [
      {
        "id": 74419,
        "name": "XXXTENTACION",
        "image_url": "https://rovimusic.rovicorp.com/image.jpg",
        "country": "US",
        "followers": 20578742,
        "genres": [
          "Hip-Hop/Rap",
          "Pop"
        ],
        "audience_similarity": 87.4,
        "brand_platform": "instagram",
        "best_artist_platform": "instagram"
      }
    ]
  }
}

Success