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.
Request
- Base URLhttps://api.chartmetric.com
- AuthHTTP bearer
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Path parameters
Chartmetric brand ID.
Query parameters
Column used to sort the artist list. One of followers, name, audienceSimilarity. Defaults to followers.
If true (default), sort sortColumn in descending order.
Maximum number of artists to return. Defaults to 10, max 100.
Number of items to skip from the start of the result set; pair with limit to paginate.
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.
Response
Success
Changes
No recorded changes to this operation across all 1 revision of this API.