Get Instagram and Facebook audience demographics
Get the top countries, cities, age ranges and genders of an Instagram or Facebook account's audience, with each value's share of the total.
Get the top countries, cities, age ranges and genders of an Instagram or Facebook account's audience, with each value's share of the total. This is the same data as the Audience tab (Top locations, Age range, Gender) in the native Instagram and Facebook apps.
Supported networks: Instagram and Facebook only. Calling this endpoint for any other network (TikTok, LinkedIn, X, Threads, YouTube, Pinterest, Bluesky, ...) returns 400. Use Get account metrics for follower counts and engagement on every network.
| Network | audience | breakdown | timeframe |
|---|---|---|---|
followers, engaged | country, city, age, gender | this_week, this_month | |
followers | country, city | ignored (latest daily snapshot) |
Instagram (Business/Creator accounts, instagram_business_manage_insights):
audience=followersoraudience=engaged(accounts that interacted with your content)breakdown:country,city,ageorgendertimeframe:this_week(last 7 days) orthis_month(last 30 days)- Requires at least 100 followers (or 100 engagements in the timeframe for
engaged)
Facebook (Pages, read_insights):
audience=followersonly,breakdowncountryorcityonly. Meta retired Page age, gender and language metrics.- Returns the latest daily snapshot;
timeframeis ignored. Requires at least 100 Page followers.
Notes: Meta returns only the top 45 values and only counts people it has demographic data for, so total can be lower than the follower count. Data can lag up to 48 hours. Languages are not available through Meta's APIs. When Meta returns no data, the response is still 200 with available: false and an unavailable_reason.
Permissions: Requires analytics:read. Access is limited by the API key creator's current organization membership and stored key ceiling. See Organization permissions.
id*stringaudience?stringfollowers or engaged (Instagram only: accounts that interacted with your content)
"followers""followers""engaged"breakdown?stringDimension to break the audience down by. Facebook supports country and city only.
"country""country""city""age""gender"timeframe?stringInstagram lookback: this_week (last 7 days) or this_month (last 30 days). Ignored for Facebook.
"this_month""this_week""this_month"Audience demographics retrieved
application/json- response
Audience demographics response
success*booleandata*curl -X GET 'https://api.outstand.so/v1/social-accounts/string/audience-demographics'{ "success": true, "data": { "account_id": "string", "network": "instagram", "audience": "followers", "breakdown": "country", "timeframe": "this_week", "available": true, "unavailable_reason": "string", "total": 0, "items": [ { "key": "string", "value": 0, "percentage": 0 } ], "as_of": "string", "fetched_at": "string" }}