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 API | Social Fetch Reels routes | |
|---|---|---|
| Your own account's Reels | Yes, professional accounts | Yes, if public |
| Another account's Reels | Professional accounts, through Business Discovery | Any public account |
| Personal accounts | No | Yes, if public |
| Setup | Meta app, professional account, App Review | One 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
- Create a free account, open API Keys and click Create key. The key starts with
sfk_and is shown once. - Store it in an environment variable named
SOCIALFETCH_API_KEY. - Request the Reels tab of a profile's media.
profiletakes a handle, a profile URL or a numeric user id.
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,captionandcreatedAt;owner, the posting account. Collaborator Reels can have a different owner, andcoauthorslists the others;metrics:playCount,likeCount,commentCount,shareCountandsaveCount. Anullcount is unknown, not zero;videoUrl,thumbnailUrl,durationSecandaudio. 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.
Search and trending Reels
Reels search finds Reels by keyword:
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:
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:
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
- Comments: media comments lists a Reel's top-level comments,
sort=topornewest, and comment replies reads a thread. - Spoken text: media transcript returns what is said in a Reel. The Instagram Reel transcript guide covers long videos and empty results.
- Audio: audio media lists the Reels that use a sound, from a Reel's
audio.id.
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.
Is it legal to scrape Instagram Reels?
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.