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.

Networkaudiencebreakdowntimeframe
Instagramfollowers, engagedcountry, city, age, genderthis_week, this_month
Facebookfollowerscountry, cityignored (latest daily snapshot)

Instagram (Business/Creator accounts, instagram_business_manage_insights):

  • audience=followers or audience=engaged (accounts that interacted with your content)
  • breakdown: country, city, age or gender
  • timeframe: this_week (last 7 days) or this_month (last 30 days)
  • Requires at least 100 followers (or 100 engagements in the timeframe for engaged)

Facebook (Pages, read_insights):

  • audience=followers only, breakdown country or city only. Meta retired Page age, gender and language metrics.
  • Returns the latest daily snapshot; timeframe is 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.

GET
/v1/social-accounts/{id}/audience-demographics

Path Parameters

id*string

Query Parameters

audience?string

followers or engaged (Instagram only: accounts that interacted with your content)

Default"followers"
Value in"followers""engaged"
breakdown?string

Dimension to break the audience down by. Facebook supports country and city only.

Default"country"
Value in"country""city""age""gender"
timeframe?string

Instagram lookback: this_week (last 7 days) or this_month (last 30 days). Ignored for Facebook.

Default"this_month"
Value in"this_week""this_month"

Response Body

Audience demographics retrieved

application/json
  1. response

Audience demographics response

success*boolean
data*
Example Request
curl -X GET 'https://api.outstand.so/v1/social-accounts/string/audience-demographics'
Example Response
{  "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"  }}