Instagram Account Reels

Overview

List the reels of an Instagram account, newest first, one page per call, together with the account's engagement statistics. Identify the account by username (handle, @handle or profile URL) or by user_id (numeric Instagram account id). Every reel carries its id, shortcode, canonical URL, type (reel), publication time, author handle, caption (cut at 300 characters) and its like and comment counters. view_count holds the plays of the reel, the highest of the play and view counters Instagram delivers; it is null when the account hides its counters. Reach and impressions are not public on Instagram.

The stats block is computed over the reels of the returned page: average likes, average comments (each only over the reels with a visible counter) and the engagement rate (average likes + average comments) / followers × 100, rounded to four decimals. The follower count comes from the account's profile, which is cached for up to 30 days. The rate is null when the follower count is unknown.

Fetched pages are cached for 24 hours and shared across the platform. A second request for the same page within that window answers instantly and is charged the lower cached price.

When to use

Measure every new video of a chosen account: read the first page regularly and compare plays, likes and comments.
Benchmark the reel performance of candidate accounts for a lead list before resolving full profiles with instagram_profile.
Follow an account's reel output over time by paging back through next_cursor.

[!NOTE] An account without reels completes successfully with count: 0 and is not charged. A private account answers restricted: true, an unknown handle found: false, both free. Genuine errors of the data service (auth, rate limit, 5xx) still fail the run and are refunded.

Endpoint

Input

Output

Paging

Each call returns one page. To get the next page, pass the value of next_cursor back as cursor. A null cursor means the list is fully read. Pages are priced individually, so page only as deep as you need.

Pricing

This enrichment costs 2 credits for a freshly fetched page. A page served from the cache (at most 24 hours old) is charged the lower cached tier. Pages without reels, private accounts and unknown accounts are free.

Examples

Playground

States

State	Description
`queued`	Request accepted; waiting to be picked up by a worker.
`processing`	Worker is actively running the enrichment.
`completed`	Enrichment finished and results are available in `output`.
`failed`	Enrichment failed; reason is in `error`. Credits are refunded for failures unless otherwise noted.

Errors

Error	When it happens	What to do
`invalid_input`	Neither `username` nor `user_id` is given, `username` is not a valid handle or profile URL, or `cursor` is malformed.	Pass a handle like `natgeo` or a numeric account id.
`rate_limited`	The data service throttled the request.	Retry with backoff.
`provider_error`	The data service returned an unexpected error.	Retry; if persistent, contact support.
`503 endpoint_unavailable`	The endpoint is currently not configured or temporarily disabled. Nothing is reserved or charged.	Retry later; if persistent, contact support.