Instagram Platform

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

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.

Legacy IDs

Instagram Legacy API User IDs are incompatible with the Instagram Basic Display API. 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.

Media

  • Stories are not supported.
  • Comments are not supported.
  • Insights are not supported.
  • Promoted posts containing Instagram media 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.

See Also