Instagram Basic Display API

The Instagram Basic Display API allows users of your app to get basic profile information, photos, and videos in their Instagram accounts.

The API can be used to access any type of Instagram account but only provides read-access to basic data. If you are building an app that will allow Instagram Businesses or Creators to publish media, moderate comments, identify @mentioned and hashtagged media, or get data about other Instagram users, use the Instagram Graph API instead.

Common Uses

Get an Instagram User Access Token and permissions from an Instagram user
Get an Instagram user’s profile
Get an Instagram user’s images, videos, and albums

Limitations

Authentication — Instagram Basic Display is not an authentication solution. Data returned by the API cannot be used to authenticate your app users or log them into your app. If you need an authentication solution we recommend using Facebook Login instead.
App Types — Apps designated as Business apps are not supported. If your app is a Business app use the Instagram Graph API instead or create a new non-Business app.
Legacy IDs — Instagram Legacy API User IDs are not supported. If you are migrating to the Basic Display API and need to map a user's Basic Display ID to their corresponding Legacy ID, request the ig_id field on the User node. The ig_id field will return the user's Legacy ID until September 30th, 2020, when it will be deprecated.
Unsupported Media — IGTV, Stories, Reels, and Comments are not supported.
Promoted Posts — Promoted Posts containing Instagram media are not supported.
Insights — Insights are not supported.

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.