Instagram API endpoint
Retrieve Instagram Reels for a user
Returns a feed of Instagram Reels for the specified user ID. Supports pagination via `max_id`.
GETapiKey8 credits/requestinstagram.reelsResponseDoc
/instagram/reels/{id}Parameters
| Name | In | Type | Required | Enum | Example | Description |
|---|---|---|---|---|---|---|
| id | path | string | Yes | Instagram user ID | ||
| max_id | query | string | No | Pagination cursor for fetching the next page of Reels | ||
| x-api-key | header | string | Yes | API key required |
Authentication
Send your scraping API key in the x-api-key header. Use the console API Keys page to rotate or select the active key.
Billing
Endpoint usage is metered in credits. The plan prices, included credits, limits, and overage rates below match the active backend billing configuration.
- Credit cost
- 8 credits/request
- Charged response
- Successful 2xx responses
| Plan | Price | Included credits | Daily cap | Rate limit | Overage |
|---|---|---|---|---|---|
| Free | $0/mo | 2,000 | 500 daily credits | 5/min | No overage |
| Starter | $9/mo | 20,000 | 5,000 daily credits | 15/min | $0.75/1,000 overage credits when enabled |
| Growth | $29/mo | 100,000 | 25,000 daily credits | 45/min | $0.45/1,000 overage credits when enabled |
| Pro | $79/mo | 400,000 | No daily cap | 120/min | $0.30/1,000 overage credits |
| Business | $199/mo | 1,200,000 | No daily cap | 300/min | $0.20/1,000 overage credits |
| Enterprise | $499/mo | 5,000,000 | No daily cap | 1,000/min | $0.12/1,000 overage credits |
Catalog quality warnings
- missing example for required path param: id
Failure responses
| Status | Description | Schema |
|---|---|---|
| 400 | Missing or invalid parameters | #/definitions/app.Response |
| 404 | No Reels found | #/definitions/app.Response |
| 429 | Rate limit exceeded | #/definitions/app.Response |
| 500 | Internal server error | #/definitions/app.Response |
Example response
{
"code": 200,
"msg": "OK",
"data": {
"items": [
{
"media": {
"id": "3679713463091712273_1067259270",
"code": "DMQ9-YSzdER",
"media_type": 2,
"caption": {
"text": "Find out which WNBA fan you are based on your searches 🏀🔎 Hit the link in bio for the full quiz.",
"user": {
"id": "1067259270",
"username": "google",
"full_name": "Google"
}
},
"image_versions2": {
"candidates": [
{
"url": "https://scontent-mia5-1.cdninstagram.com/v/t51.71878-15/520326096_601943249304059_3355842298425776816_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=1...",
"width": 640,
"height": 1136
}
]
},
"play_count": 5734199
}
}
],
"paging_info": {
"max_id": "QVFCNFFnOGo1Q1J4T2lhMi1HSzRZQ1hqZDgyUjdyNUZTbnFxajZYXzhpUFFkOERZRjlIZHMtMVBTemYyX2tzWHhOa1VWRWRpaTBGM2prMDlqTnp5VlE2ag==",
"more_available": true
}
}
}Request schema
No body schema
Response schema
#/definitions/instagram.reelsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | instagram.ReelResponse | No | ||||
| data.items | array | No | ||||
| data.items[].media | instagram.Media | No | ||||
| data.items[].media.caption | unknown | No | pointer so it can be nil | |||
| data.items[].media.code | string | No | ||||
| data.items[].media.comment_count | integer | No | ||||
| data.items[].media.display_uri | string | No | ||||
| data.items[].media.id | string | No | ||||
| data.items[].media.image_versions2 | instagram.ImageVersions | No | ||||
| data.items[].media.image_versions2.candidates | array | No | ||||
| data.items[].media.image_versions2.candidates[].height | integer | No | ||||
| data.items[].media.image_versions2.candidates[].url | string | No | ||||
| data.items[].media.image_versions2.candidates[].width | integer | No | ||||
| data.items[].media.like_count | integer | No | ||||
| data.items[].media.media_type | integer | No | 1=Image 2=Video 8=Album | |||
| data.items[].media.play_count | integer | No | ||||
| data.items[].media.taken_at | integer | No | ||||
| data.paging_info | instagram.PagingInfo | No | ||||
| data.paging_info.max_id | string | No | ||||
| data.paging_info.more_available | boolean | No | ||||
| msg | string | No | OK |
Example request
curl -X GET "https://api.crawlora.net/api/v1/instagram/reels/user-1" -H "x-api-key: <api-key>"
TypeScript fetch
const url = new URL("https://api.crawlora.net/api/v1/instagram/reels/user-1");
const headers = new Headers();
headers.set("x-api-key", "<api-key>");
const response = await fetch(url, {
method: "GET",
headers,
});
const payload = await response.json();