Skip to content
truescrape
Free key

Contents

Site

Instagram Trending Reels API

Open in ChatGPTOpen in ClaudeOpen in Gemini

Reels off Instagram's public Explore grid. Worth knowing what this is and is not: Explore is region-shaped, so what comes back depends on where the request exits, and it is Instagram's editorial surface rather than a global chart. There is no public trending feed on Instagram; this is the closest one that exists. Set extra_fetch=true to fill each reel's publish date, caption and duration from its own page: 1 credit per item fetched, up to the page size. Calls cost 1 credit each. A cache hit is free, and a failed or empty response is never charged.

Try it

Prefilled with the request that produced the example below. No key yet? Get a free key.

Request

GET/v1/instagram/trending-reels
ParameterTypeRequiredDescription
cursorstringnopagination.cursor from a previous response
countnumbernoReels per page, 1-50. Default 24.
extra_fetchbooleannoWhen true, fetches each item's own page to fill fields the list page leaves null. Costs 1 extra credit per page fetched, up to the page size.

Also accepts cache_max_age (a hit costs 0 credits) and include_raw (returns the untouched upstream payload under raw).

curl
curl "$API/v1/instagram/trending-reels?cache_max_age=7d" \
  -H "x-api-key: $KEY"
JavaScript
const query = new URLSearchParams({
  cache_max_age: '7d',
});

const response = await fetch(`${API}/v1/instagram/trending-reels?${query}`, {
  headers: { 'x-api-key': KEY },
});

const body = await response.json();
if (!body.success) throw new Error(body.error.code);

// 1 credit, 0 on a cache hit
console.log(body.data, body.meta.creditsCharged);
Python
import os, httpx

r = httpx.get(
    f"{os.environ['API']}/v1/instagram/trending-reels",
    params={
        "cache_max_age": "7d",
    },
    headers={"x-api-key": os.environ["KEY"]},
    timeout=30,
)

body = r.json()
if not body["success"]:
    raise RuntimeError(body["error"]["code"])

print(body["data"], body["meta"]["creditsCharged"])

Example response

Captured on , with raw removed and lists cut to two items. A live call returns current data.

response
{
  "success": true,
  "data": {
    "items": [
      {
        "platform": "instagram",
        "id": "DcOX_4-Bujl",
        "type": "reel",
        "url": "https://www.instagram.com/reel/DcOX_4-Bujl/",
        "title": null,
        "text": null,
        "authorId": null,
        "authorHandle": null,
        "authorName": null,
        "thumbnailUrl": null,
        "mediaUrls": [
          "https://example.com/media/1.jpg"
        ],
        "durationSeconds": null,
        "viewCount": null,
        "likeCount": null,
        "commentCount": null,
        "shareCount": null,
        "hashtags": [],
        "mentions": [],
        "isSponsored": null,
        "publishedAt": null,
        "fetchedAt": "2026-10-21T01:52:55.805Z"
      },
      {
        "platform": "instagram",
        "id": "DanlihsTQbU",
        "type": "reel",
        "url": "https://www.instagram.com/reel/DanlihsTQbU/",
        "title": null,
        "text": null,
        "authorId": null,
        "authorHandle": null,
        "authorName": null,
        "thumbnailUrl": null,
        "mediaUrls": [
          "https://example.com/media/1.jpg"
        ],
        "durationSeconds": null,
        "viewCount": null,
        "likeCount": null,
        "commentCount": null,
        "shareCount": null,
        "hashtags": [],
        "mentions": [],
        "isSponsored": null,
        "publishedAt": null,
        "fetchedAt": "2026-10-21T01:52:55.805Z"
      }
    ]
  },
  "pagination": {
    "cursor": null,
    "hasMore": true,
    "count": 24
  },
  "meta": {
    "platform": "instagram",
    "endpoint": "instagram.trendingReels",
    "creditsCharged": 1,
    "cached": false,
    "cacheAgeSeconds": null,
    "durationMs": 12146,
    "requestId": "req_k6e62c9zspxjv287btil"
  }
}

Returns

Returns a list of Post in data.items.

Cost and behaviour

Credits1 per live request, 0 on a cache hit
Cacheableyes: cache_max_age accepts a cached copy
Batchableno
Subscribableno

Other Instagram endpoints

All Instagram endpointsThe unified schema