Skip to content

List a public account’s reels, a page at a time, with caption, like and comment counts and posting time, from the username.

GET · POST1 credit / successful callCursor-paginated
GEThttps://api.scrapier.io/api/v2/instagram-profile-reels/Open in Playground

Send a username in usernames and get back the account’s reels in reels, each with its URL, caption, cover image URL, like and comment counts, first comment, owner and posting time.

Page on with cursor until next_cursor is null.

  • Find a creator’s best-performing reels by likes and comments.
  • Collect reel URLs for transcripts or detail lookups.
Terminal window
curl -G "https://api.scrapier.io/api/v2/instagram-profile-reels/" \
-H "X-API-Key: YOUR_API_KEY" \
--data-urlencode "usernames=natgeo" \
--max-time 210
NameTypeRequiredDefaultDescription
X-API-Key headerstringyes—Your API key from the dashboard.
usernamesstringyese.g. natgeoInstagram username.
cursorstringno—Pagination cursor returned in the previous response's next_cursor. Pass it back unchanged to fetch the next page. When next_cursor is null, you have reached the last page.
Advanced
NameTypeDefaultDescription
use_proxybooleantrueRoute the request through Scrapier's residential proxy pool. Default: true. Leave as is unless support tells you otherwise.
raw_databooleanfalseWhen true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under raw_responses, in place of the formatted items. When false (default) you get the formatted output. Pagination (cursor / next_cursor) works the same in both modes.
{
"success": true,
"data": {
"usernames": "natgeo",
"page": 1,
"page_size": 12,
"reels": [
{
"displayUrl": "https://scontent.cdninstagram.com/v/t51.82787-15/836726322_18703861135019133_5009537659781010846_n.jpg",
"caption": "Presented by @Rolex. Welcome to Africa 🌍 Africa Earth’s Wild Home takes you deep into the heart of our wildest continent.",
"ownerFullName": "National Geographic",
"ownerUsername": "natgeo",
"url": "https://www.instagram.com/reel/DeCbRyHgmlu/",
"commentsCount": 271,
"firstComment": "Absolutely stunning 😍",
"likesCount": 45262,
"timestamp": "2026-10-03T15:55:06.000Z",
"scraped_at": "2026-10-04T10:15:00.000Z",
"keyword": "natgeo"
}
],
"next_cursor": "zc1.eNqrVkpRslIqSy0qzszPU7JSMDLRUSrJzE0FAEf2Bp8"
}
}

Sample from the live catalog; arrays trimmed to 3 items. Results are in data.reels.

FieldTypeExampleDescription
usernamesstringnatgeo—
pageinteger1—
page_sizeinteger12—
reelsarray[1 item]The results.
next_cursorstringzc1.eNqrVkpRslIqSy0qzszPU7JSMDLRUSrJzE0FAEf2Bp8Pass back as cursor for the next page. null on the last page.
reels[].displayUrlstringhttps://scontent.cdninstagram.com/v/t51.82787…—
reels[].captionstringPresented by @Rolex. Welcome to Africa 🌍 Afr…—
reels[].ownerFullNamestringNational Geographic—
reels[].ownerUsernamestringnatgeo—
reels[].urlstringhttps://www.instagram.com/reel/DeCbRyHgmlu/Link to the reel.
reels[].commentsCountinteger271Number of comments.
reels[].firstCommentstringAbsolutely stunning 😍Text of the first comment shown on the reel.
reels[].likesCountinteger45262Number of likes.
reels[].timestampstring2026-10-03T15:55:06.000ZWhen the reel was posted.
reels[].scraped_atstring2026-10-04T10:15:00.000Z—
reels[].keywordstringnatgeo—

Pass data.next_cursor back as cursor until it is null. Required inputs are ignored once a cursor is sent. Each page is one billed call. More in Pagination.

const url = "https://api.scrapier.io/api/v2/instagram-profile-reels/";
let params = { usernames: "natgeo" };
const items = [];
for (let page = 0; page < 10; page++) { // each page is one billed call
const res = await fetch(`${url}?${new URLSearchParams(params)}`, {
headers: { "X-API-Key": "YOUR_API_KEY" },
signal: AbortSignal.timeout(210_000),
});
const body = await res.json();
if (!res.ok) throw new Error(body.error ?? body.detail ?? `HTTP ${res.status}`);
const data = body.data;
items.push(...(data.reels ?? []));
if (!data.next_cursor) break; // null = last page
params = { cursor: data.next_cursor };
}

Failed calls are free. Branch on the HTTP status and read the message from error (or detail). Full details in Errors.

StatusMeaningRetry?Charged?
400Bad or missing input.No — fix the paramsNo
401 / 403Missing, invalid or revoked API key.No — fix the keyNo
402Out of credits (body has balance).No — top upNo
404Unknown endpoint slug.No — check the slugNo
429 / 503Busy or throttled.Yes — after Retry-AfterNo
5xxTarget site or upstream failure, or timeout.Yes — with backoffNo
  • This list has no view count or duration. For a reel’s view count, use instagram-reel-scraper.
  • Instagram Profile Posts — List a public account’s feed posts, a page at a time, with caption, like and comment counts and media type, from the username.
  • Instagram Reel — Fetch one Instagram reel by URL or shortcode, with caption, owner, view, like and comment counts and its latest comments.
  • Instagram Transcript — Transcribe the speech in an Instagram reel or video post from its URL, with detected language and the post’s like and comment counts.