Skip to main content
Analytics

Get Instagram demographics

Returns Instagram follower, engaged-audience, or reached-audience demographics by age, city, country, and/or gender. Meta returns at most 45 entries per dimension, requires a sufficient audience, and may delay data by up to 48 hours. Each call costs 1 credit.

GET/v1/analytics/instagram/demographics

Authorization

accessKey
x-access-key<token>

In: header

Query Parameters

accountId*string

Integration ID for the connected Instagram account.

metric?||

Audience whose demographic data should be returned.

Default"follower_demographics"
breakdown?string

Comma-separated demographic dimensions: age, city, country, gender. Defaults to all four.

Default"age,city,country,gender"
timeframe?|

Meta demographic timeframe. this_week covers the last 7 days; this_month covers the last 30 days.

Default"this_month"

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/analytics/instagram/demographics?accountId=string"
{
  "success": true,
  "accountId": "string",
  "platform": "instagram",
  "metric": "follower_demographics",
  "timeframe": "this_week",
  "demographics": {
    "age": [
      {
        "dimension": "string",
        "value": 0
      }
    ],
    "city": [
      {
        "dimension": "string",
        "value": 0
      }
    ],
    "country": [
      {
        "dimension": "string",
        "value": 0
      }
    ],
    "gender": [
      {
        "dimension": "string",
        "value": 0
      }
    ]
  },
  "note": "string"
}
{
  "success": true,
  "message": "string"
}
{
  "success": true,
  "message": "string"
}
{
  "success": true,
  "message": "string"
}
{
  "success": true,
  "message": "string"
}