Instagram Graph Explained — API, Data & How It Works (2026)

What is the Instagram Graph? How the Instagram Graph API works, what data it provides, and how developers and businesses use it.

SociaHive
SociaHive Team

Published April 16, 2026

The "Instagram Graph" refers to Meta's data structure and API system that represents Instagram accounts, posts, comments, messages, and relationships as interconnected nodes. The Instagram Graph API is the official way developers access this data programmatically.

If you have seen the term "Instagram Graph" in documentation, API references, or developer tools, this guide explains what it means, how it works, and what you can do with it.

What Is the Instagram Graph?

Meta models Facebook and Instagram data as a graph of objects. The Graph API documentation uses three specific terms:

  • Nodes — individual objects with a unique ID, such as a User, a Media post, a Comment, or a Page.
  • Edges — named connections from a node to a collection of related nodes. For example, /{ig-user-id}/media is the media edge of an Instagram User node and returns the posts that belong to that user.
  • Fields — properties of a single node, such as a User's username, a Media's caption, or a Comment's timestamp.

When you call GET /{ig-user-id}/media, you are walking the media edge of your User node. The endpoint returns image, video, Reels, and carousel posts. Stories are not included on the media edge — they live on a separate stories edge (GET /{ig-user-id}/stories).

Instagram Graph API — The Practical Part

The Instagram Graph API is the HTTP interface that lets you query this graph. It provides endpoints for:

Content Management

  • Read media (posts, Reels, Stories) and their metadata
  • Publish new posts and Reels via Content Publishing API
  • Manage comments (read, reply, delete, hide)
Messaging
  • Send and receive Instagram DMs via the Messaging API
  • Handle message reactions and read receipts
  • Support for text, images, buttons, and carousel messages
Business Data
  • Account insights (reach, impressions, follower demographics)
  • Media insights (engagement per post, video views, saves)
  • Online followers (when your audience is active)
Account Information
  • Profile data (username, bio, follower count, following count)
  • Connected Facebook Page
  • Business category and contact information

How to Access the Instagram Graph API

Meta currently offers two login flows for the Instagram Platform. Pick the one that matches your use case:

Instagram API with Instagram Login (recommended, launched July 23, 2024)

  • No Facebook Page required — users authenticate directly with Instagram.
  • Base URL: graph.instagram.com
  • Tokens: short-lived (1 hour) from the business login flow, or long-lived (60 days) from the App Dashboard.
Instagram API with Facebook Login (legacy)
  • Requires the Instagram Business/Creator account to be linked to a Facebook Page.
  • Base URL: graph.facebook.com
  • Useful when your app already manages Facebook Pages alongside Instagram.
Setup steps (either flow):

    • Create a Meta Developer account at developers.facebook.com.
    • Create a Meta app of type Business.
    • Add the Instagram product to your app and pick the login flow above.
    • For Facebook Login: connect an Instagram Business/Creator account through a Facebook Page. For Instagram Login: configure the business login redirect.
    • Generate an access token.
    • Call the appropriate base URL.
Requirements:
  • Instagram Business or Creator account (personal accounts cannot use the Graph API).
  • Approved app permissions. For messaging, you need instagram_business_basic plus instagram_business_manage_messages on the Instagram Login flow (the Facebook Login flow uses instagram_manage_messages).

Instagram Graph API Pricing

The API is free. Meta does not charge for API access. There are no per-call fees, no monthly API charges, and no per-message costs for Instagram DMs.

Your costs come from:

  • Hosting your application (server costs)
  • If using a platform like SociaHive instead of building directly, the platform subscription

See our Instagram Graph API glossary entry for more details.

Rate Limits

Instagram Platform uses Meta's Business Use Case (BUC) rate limiting, calculated per Instagram professional account on a 24-hour rolling window:

> Calls within 24 hours = 4800 × Number of Impressions

"Impressions" here means the number of times any content from the app user's Instagram professional account has entered a person's screen within the last 24 hours. The limit scales with the account's reach — a small account gets a much smaller budget than a large one.

Beyond the BUC formula, there are a few hard limits and rules to know:

Endpoint / BehaviorLimit
Content Publishing100 published posts per Instagram account per 24 hours (carousels count as one)
Messaging windowApp must reply within 24 hours of a user's message; cannot initiate conversations
Stale messagesMessages older than 30 days in the Requests folder are not returned by the API

Limits are calculated per Instagram account, not per app. If your app manages 100 accounts, each one has its own 24-hour BUC budget.

Common Use Cases

DM Automation ToolsSociaHive, ManyChat, and Chatfuel use the Messaging API to send automated DMs when users comment keywords or send messages.

Social Media Schedulers — Buffer, Later, and Hootsuite use the Content Publishing API to schedule and publish posts and Reels.

Analytics Platforms — Sprout Social, Iconosquare, and similar tools use the Insights API to pull engagement data and generate reports.

CRM Integrations — Businesses connect Instagram conversation data to CRMs like HubSpot and Salesforce through the Messaging API.

Frequently Asked Questions

Is the Instagram Graph API free?

Yes. Meta does not charge for Instagram Graph API access. There are no per-call fees or monthly charges. You need a Meta Developer account (free) and an approved app.

What is an Instagram Graph?

The Instagram Graph is Meta's data model where accounts, posts, comments, and messages are represented as interconnected nodes. The Instagram Graph API lets developers query this data structure to read and write Instagram data programmatically.

What replaced the Instagram Basic Display API?

Meta sunset the Instagram Basic Display API on December 4, 2024 — all requests to it now return an error. Meta's recommended replacement is the Instagram API (Instagram Platform), specifically the Instagram API with Instagram Login flow, which lets apps access Instagram Business and Creator account data without requiring a Facebook Page.

Can I use the Instagram Graph API with a personal account?

No. The Instagram Graph API requires a Business or Creator account. Personal accounts cannot access the API. Switching to a Business or Creator account is free, reversible, and takes less than a minute in Instagram → Settings → Account type and tools. A Facebook Page is only required if you use the Facebook Login flow; the Instagram Login flow (launched July 23, 2024) does not need one.

Ready to automate your Instagram?

7-day free trial included. Plans from $29/mo. No credit card required.

Get Started