Instagram Platform

Instagram Graph API

IGTV media is now supported in v10.0+. This applies to all endpoints except those used for content publishing and webhooks. To support this change, new media_product_type and video_title fields have been added to the IG Media node. IGTV media must have been shared to Instagram at the time of publish (Post a Preview or Share Preview to Feed enabled) in order to be accessible via the API.

The Instagram Graph API allows Instagram Professionals — Businesses and Creators — to use your app to manage their presence on Instagram. The API can be used to get and publish their media, manage and reply to comments on their media, identify media where they have been @mentioned by other Instagram users, find hashtagged media, and get basic metadata and metrics about other Instagram Businesses and Creators.

The API is intended for Instagram Businesses and Creators who need insight into, and full control over, all of their social media interactions. If you are building an app for consumers or you only need to get an app user's basic profile information, photos, and videos, consider the Instagram Basic Display API instead.

The API is built on the Facebook Graph API. If you are unfamiliar with the Facebook Graph API, please read our Facebook Graph API documentation to learn how it works before proceeding.

Common Uses

Limitations

  • The API cannot access Instagram consumer accounts (i.e., non-Business or non-Creator Instagram accounts). If you are building an app for consumer users, use the Instagram Basic Display API instead.
  • Content Publishing is only available to Instagram Business Users.
  • Reels are not supported.
  • ordering results is not supported
  • all endpoints support cursor-based pagination, but the User Insights edge is the only endpoint that supports time-based pagination

Documentation Contents

Overview

Explanations of core concepts and usage requirements.

Get Started

A short tutorial to get you up and running.

Guides

Use case based guides to help you perform specific actions.

Reference

Component and endpoint references.

See Also