Instagram audience demographics API for raw analytics data
Access raw Instagram audience data including follower age splits, gender distribution, city and country reach, and impression-by-time data. Build custom reporting without the Meta dashboard.
Last updated: May 2026
1// Raw Instagram account analytics: GET /api/v1/analytics/social-account/raw2const res = await fetch(3 "https://api.bundle.social/api/v1/analytics/social-account/raw?teamId=team_123&platformType=INSTAGRAM",4 { headers: { "x-api-key": process.env.BUNDLE_SOCIAL_API_KEY } }5);6const { socialAccount, items } = await res.json();7// When raw demographics are enabled for your org, items[0].raw includes:8// { profileInfo, totals30d: [...], demographics: [...] } (see API reference: raw analytics)Accessing Instagram analytics natively
What bundle.social handles
Instagram audience data without the Meta Graph API project
bundle.social collects Instagram audience demographics from connected accounts and returns raw data via API. No Meta app review, no Insights permission scoping, no separate integration project.
Workflow
How it works
Connect an Instagram account, then GET raw social account analytics for team and platform to read stored profile, insights, and demographics payloads.
Connect an Instagram account
Connect a business or creator Instagram account via the OAuth connect URL flow.
Pull raw account analytics
GET /api/v1/analytics/social-account/raw with teamId and platformType=INSTAGRAM. items contains raw Instagram Graph API shaped snapshots, newest first.
Build your dashboards
Parse items[0].raw: profileInfo, totals30d (Insights series), and demographics (when raw Instagram demographics are enabled for your organization).
Capabilities
Instagram demographic data for reporting and audience analysis
Age groups, gender, cities, countries, and impression timing. Raw data from Instagram through one API.
Impressions by hour and day
Access impression timing data to find when your audience is most active and schedule content accordingly.
Age group splits
See how your Instagram followers break down by age bracket to guide content tone and paid targeting.
Top cities and countries
See which cities and countries your Instagram followers are located in to guide geo campaigns.
Gender distribution
Understand the gender makeup of your Instagram audience for creative and campaign planning.
Raw data for custom dashboards
The response returns raw JSON data ready for Looker, Tableau, your internal BI tool, or a client-facing dashboard.
No Meta API credentials required
bundle.social handles Instagram auth and data collection. Your product only needs the bundle.social API key.
Developer example
Fetch raw Instagram social account analytics
Examples use bundle.social's public API shape: API key authentication, a post date, selected social account types, and platform-specific data.
1// GET /api/v1/analytics/social-account/raw?teamId=...&platformType=INSTAGRAM2// Response: { socialAccount, items: SocialAccountAnalyticsRaw[] }3// Instagram item.raw (when demographics are enabled) is shaped like:4// {5// profileInfo: { ...IG user object },6// totals30d: [ { name: "likes", period: "day", values: [...] }, ... ],7// demographics: [ ... demographic insight series from Instagram ... ]8// }910const res = await fetch(11 "https://api.bundle.social/api/v1/analytics/social-account/raw?teamId=team_123&platformType=INSTAGRAM",12 { headers: { "x-api-key": process.env.BUNDLE_SOCIAL_API_KEY } }13);14const { socialAccount, items } = await res.json();15const latest = items[0];16const ig = latest?.raw as {17 profileInfo?: unknown;18 totals30d?: unknown[];19 demographics?: unknown[];20};21// Example: const series = ig?.totals30d; const demo = ig?.demographics;Supported content
Honest limitations
- Audience demographic data availability depends on the connected Instagram account type and Meta permissions.
- Instagram business or creator account status is required for demographic data access.
Guarantees
Developer-first infrastructure
2% error rate
We handle the platform edge cases, media processing, and rate limits so your requests succeed.
Verbose errors
When native APIs fail, we return human-readable error messages and actionable recovery steps.
Flat pricing
No per-post counting. Predictable pricing for teams managing many users, workspaces, and connected accounts.
Same-day support
Direct access to the engineers building the API. We respond to technical issues the same day. Sometimes the same hour. Test us c;
FAQ
Questions developers ask before building
What Instagram demographic data is available?
bundle.social provides raw audience demographics including follower age splits, gender distribution, top cities, top countries, and impression-by-hour data for connected Instagram accounts.
Do I need Meta Graph API credentials?
No. bundle.social handles Instagram authentication and data collection. You only need a bundle.social API key.
Does this require a business or creator account?
Yes. Meta restricts demographic analytics to Instagram business and creator accounts. Personal accounts do not expose this data.
Can I use this data in my own dashboards?
Yes. The raw JSON response can be piped into any reporting tool, dashboard builder, or data warehouse.