ToolzerHub Docs

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.

1 credit / requestBilled only on success
GET
/v1/instagram/user/reels

Authorization

ApiKeyAuth
x-api-key<token>

In: header

Query Parameters

user_id?string

Numeric Instagram user ID, from the id field of Get User ID or Get User Info. Required unless username_or_url is set.

Length1 <= length
username_or_url?string

Instagram username (without @) or profile URL. Required unless user_id is set; with only user_id, the username is looked up first.

Length1 <= length
detail?string

full (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.

Default"full"

Value in

  • "summary"
  • "full"
cursor?string

Pass the previous response's paging_info.max_id value to get the next page. Omit for the first page.

count?integer

Reels per page, 1-50. Instagram serves 12 per page, so values above 12 still return 12.

Range1 <= value <= 50
Default12
curl -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"  }}