Get Instagram audience demographics

Returns audience demographic insights for an Instagram account, broken down by age, city, country, and/or gender. Requires at least 100 followers. Returns top 45 entries per dimension. Data may be delayed up to 48 hours. Requires the Analytics add-on.

Authorization

AuthorizationBearer <token>

API key authentication - use your Zernio API key as a Bearer token

In: header

Query Parameters

accountIdstring

The Zernio SocialAccount ID for the Instagram account

metric?string

"follower_demographics" for follower audience data, or "engaged_audience_demographics" for engaged viewers.

Default"follower_demographics"

Value in"follower_demographics" | "engaged_audience_demographics"

breakdown?string

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

timeframe?string

Time period for demographic data. Defaults to "this_month".

Default"this_month"

Value in"this_week" | "this_month"

Response Body

application/json

curl -X GET "https://zernio.com/api/v1/analytics/instagram/demographics?accountId=string"

{
  "success": true,
  "accountId": "64e1a2b3c4d5e6f7a8b9c0d1",
  "platform": "instagram",
  "metric": "follower_demographics",
  "timeframe": "last_30_days",
  "demographics": {
    "age": [
      {
        "dimension": "25-34",
        "value": 4500
      },
      {
        "dimension": "18-24",
        "value": 3200
      }
    ],
    "gender": [
      {
        "dimension": "M",
        "value": 3000
      },
      {
        "dimension": "F",
        "value": 4800
      }
    ],
    "city": [
      {
        "dimension": "New York, New York",
        "value": 800
      },
      {
        "dimension": "Los Angeles, California",
        "value": 650
      }
    ],
    "country": [
      {
        "dimension": "US",
        "value": 5000
      },
      {
        "dimension": "GB",
        "value": 1200
      }
    ]
  },
  "note": "Demographics show top 45 entries per dimension. Requires 100+ followers."
}

{
  "error": "Invalid breakdowns: location",
  "validBreakdowns": [
    "age",
    "city",
    "country",
    "gender"
  ]
}

{
  "error": "Unauthorized"
}

{
  "error": "Analytics add-on required",
  "code": "analytics_addon_required"
}

{
  "error": "Access denied to this account"
}

{
  "error": "Account not found"
}

Get Instagram audience demographics

Authorization

AuthorizationBearer <token>

API key authentication - use your Zernio API key as a Bearer token

In: header

Query Parameters

accountIdstring

The Zernio SocialAccount ID for the Instagram account

metric?string

"follower_demographics" for follower audience data, or "engaged_audience_demographics" for engaged viewers.

Default"follower_demographics"

Value in"follower_demographics" | "engaged_audience_demographics"

breakdown?string

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

timeframe?string

Time period for demographic data. Defaults to "this_month".

Default"this_month"

Value in"this_week" | "this_month"

Response Body

application/json

curl -X GET "https://zernio.com/api/v1/analytics/instagram/demographics?accountId=string"

curl -X GET "https://zernio.com/api/v1/analytics/instagram/demographics?accountId=string"

{
  "success": true,
  "accountId": "64e1a2b3c4d5e6f7a8b9c0d1",
  "platform": "instagram",
  "metric": "follower_demographics",
  "timeframe": "last_30_days",
  "demographics": {
    "age": [
      {
        "dimension": "25-34",
        "value": 4500
      },
      {
        "dimension": "18-24",
        "value": 3200
      }
    ],
    "gender": [
      {
        "dimension": "M",
        "value": 3000
      },
      {
        "dimension": "F",
        "value": 4800
      }
    ],
    "city": [
      {
        "dimension": "New York, New York",
        "value": 800
      },
      {
        "dimension": "Los Angeles, California",
        "value": 650
      }
    ],
    "country": [
      {
        "dimension": "US",
        "value": 5000
      },
      {
        "dimension": "GB",
        "value": 1200
      }
    ]
  },
  "note": "Demographics show top 45 entries per dimension. Requires 100+ followers."
}

{
  "error": "Invalid breakdowns: location",
  "validBreakdowns": [
    "age",
    "city",
    "country",
    "gender"
  ]
}

{
  "error": "Unauthorized"
}

{
  "error": "Analytics add-on required",
  "code": "analytics_addon_required"
}

{
  "error": "Access denied to this account"
}

{
  "error": "Account not found"
}

Get Instagram audience demographics

Authorization

Query Parameters

Response Body

200application/json

400application/json

401application/json

402application/json

403application/json

404application/json

Example invalidBreakdown

Example insufficientFollowers

Get Instagram audience demographics

Authorization

Query Parameters

Response Body

200application/json

400application/json

401application/json

402application/json

403application/json

404application/json

Example invalidBreakdown

Example insufficientFollowers

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json