Spiral gives your agent every tool with one account. Browse the tools →

ScrapeCreatorsSocial MediaAvailable now

Instagram · Reels

scrapecreators/instagram-user-reels

Get public social media posts, profiles and videos with Instagram · Reels from ScrapeCreators through one Spiral API key. Returns a paginated list of a user's public Instagram reels (short-form videos). Each reel includes its shortcode, play count, like count, comment count, video versions with download URLs, thumbnail image, owner info, and the published time in items[].media.created_at as an ISO 8601 UTC date. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

Pricing

Up to $0.0013 per run.

Limits

Runs
In the background
Returns
json
Longest queue wait
1 hour
Run deadline
30 minutes
Longest run, end to end
225 minutes
Largest inline input
1 MB
Largest input file
2 GB
Largest output
5 GB

Input

FieldKindDefaultDescription
trimtrue or false—

Set to true for a trimmed down version of the response

handletext—

Instagram handle. Use user_id for faster response times.

max_idtext—

Max id to get more reels. Get 'max_id' from previous response.

user_idtext—

Instagram user id. Use this for faster response times.

require_play_countstrue or falsefalse

Only the literal query value 'true' enables this check. It requires a numeric, nonnegative play_count on every returned Reel, in both full responses (items[].media.play_count) and trim=true responses (items[].play_count); a real 0 is valid. A missing, null, nonnumeric or negative play_count returns HTTP 503 without charging credits instead of a paid partial success. It does not require ig_play_count or view counts. With the default false, counts remain best-effort: usable reels are still billable even with missing play counts. This checks presence and numeric validity; it does not guarantee count accuracy or agreement with Instagram Insights. Retrying does not guarantee that Instagram will return the missing counts. Why counts can be missing.

Same request in code

curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "scrapecreators",
    "model": "scrapecreators/instagram-user-reels",
    "input": {
      "trim": false
    }
  }'

Frequently asked questions

How much does Instagram · Reels cost?

Up to $0.0013 per run. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

How do I use Instagram · Reels through an API?

Send `POST /v1/runs` with `"provider": "scrapecreators"`, `"model": "scrapecreators/instagram-user-reels"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

Do I need an account with ScrapeCreators to use Instagram · Reels?

No. Spiral runs it on its own ScrapeCreators account and charges your Spiral balance.

Can my AI agent use Instagram · Reels?

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.