Skip to content

List currently trending Instagram reels, a page at a time, with caption, like and comment counts and author. No input needed.

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

Call it with no parameters to get the trending reels feed. Each reel includes its ID, shortcode, URL, caption, like count, comment count and author.

Page on with cursor until next_cursor is null.

  • Spot trending formats and hashtags.
  • Feed a daily trends report or dashboard.
Terminal window
curl -G "https://api.scrapier.io/api/v2/instagram-trending-reels/" \
-H "X-API-Key: YOUR_API_KEY" \
--max-time 210
NameTypeRequiredDefaultDescription
X-API-Key headerstringyes—Your API key from the dashboard.
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": {
"reels": [
{
"id": "POLARIS_3989006790238596139",
"shortcode": "DdbzIqCyuwr",
"url": "https://www.instagram.com/reel/DdbzIqCyuwr/",
"caption": "#birthday #happybirthday #hbd",
"like_count": 4200,
"comment_count": 31,
"user": {
"username": "exampleuser"
}
}
],
"next_cursor": "eyJkIjoiMjc0NDk2NzgzNTEzMTk0MjMiLCJjIjoiUVZGQi4uLiIsInMiOlsiRGRienJcXHFDeXV3ciJdLCJoIjoiYWJjMTIzIn0"
}
}

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

FieldTypeExampleDescription
reelsarray[1 item]The results.
next_cursorstringeyJkIjoiMjc0NDk2NzgzNTEzMTk0MjMiLCJjIjoiUVZGQ…Pass back as cursor for the next page. null on the last page.
reels[].idstringPOLARIS_3989006790238596139—
reels[].shortcodestringDdbzIqCyuwr—
reels[].urlstringhttps://www.instagram.com/reel/DdbzIqCyuwr/—
reels[].captionstring#birthday #happybirthday #hbd—
reels[].like_countinteger4200—
reels[].comment_countinteger31—
reels[].userobject{…}—

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-trending-reels/";
let params = {};
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
  • Nothing special: send the inputs, read the result.
  • Instagram Audio Reels — List the reels that use a given Instagram audio track, with author, engagement counts and computed metrics, from the numeric audio ID.
  • Instagram Popular Search — Search Instagram by keyword without a login and get top posts and reels, related search terms and the topic’s total media count.