Get Instagram 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.

GET /v1/analytics/instagram/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.

Parameters

• accountId (query, string) required — The Zernio SocialAccount ID for the Instagram account

• metric (query, string) — "follower_demographics" for follower audience data, or "engaged_audience_demographics" for engaged viewers.

• breakdown (query, string) — Comma-separated list of demographic dimensions: age, city, country, gender. Defaults to all four if omitted.

• timeframe (query, string) — Time period for demographic data. Defaults to "this_month".

Responses

200 — Demographic insights data

• success (boolean)
• accountId (string) — The Zernio SocialAccount ID
• platform (string)
• metric (string) (enum: follower_demographics, engaged_audience_demographics)
• timeframe (string) (enum: this_week, this_month) — The timeframe used for demographic data
• demographics (object) — Object keyed by breakdown dimension (age, city, country, gender)
• note (string)

400 — Bad request (invalid parameters)

• error (string)

401

402 — Analytics access required. Legacy plans need the Analytics add-on; included by default on usage-based plans.

• error (string)
• code (string)

403 — Access denied to this account

• error (string)

404 — Account not found

• error (string)