Get Instagram user Reels & play counts
GET/v1/instagram/reels2 Credits / reel (min 10 Credits)($0.20 / 1K reels)· Updated 2026-11-15
GET /v1/instagram/reels fetches paginated public Instagram Reels for any creator or brand handle (username or user_id) without Instagram Graph API Business Discovery permissions or session cookies. Every Reel item includes media id, shortcode, play_count, view_count, like_count, comment_count, taken_at timestamp, caption, thumbnail_url, video_url stream when available, and next-page cursor. Pricing is $0.20 per 1,000 Reels (2 credits/reel, 10-credit call minimum; 0 credits on empty or failed calls) across 60–600 RPM plans.
When to Use vs. Honest Limitations
- →Signed CDN media URLs expire: Returned video_url and thumbnail_url links carry temporary CDN signatures; download or transcode MP4 assets promptly rather than storing raw URLs long-term.
- →15-minute feed cache: Reels feed pages are cached in Redis for 15 minutes (900s) to accelerate repeat reads; paid plans can append ?fresh=1 to bypass cache.
- →Public creator & brand accounts only: Accounts set to private or accounts with zero published Reels return an empty items array with 0 credits deducted.
Paginated list of public Instagram Reels (data.items) for a creator or brand, including shortcode, play_count, view_count, like_count, comment_count, thumbnail_url, and video_url when available. Aliases: /v1/instagram/user/reels, /v1/ig/reels.
Query Parameters
usernamestringrequiredInstagram username handle (
nikeor@nike) or profile URL (user_idis also accepted).Example:
nikecountinteger (1 to 50)Number of Reels to return per page (max 50).
Example:
12cursorstringPagination cursor (
data.cursorfrom the previous response).Example:
Example Request (cURL / Python / JavaScript)
curl "https://api.shortvidapi.com/v1/instagram/reels?username=nike" \
-H "x-api-key: tk_your_api_key"Live Response Preview
{
"code": 0,
"provider": "https://shortvidapi.com",
"status": "ok",
"msg": "success",
"data": {
"items": [
{
"id": "4028843203975347260",
"shortcode": "DfpU4xcsnw8",
"url": "https://www.instagram.com/reel/DfpU4xcsnw8/",
"reel_url": "https://www.instagram.com/reel/DfpU4xcsnw8/",
"type": "reel",
"is_video": true,
"caption": "",
"play_count": 4068447,
"view_count": 4068447,
"like_count": 72251,
"comment_count": 349,
"video_url": null,
"thumbnail_url": "https://scontent-lhr11-1.cdninstagram.com/v/t51.82787-15/902585854_1428840322731687_659916410608363300_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=1&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZ...",
"taken_at": null,
"created_at": null,
"is_pinned": false,
"is_paid_partnership": false,
"owner": {
"id": "13460080",
"username": "nike",
"full_name": "",
"is_verified": false,
"profile_pic_url": null
}
},
{
"id": "4018339413175004300",
"shortcode": "DfEAmf9P2yM",
"url": "https://www.instagram.com/reel/DfEAmf9P2yM/",
"reel_url": "https://www.instagram.com/reel/DfEAmf9P2yM/",
"type": "reel",
"is_video": true,
"caption": "",
"play_count": 2051746,
"view_count": 2051746,
"like_count": 27155,
"comment_count": 229,
"video_url": null,
"thumbnail_url": "https://scontent-lhr6-2.cdninstagram.com/v/t51.82787-15/869966812_1419645529812284_551875160973035464_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=109&_nc_map=urlgen_bucketless&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0...",
"taken_at": null,
"created_at": null,
"is_pinned": false,
"is_paid_partnership": false,
"owner": {
"id": "13460080",
"username": "nike",
"full_name": "",
"is_verified": false,
"profile_pic_url": null
}
}
],
"count": 12,
"cursor": "AQHToxthFSUQMVjbud-gvHLa3I4vgHimFwSTW7Q0EM2kWoPJ26u_kKlaVTBHsZEDrTnDsKt6en0_B1vCKIdJzW4aiA",
"hasMore": true
}
}Response Fields
Success (code === 0). Charged according to the endpoint credit rate.
| Field | Type | Sample / Notes |
|---|---|---|
code | integer | Example: 0 |
provider | string | Example: https://shortvidapi.com |
status | string | Example: ok |
msg | string | Example: success |
data | object | |
items | array of object | |
id | string | Example: 4028843203975347260 |
shortcode | string | Example: DfpU4xcsnw8 |
url | string | Example: https://www.instagram.com/reel/DfpU4xcsnw8/ |
reel_url | string | Example: https://www.instagram.com/reel/DfpU4xcsnw8/ |
type | string | Example: reel |
is_video | boolean | Example: true |
caption | string | Example: |
play_count | integer | Example: 4068447 |
view_count | integer | Example: 4068447 |
like_count | integer | Example: 72251 |
comment_count | integer | Example: 349 |
video_url | string | |
thumbnail_url | string | Example: https://scontent-lhr11-1.cdninstagram.com/v/t51.82787-15/902 |
taken_at | string | |
created_at | string | |
is_pinned | boolean | Example: false |
is_paid_partnership | boolean | Example: false |
owner | object | |
id | object | |
username | object | |
full_name | object | |
is_verified | object | |
profile_pic_url | object | |
count | integer | Example: 12 |
cursor | string | Example: AQHToxthFSUQMVjbud-gvHLa3I4vgHimFwSTW7Q0EM2kWoPJ26u_kKlaVTBH |
hasMore | boolean | Example: true |
Status Codes
- 200
- Success (
code === 0). Charged according to the endpoint credit rate. - 400
- Invalid parameters, or API key placed in the URL query string (not charged).
- 401
- Missing or invalid
x-api-keyheader (not charged). - 402
- Insufficient credit balance (not charged).
- 403
- Account disabled (not charged).
- 404
- Unknown endpoint or disabled unstable endpoint (not charged).
- 405
- Method not allowed — all
/v1/*data endpoints useGET(not charged). - 429
- Rate limit exceeded (not charged). Respect the
Retry-Afterheader. - 503
- Temporary upstream or gateway error (not charged). Retry with exponential backoff.
Migrating from direct scraping and hitting HTTP 403 Forbidden or empty responses on www.tiktok.com? Read How to Fix TikTok HTTP Error 403 or compare quota limits in our TikTok API Quota & Cost Calculator.