Instagram Profile Reels
List a public account’s reels, a page at a time, with caption, like and comment counts and posting time, from the username.
Overview
Section titled “Overview”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.
Use cases
Section titled “Use cases”- Find a creator’s best-performing reels by likes and comments.
- Collect reel URLs for transcripts or detail lookups.
Request
Section titled “Request”curl -G "https://api.scrapier.io/api/v2/instagram-profile-reels/" \ -H "X-API-Key: YOUR_API_KEY" \ --data-urlencode "usernames=natgeo" \ --max-time 210const params = new URLSearchParams({ usernames: "natgeo" });
const res = await fetch(`https://api.scrapier.io/api/v2/instagram-profile-reels/?${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}`);
console.log(body.data.reels);import requests
resp = requests.get( "https://api.scrapier.io/api/v2/instagram-profile-reels/", headers={"X-API-Key": "YOUR_API_KEY"}, params={"usernames": "natgeo"}, timeout=210,)body = resp.json()if not resp.ok: raise RuntimeError(body.get("error") or body.get("detail"))
print(body["data"]["reels"])curl -X POST "https://api.scrapier.io/api/v2/instagram-profile-reels/" \ -H "X-API-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"usernames":"natgeo"}' \ --max-time 210Parameters
Section titled “Parameters”| Name | Type | Required | Default | Description |
|---|---|---|---|---|
X-API-Key header | string | yes | — | Your API key from the dashboard. |
usernames | string | yes | e.g. natgeo | Instagram username. |
cursor | string | no | — | 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
| Name | Type | Default | Description |
|---|---|---|---|
use_proxy | boolean | true | Route the request through Scrapier's residential proxy pool. Default: true. Leave as is unless support tells you otherwise. |
raw_data | boolean | false | When 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. |
Response
Section titled “Response”{ "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" }}Bad input. The exact message varies by endpoint.
{ "success": false, "error": "…"}Balance below the endpoint’s price.
{ "error": "Insufficient credits. Buy more to scrape more.", "balance": 1, "required": 2}Invalid or unknown API key.
{ "detail": "Authentication service unavailable or invalid API key."}Throttled — wait for Retry-After.
{ "detail": "Request was throttled. Expected available in N seconds."}Sample from the live catalog; arrays trimmed to 3 items. Results are in data.reels.
Response fields
Section titled “Response fields”| Field | Type | Example | Description |
|---|---|---|---|
usernames | string | natgeo | — |
page | integer | 1 | — |
page_size | integer | 12 | — |
reels | array | [1 item] | The results. |
next_cursor | string | zc1.eNqrVkpRslIqSy0qzszPU7JSMDLRUSrJzE0FAEf2Bp8 | Pass back as cursor for the next page. null on the last page. |
reels[].displayUrl | string | https://scontent.cdninstagram.com/v/t51.82787… | — |
reels[].caption | string | Presented by @Rolex. Welcome to Africa 🌍 Afr… | — |
reels[].ownerFullName | string | National Geographic | — |
reels[].ownerUsername | string | natgeo | — |
reels[].url | string | https://www.instagram.com/reel/DeCbRyHgmlu/ | Link to the reel. |
reels[].commentsCount | integer | 271 | Number of comments. |
reels[].firstComment | string | Absolutely stunning 😍 | Text of the first comment shown on the reel. |
reels[].likesCount | integer | 45262 | Number of likes. |
reels[].timestamp | string | 2026-10-03T15:55:06.000Z | When the reel was posted. |
reels[].scraped_at | string | 2026-10-04T10:15:00.000Z | — |
reels[].keyword | string | natgeo | — |
Pagination
Section titled “Pagination”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 };}import requests
URL = "https://api.scrapier.io/api/v2/instagram-profile-reels/"HEADERS = {"X-API-Key": "YOUR_API_KEY"}params = {"usernames": "natgeo"}items = []
for _ in range(10): # each page is one billed call resp = requests.get(URL, headers=HEADERS, params=params, timeout=210) resp.raise_for_status() data = resp.json()["data"] items.extend(data.get("reels") or []) if not data.get("next_cursor"): # None = last page break params = {"cursor": data["next_cursor"]}Errors
Section titled “Errors”Failed calls are free. Branch on the HTTP status and read the message from error (or detail). Full details in Errors.
| Status | Meaning | Retry? | Charged? |
|---|---|---|---|
400 | Bad or missing input. | No — fix the params | No |
401 / 403 | Missing, invalid or revoked API key. | No — fix the key | No |
402 | Out of credits (body has balance). | No — top up | No |
404 | Unknown endpoint slug. | No — check the slug | No |
429 / 503 | Busy or throttled. | Yes — after Retry-After | No |
5xx | Target site or upstream failure, or timeout. | Yes — with backoff | No |
- This list has no view count or duration. For a reel’s view count, use
instagram-reel-scraper.
Related
Section titled “Related”- 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.