Instagram Audience Stats

​

Instagram audience analysis for an artist (latest report or historical via date). Geo breakdown (top countries / cities for both followers and likers), gender/age + ethnicity + brand affinity + interest rollups for followers and likers, plus engagement metrics (followers, avg_likes_per_post, avg_commments_per_post, engagement_rate) and notable followers. Pass geoOnly=true to drop demographic rollups and notable followers. Dates for which data is available are listed at /api/artist/{id}/instagram-audience-stats/dates.

Path Parameters
  • id
    Type: integer
    min:  
    2
    max:  
    2147483647
    required

    Chartmetric artist ID. Note: id=1 ('Various Artists') is rejected.

    • enum
      const:  
      1
      values
      • 1
Query Parameters
  • date
    Type: string Format: date

    Historical date (YYYY-MM-DD). When omitted, returns the most recent available report. Use the dates endpoint to discover available dates.

  • geoOnly
    Type: boolean

    If true, drop demographic / brand-affinity / interest / notable-followers blocks and return only geo + engagement counters.

Responses
  • application/json
Request Example for get/api/artist/{id}/instagram-audience-stats
curl https://api.chartmetric.com/api/artist/2/instagram-audience-stats \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": {
    "top_countries": [
      {
        "name": "United States",
        "code": "us",
        "percent": "24.79",
        "followers": 7661481
      }
    ],
    "top_cities": [
      {
        "name": "New York City",
        "state": "New York",
        "country": "United States",
        "percent": "1.57",
        "followers": 486692
      }
    ],
    "likers_top_countries": [
      {
        "name": "Indonesia",
        "code": "id",
        "percent": "23.94",
        "likes": 881672709
      }
    ],
    "likers_top_cities": [
      {
        "name": "Jakarta",
        "country": "Indonesia",
        "percent": "1.53",
        "likes": 56389121
      }
    ],
    "audience_genders": [
      {
        "code": "male",
        "weight": "64.81"
      },
      {
        "code": "female",
        "weight": "35.19"
      }
    ],
    "followers": 30905034,
    "avg_likes_per_post": 716758,
    "avg_commments_per_post": 7136,
    "engagement_rate": 2.3423,
    "timestp": "2022-04-03"
  }
}

Success