List Instagram user reels

Try in Playground

List the latest public Instagram reels of an account (pinned reels first, then the newest 12) with play, like and comment counts, upload times and thumbnails. include_details adds each reel's publication time and caption; since and until keep a time window; trim selects compact records.

GET/v1/instagram/user/reelsx-api-key

Headers

Get your API key

x-api-keystringrequiredheader

Your ScrapeAtlas customer key. Create one on /account/ and set SCRAPEATLAS_API_KEY.

Query parameters

user_idstringquery

Optional.

handlestringquery

Optional.

max 31 chars

Exampleexample

max_idstringquery

Cursor pages are served only to logged-in visitors: a request with max_id answers 403 restricted_page.

trimenumquery

true returns the reference's flattened trimmed layout: items[] with id, code, taken_at, created_at, uploaded_at, caption (the last four as available), play_count, comment_count, like_count, display_uri, user and url, and a top-level max_id (null) instead of paging_info.

one of: true, false

include_detailsenumquery

true also reads the profile grid around the page's reels (up to two documents) and adds taken_at, created_at and caption to each reel it lists; reels the grid does not list keep uploaded_at only and the response is partial with reel_details_partial.

one of: true, false

sincenumber | stringquery

Earliest upload time to include, ISO 8601 or Unix seconds; pinned reels are kept when inside the window.

untilnumber | stringquery

Upload time to stop before, ISO 8601 or Unix seconds; later than since.

Response fields

requestIdstring

Request correlation identifier.

HTTP attempts for the operation (profile: one document, plus the page load the first time a handle is seen; basic-profile: one document; post-count: page; posts: page plus document the first time a handle is seen, otherwise the profile document, the session probe and the posts document; reels: the reels page, plus the profile document when identified by user id; with include_details up to two grid documents, one by user id; post: document plus page, or the document alone with include_comments=false on non-carousel media; comments: page; highlights: page, plus a document when identified by user id; popular search: page; all including the shared transient retry), decoded bytes and duration.

accounting.upstreamRequestsinteger

Always included.

≥ 0

accounting.responseBytesinteger

Always included.

≥ 0

accounting.durationMsnumber

Always included.

≥ 0

successboolean

True when usable data is returned; inspect status and coverage for omissions.

statusenum

success, partial, failed, or challenged. HTTP 200 can be partial.

one of: success, partial

sourceUrlstring

Canonical instagram.com URL of the profile, post or reel.

absolute HTTPS URL

fetchedAtstring

UTC retrieval time.

order is newest_first, after pinned reels; window echoes since and until. Warnings name every omission or cap (first_page_only when the account has more reels than the first page, private_account, items_truncated, reel_details_partial).

coverage.sourcestring

Always included.

coverage.completeboolean

Always included.

coverage.warningsstring[]

Always included.

coverage.orderenum

Always included.

one of: newest_first, oldest_first, ranked, relevance, source_order

Optional.

coverage.window.sincestringoptional

Optional.

coverage.window.untilstringoptional

Optional.

Always included.

up to 50 items

Always included.

items.media.pkstring

Always included.

items.media.idstring

Always included.

min 1 chars

items.media.codestring

Always included.

min 1 chars

items.media.media_typeinteger

Always included.

items.media.urlstring

Always included.

absolute HTTPS URL

Always included.

paging_info.max_idstringnullable

Always included.

paging_info.more_availableboolean

Always included.

HTTP 200 returns the success variant. Check status: partial means usable data with warnings, and failed or challenged requests carry a failure object described in Errors & responses.

Error codes

HTTP	failure.code	Meaning
400	`invalid_request`	Missing, duplicate, malformed or unsupported parameters, handles, ids, cursors or URLs.
401	`unauthorized`	Invalid API key.
404	`not_found`	Unknown handle, user id, post, or a keyword without a popular page.
403	`restricted_page`	The page or document is private or gated (private account, gated media, login redirect).
422	`count_estimated_only`	Instagram abbreviates this post count and allow_estimated was not set.
429	`upstream_rate_limited`	Instagram rate limited the page load or the GraphQL read.
502	`upstream_challenged`	Instagram refused the request with its error shell (status challenged).
502	`operation_unavailable`	Instagram no longer serves the pinned document for this operation.
502	`unsafe_redirect`	Instagram redirected the request somewhere other than the login form.
502	`unsupported_page`	The page or GraphQL result is missing, mismatched or structurally unsupported.
502	`response_too_large`	The decoded responses exceeded the operation's byte budget (1–5 MiB).
502	`payload_too_complex`	The response exceeded the JSON depth or node limits.
502	`request_limit`	The upstream request budget was exhausted.
502	`upstream_error`	Network failure or HTTP 5xx after the single retry.
503	`busy`	All retrieval slots are busy.
504	`timeout`	The 45-second deadline elapsed.

Code example

curl "https://api.scrapeatlas.com/v1/instagram/user/reels?handle=example" \
  -H "x-api-key: YOUR_API_KEY"

const response = await fetch(
  "https://api.scrapeatlas.com/v1/instagram/user/reels?handle=example",
  {
    headers: {
      "x-api-key": "YOUR_API_KEY"
    }
  }
);

const data = await response.json();
console.log(data.status, data);

type Result = {
  status: "success" | "partial" | "failed" | "challenged";
  requestId: string;
  [field: string]: unknown;
};

const response = await fetch(
  "https://api.scrapeatlas.com/v1/instagram/user/reels?handle=example",
  {
    headers: {
      "x-api-key": process.env.SCRAPEATLAS_API_KEY!
    }
  }
);

const data = (await response.json()) as Result;
if (data.status === "failed" || data.status === "challenged") {
  throw new Error(`Instagram request failed: ${data.requestId}`);
}
console.log(data);

import requests

response = requests.get(
    "https://api.scrapeatlas.com/v1/instagram/user/reels",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "handle": "example"
    },
    timeout=60,
)
data = response.json()
print(data["status"], data)

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.scrapeatlas.com/v1/instagram/user/reels?handle=example", nil)
	req.Header.Set("x-api-key", "YOUR_API_KEY")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	var data map[string]interface{}
	json.NewDecoder(resp.Body).Decode(&data)
	fmt.Println(data["status"], data)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        var client = HttpClient.newHttpClient();
        var request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.scrapeatlas.com/v1/instagram/user/reels?handle=example"))
            .GET()
            .header("x-api-key", "YOUR_API_KEY")
            .build();
        var response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

Use your sa_live_… customer key at https://api.scrapeatlas.com.

Responses

Successful result. Synthetic example validated against the runtime contract.

{
  "success": true,
  "items": [
    {
      "media": {
        "pk": "3000000000000000002",
        "id": "3000000000000000002_1234567890",
        "code": "ExAmPlE0002",
        "media_type": 2,
        "product_type": "clips",
        "play_count": 45000,
        "like_count": 2100,
        "comment_count": 40,
        "like_and_view_counts_disabled": false,
        "clips_tab_pinned_user_ids": [],
        "display_uri": "https://scontent.cdninstagram.com/v/t51.2885-15/example_reel.jpg",
        "user": {
          "pk": "1234567890",
          "id": "1234567890"
        },
        "uploaded_at": "2026-09-12T09:12:00.000Z",
        "url": "https://www.instagram.com/reel/ExAmPlE0002/"
      }
    }
  ],
  "paging_info": {
    "max_id": null,
    "more_available": false
  },
  "status": "partial",
  "requestId": "0b7f1e5c-3c2a-4a4e-9c9b-1f3d2c0a8e21",
  "sourceUrl": "https://www.instagram.com/example/reels/",
  "fetchedAt": "2026-09-12T10:00:00.000Z",
  "coverage": {
    "source": "public_web",
    "order": "newest_first",
    "complete": false,
    "warnings": [
      "first_page_only"
    ]
  },
  "accounting": {
    "upstreamRequests": 1,
    "responseBytes": 705905,
    "durationMs": 1100
  }
}

Missing, duplicate, malformed or unsupported parameters, handles, ids, cursors or URLs.

{
  "requestId": "9d2f1c0a-6b1e-4c7d-9a8e-2f3b4c5d6e7f",
  "accounting": {
    "upstreamRequests": 0,
    "responseBytes": 0,
    "durationMs": 0
  },
  "success": true,
  "status": "success",
  "sourceUrl": "https://example.com/",
  "fetchedAt": "2026-01-01T00:00:00.000Z",
  "coverage": {
    "source": "public_web",
    "complete": true,
    "warnings": [
      "string"
    ],
    "order": "newest_first",
    "window": {
      "since": "2026-01-01T00:00:00.000Z",
      "until": "2026-01-01T00:00:00.000Z"
    }
  },
  "items": [
    {
      "id": "string",
      "code": "string",
      "media_type": 0,
      "taken_at": 0,
      "created_at": "2026-01-01T00:00:00.000Z",
      "uploaded_at": "2026-01-01T00:00:00.000Z",
      "caption": {},
      "play_count": 0,
      "comment_count": 0,
      "like_count": 0,
      "display_uri": "string",
      "user": {},
      "image_versions2": {},
      "carousel_media": [
        {}
      ],
      "product_type": "string",
      "is_paid_partnership": true,
      "video_versions": [
        {}
      ],
      "has_audio": true,
      "pinned": true,
      "url": "https://example.com/"
    }
  ],
  "max_id": "string"
}