List Instagram user reels (v1)
Lists reels from a public Instagram account by username_or_url or user_id, 12 per page. Each reel includes play_count, the plays shown on the Reels tab. detail=summary returns lighter entries. Pass paging_info.max_id as cursor for the next page.
Authorization
ApiKeyAuth In: header
Query Parameters
Numeric Instagram user ID, from the id field of Get User ID or Get User Info. Required unless username_or_url is set.
1 <= lengthInstagram username (without @) or profile URL. Required unless user_id is set; with only user_id, the username is looked up first.
1 <= lengthfull (default) returns each reel as a full media object, using an extra upstream request. summary returns the thinner Reels-tab entries in one request. Both include play_count.
"full"Value in
- "summary"
- "full"
Pass the previous response's paging_info.max_id value to get the next page. Omit for the first page.
Reels per page, 1-50. Instagram serves 12 per page, so values above 12 still return 12.
1 <= value <= 5012curl -X GET "https://example.com/v1/instagram/user/reels" \ -H "x-api-key: YOUR_API_KEY"{ "data": { "items": [ { "media": { "pk": "string", "play_count": 0, "property1": null, "property2": null }, "property1": null, "property2": null } ], "paging_info": { "max_id": "string", "more_available": true, "property1": null, "property2": null }, "is_partial": true, "partial_reason": "enrichment_unavailable", "property1": null, "property2": null }, "details": { "reason": "no_results", "message": "string" }}