API reference / Instagram / Reels by username
Reels by username
Reels among the most recent posts of a username. Each page scans 12 posts and returns the reels among them, so pages=3 checks the latest 36 posts.
2 credits per successful call
Errors are never charged
Request
GET
https://socialgraph.dev/api/v1/instagram/reels
Send your API key as Authorization: Bearer YOUR_API_KEY.
Parameters go in the query string.
Parameters
| Name | Type | Description |
|---|---|---|
usernamerequired |
string | Instagram username, e.g. apple. |
pagesoptional |
integer
1–10 |
How many pages of 12 recent posts to scan for reels, 1–10. Defaults to 1. |
Code examples
Example response
[
{
"post": {
"id": "3997709076073266764",
"owner": {
"id": "5821462185",
"username": "apple"
},
"caption": "In a whole new light.\n\nReuben Wu takes a different approach to low-light photography …",
"post_date": "2026-09-30T16:01:20Z",
"short_code": "Dd6tzlSs75M",
"display_url": "https://scontent.cdninstagram.com/v/t51.82787-15/831118389_….jpg",
"product_type": "clips",
"accessibility_caption": "Video by apple on September 30, 2026. May be an image of monument and text."
}
},
"… one item per reel"
]Errors
| Status | Meaning | Charged? |
|---|---|---|
| 401 | Missing, invalid or revoked API key | No |
| 402 | Not enough credits (insufficient_credits) | No |
| 404 | The account or post doesn't exist | No |
| 422 | Missing or invalid parameters | No |
| 502 / 503 | The data source is temporarily unavailable | No |
Try it live: Reels by username
GET
🔒 Preset demo input. Live demos use Instagram's own account, @instagram. Sign up free to use your own.
More Instagram endpoints
GET
Profile details by username
Public profile details for a username: bio, links, counts, verification and profile picture.
/api/v1/instagram/profile
2 credits / call
GET
Profile details by user ID
Public profile details for a numeric Instagram user ID.
/api/v1/instagram/profile-by-id
2 credits / call
GET
Follower & following counts
Follower count, following count and user ID for a username.
/api/v1/instagram/follow-counts
2 credits / call
GET
Post details
Details of a single post or reel by shortcode, without the view count.
/api/v1/instagram/post-details
2 credits / call
GET
Reel details with view count
Full details of a single reel by shortcode, including its view count.
/api/v1/instagram/reel-details-with-views
2 credits / call
GET
Latest 12 posts & reels
The 12 most recent posts and reels of a username.
/api/v1/instagram/latest-posts
2 credits / call