---
title: "Get Brand Info (deprecated)"
method: GET
path: "/api/brand/{brandId}"
tags: ["Brand"]
---

# Get Brand Info (deprecated)

`GET /api/brand/{brandId}`

## Request

- Base URL: `https://api.chartmetric.com`
- URL: `https://api.chartmetric.com/api/brand/{brandId}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/docs/api/brand/:brandId/get.ts> (a function with typed inputs; its response is checked against the schema)

**Deprecated — removed after 2026-10-01. Use `GET /api/brand/v2/{brandId}` instead.** Artists whose audience is interested in a brand, with Instagram follower/liker overlap and affinity. Sortable by any of `followers`, `likers`, `follower_overlap`, `liker_overlap`, `follower_affinity`, `liker_affinity`.

## Path parameters

- `brandId` integer, required: Chartmetric brand ID.

## Query parameters

- `sortColumn` 'followers' | 'likers' | 'follower_overlap' | 'liker_overlap' | 'follower_affinity' | 'liker_affinity': Column used to sort artists. One of `followers`, `likers`, `follower_overlap`, `liker_overlap`, `follower_affinity`, `liker_affinity`. Defaults to `followers`.
- `sortOrderDesc` boolean: If true (default), sort `sortColumn` in descending order.
- `limit` integer: Maximum number of artists to return. Defaults to 10, max 50.
- `offset` integer: Number of items to skip from the start of the result set; pair with `limit` to paginate.

## Response `200`

Success

- object
  - `obj` object
    - `brandName` string, nullable: Brand name.
    - `total` integer, required: Total number of artists with an audience interested in this brand.
    - `artists` object[], required: Artists ranked by the requested `sortColumn`, paginated by `limit`/`offset`.
      - `id` union, required: Chartmetric artist ID. May be returned as a string or number.
        - string
        - number, float
      - `code2` string, nullable: ISO 3166-1 alpha-2 country code (2 letters, e.g. 'US', 'BR', 'GB').
      - `name` string, nullable: Artist name.
      - `genres` string[], required: Up to three smart-ordered genre names for the artist.
      - `image_url` string, nullable: Artist image URL.
      - `instagram_followers` object: Instagram follower overlap and affinity stats for the artist's audience.
        - `total` integer, nullable: Total Instagram followers of the artist.
        - `overlap` integer, nullable: Followers of the artist whose audience is interested in this brand.
        - `overlap_percent` number, float, nullable: Share of the artist's followers interested in this brand (0–1).
        - `affinity` number, float, nullable: Affinity of the artist's follower base toward the brand vs. the average artist (1.0 = average).
      - `instagram_likers` object: Instagram liker overlap and affinity stats for the artist's audience.
        - `average` integer, nullable: Average Instagram likes per post for the artist.
        - `overlap` integer, nullable: Likers of the artist's posts whose audience is interested in this brand.
        - `overlap_percent` number, float, nullable: Share of the artist's likers interested in this brand (0–1).
        - `affinity` number, float, nullable: Affinity of the artist's liker base toward the brand vs. the average artist (1.0 = average).

---

[API](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api.md) - [All operations](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/revisions/94dac96833a3?raw)