Instagram Audience Stats Available Dates

​

Dates (YYYY-MM-DD) for which Instagram audience analysis is available for the artist. Use these values as the date parameter on /api/artist/{id}/instagram-audience-stats to avoid empty responses. Returns 404 when the artist has no linked Instagram account.

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/dates
curl https://api.chartmetric.com/api/artist/2/instagram-audience-stats/dates \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": {
    "dates": [
      "2022-09-12",
      "2022-09-11"
    ]
  }
}

Success