Actions24
- User Actions
- Publish Actions
- Media Actions
- Comment Actions
- Messaging Actions
- Auth (Token) Actions
User → Get Audience Demographics
AI-generatedSummary
Fetches audience demographic insights (followers, engaged, or reached audience) for the connected Instagram account from graph.instagram.com, broken down by age, city, country, or gender over a chosen timeframe.
Inputs
- Demographics Metric — Which audience to report on: follower_demographics (default), engaged_audience_demographics, or reached_audience_demographics.
- Breakdown — Dimension to split the data by: age, city, country (default), or gender.
- Timeframe — Window for the data: last_14_days, last_30_days (default), last_90_days, prev_month, this_month, or this_week.
- Graph API Version — API version used in the request path. Defaults to v21.0.
- Access Token (Override) — Optional token used instead of the Instagram Login API credential. Can be an expression so each input item uses a different account.
Output shape
One output item per entry in the API's data array (typically one insight object holding the metric name and its breakdown results). Each item is paired to its input item. If data is missing, the whole response is returned as a single item.
The request is GET /{version}/me/insights with period=lifetime and metric_type=total_value. The metric, breakdown and timeframe come from the parameters. It runs once per input item. With Continue On Fail enabled, a failed item returns {error: message}. Instagram's own requirements apply, such as permissions and minimum follower counts. The source does not check these.
Examples
Example 1: Find which countries your followers come from over the last 30 days
Demographics Metric = Follower Demographics, Breakdown = Country, Timeframe = Last 30 Days
Example 2: Compare the age groups of people who engaged with your content this month
Demographics Metric = Engaged Audience Demographics, Breakdown = Age, Timeframe = This Month
Example 3: Report on several accounts, each with its own token
Set Access Token (Override) to an expression like {{ $json.account_token }}, then pick the metric, breakdown and timeframe