Instagram

Instagram Reels API: get Reels data as JSON (2026)

How to get Instagram Reels with an API in 2026: what the Graph API reads, a profile's Reels, keyword search, trending Reels, single-Reel details and comments.

Social FetchUpdated

To get Instagram Reels as JSON, call GET /v2/instagram/profiles/{profile}/media?tab=reels with a Social Fetch key. Each page lists a public account's Reels with captions, play, like and comment counts, audio and video links, plus a cursor for the next page. Other routes search Reels by keyword, list trending Reels and fetch one Reel in full. Meta's own API reads Reels only from professional accounts, as of November 2026.

This guide covers those routes and their costs. For spoken text, see the Instagram Reel transcript guide. For profiles, posts and comments in one walkthrough, see how to scrape Instagram data.

Two ways to get Instagram Reels data

Instagram Graph APISocial Fetch Reels routes
Your own account's ReelsYes, professional accountsYes, if public
Another account's ReelsProfessional accounts, through Business DiscoveryAny public account
Personal accountsNoYes, if public
SetupMeta app, professional account, App ReviewOne sfk_… key

What the official API can read

As of November 2026, Meta's IG Media reference gives Reels a media_product_type of REELS. It says the API returns only data for media owned by Instagram professional accounts and can't be used for media owned by personal accounts.

To read another account's Reels, an app uses Business Discovery, which reads basic metadata and metrics about other professional accounts. Meta notes that view_count for Reels is available only through Business Discovery, that data about age-gated professional accounts is not returned, and that media_url is omitted for some Reels, such as those with copyrighted or licensed audio.

For Meta's setup, see how to get an Instagram API key.

List a profile's Reels

  1. Create a free account, open API Keys and click Create key. The key starts with sfk_ and is shown once.
  2. Store it in an environment variable named SOCIALFETCH_API_KEY.
  3. Request the Reels tab of a profile's media. profile takes a handle, a profile URL or a numeric user id.
Request
bash

Read data.lookupStatus first: found, private or not_found. Private and missing profiles return an empty media list. Each item in data.media is the media object every v2 Instagram route returns, with kind set to reel:

  • id, shortcode, url, caption and createdAt;
  • owner, the posting account. Collaborator Reels can have a different owner, and coauthors lists the others;
  • metrics: playCount, likeCount, commentCount, shareCount and saveCount. A null count is unknown, not zero;
  • videoUrl, thumbnailUrl, durationSec and audio. Video and image links expire.

In this list taggedUsers is null; fetch the Reel in full for its tags. While data.page.hasMore is true, pass data.page.nextCursor as cursor with the same tab. The same route takes tab=posts, tagged or reposts. See the profile media page.

Reels search finds Reels by keyword:

Request
bash

Results come in Instagram's relevance order, not by date. A page can hold few Reels, or none, while data.page.hasMore is still true, so keep paging until it is false. For recent posts under a hashtag, use hashtag media instead.

Trending Reels takes no parameters and returns a batch of the Reels Instagram is trending now:

Request
bash

It has no cursor: call it again for another batch and expect some overlap. The feed is sometimes unavailable and answers 503 temporarily_unavailable with a Retry-After header; that is free, so retry after a few seconds.

One Reel in full

Get media returns one Reel by shortcode, Reel URL or numeric media id, with taggedUsers filled in:

Request
bash

The shortcode is the part after /reel/ in the URL. Share links under instagram.com/share/ are refused; open them and use the Reel URL they lead to. not_found means the Reel doesn't exist, was deleted or belongs to a private account. Add include=files to have Social Fetch host the Reel's video and return the link in files; that option costs more, as shown on the media page.

Comments, transcripts and audio

Credits

Each page or lookup is billed once when it is served. The price of each route is shown on its endpoint page, such as profile media, and every response reports the actual charge in meta.creditsCharged. private and not_found answers are completed lookups and are billed. Failed requests are free. Options such as include=files on media detail change the price, so read the endpoint page before turning them on. See Credits.

Instagram's Terms of Use say you can't collect information in an automated way without Meta's express permission. Social Fetch returns publicly visible Instagram data; it is not a Meta partner product and cannot give you that permission. Private accounts return lookupStatus: private rather than their Reels. Whether a public-data service fits your use depends on your jurisdiction, what you collect and how you use it. Reels are creators' work, so check rights before you republish any video. This is not legal advice.

FAQ

Is there an Instagram Reels API?

Meta's Instagram Graph API reads Reels as media with media_product_type REELS, but as of November 2026 it only returns media owned by Instagram professional accounts, and other accounts' media only through Business Discovery. For any public account's Reels, Social Fetch's GET /v2/instagram/profiles/{profile}/media?tab=reels returns them as JSON with a Social Fetch key.

How do I get all Reels from an Instagram account?

Call GET /v2/instagram/profiles/{profile}/media with tab=reels. Check data.lookupStatus, read data.media, and pass data.page.nextCursor back as cursor, with the same tab, while data.page.hasMore is true.

Can I search Instagram Reels by keyword?

Yes. GET /v2/instagram/reels/search takes a query and returns Reels in Instagram's relevance order. A page can hold few Reels or none while data.page.hasMore is still true, so keep paging until it is false.

How do I get a Reel's view count?

Each Reel's metrics include playCount, along with likeCount, commentCount, shareCount and saveCount. A count Instagram doesn't report is null, not zero. Fetch one Reel in full with GET /v2/instagram/media/{media}.

Can I get the spoken words from a Reel?

Yes. GET /v2/instagram/media/{media}/transcript returns a Reel's spoken text. The Instagram Reel transcript guide covers long videos, empty results and credits.

Can I get Reels from a private account?

No. A private profile returns lookupStatus private with an empty media list. Social Fetch only returns publicly visible data and does not log in to Instagram.

Share this article