Instagram Trending Reels API

Returns the reels Instagram's Reels tab shows a logged-out visitor right now, with a fresh batch on each first page. Each has its link, caption, hashtags, mentions, publish time, author, like and comment counts, length, size, cover and video file.

GET /v1/instagram/trending_posts

Read the API reference

1 credit per page, $0.75–$1.97 per 1,000 pages
22 typed fields null when unknown
40 recommended reels per page, Instagram's reels feed order (a fresh selection on each first page)
100 credits free when you sign up, no card, so you can build before you spend

Send one request. Get up to 40 recommended reels back.

Copy the request in your language, or hand it to your agent. Sign up for an API key and your first 100 credits are free.

$ npm install socialtap

Open in playground

GET /v1/instagram/trending_postsTry in

const params = new URLSearchParams({
});
const res = await fetch(`https://socialtap.dev/v1/instagram/trending_posts?${params}`, {
  headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" },
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
const { data, page, meta } = body;
console.log(data, meta.credits_charged);

import os

import requests

res = requests.get(
    "https://socialtap.dev/v1/instagram/trending_posts",
    params={},
    headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]},
)
body = res.json()
if not res.ok:
    raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
data, page, meta = body["data"], body["page"], body["meta"]
print(data, meta["credits_charged"])

require "json"
require "net/http"

uri = URI("https://socialtap.dev/v1/instagram/trending_posts")
uri.query = URI.encode_www_form()
req = Net::HTTP::Get.new(uri)
req["x-api-key"] = ENV.fetch("SOCIALTAP_API_KEY")
res = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https") { |http| http.request(req) }
body = JSON.parse(res.body)
raise "#{body["error"]["code"]}: #{body["error"]["message"]}" unless res.is_a?(Net::HTTPSuccess)
pp body["data"]
puts body["meta"]["credits_charged"]

<?php

$query = http_build_query([
]);
$ch = curl_init('https://socialtap.dev/v1/instagram/trending_posts?' . $query);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-api-key: ' . getenv('SOCIALTAP_API_KEY')],
]);
$body = json_decode(curl_exec($ch), true);
if (curl_getinfo($ch, CURLINFO_RESPONSE_CODE) >= 400) {
    throw new RuntimeException($body['error']['code'] . ': ' . $body['error']['message']);
}
print_r($body['data']);
echo $body['meta']['credits_charged'], PHP_EOL;

package main

import (
	"encoding/json"
	"fmt"
	"log"
	"net/http"
	"net/url"
	"os"
)

func main() {
	q := url.Values{}
	req, err := http.NewRequest("GET", "https://socialtap.dev/v1/instagram/trending_posts?"+q.Encode(), nil)
	if err != nil {
		log.Fatal(err)
	}
	req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY"))
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		log.Fatal(err)
	}
	defer res.Body.Close()
	var body struct {
		Data  json.RawMessage `json:"data"`
		Page  json.RawMessage `json:"page"`
		Meta  map[string]any  `json:"meta"`
		Error *struct {
			Code    string `json:"code"`
			Message string `json:"message"`
		} `json:"error"`
	}
	if err := json.NewDecoder(res.Body).Decode(&body); err != nil {
		log.Fatal(err)
	}
	if body.Error != nil {
		log.Fatalf("%s: %s", body.Error.Code, body.Error.Message)
	}
	fmt.Println(string(body.Data), body.Meta["credits_charged"])
}

curl 'https://socialtap.dev/v1/instagram/trending_posts' \
  -H "x-api-key: $SOCIALTAP_API_KEY"

{
  "data": [
    {
      "approximate_fields": [],
      "author": {
        "avatar_url": "https://scontent-atl3-2.cdninstagram.com/v/t51.82787-19/553367442_18526794646057326_7898955892857492825_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=24&_nc_ht=scontent-atl3-2.cdninstagram.com&_nc_gid=S…",
        "display_name": null,
        "id": "229753325",
        "is_verified": null,
        "url": "https://www.instagram.com/timjdillon/",
        "username": "timjdillon"
      },
      "coauthors": [],
      "duration_ms": 47067,
      "hashtags": [],
      "id": "DfKXhH2xZGc",
      "is_nsfw": null,
      "is_pinned": null,
      "is_sponsored": null,
      "language": null,
      "media": [
        {
          "alt_text": null,
          "duration_ms": 47067,
          "expires_at": "2026-10-25T18:00:00Z",
          "height": 1920,
          "thumbnail_url": "https://scontent-atl3-1.cdninstagram.com/v/t51.82787-15/876556304_1066808916349952_6134937113782217150_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=108&ig_cache_key=NDAyMDEyOTA0ODYyOTE4Njk3MjEwNjY4MDg5MTMwMTY2MTk%3D.3-ccb7-5&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc…",
          "type": "video",
          "url": "https://scontent-atl3-1.cdninstagram.com/o1/v/t2/f2/m86/AQNq6Fa5uFHJFrqjX5H5azRqMlPEXic7cv3A6bb-eeq-vyYlmoO9e4cb_u3eagtvGMHyL7Dy-2VRQVKCFItb1KqPQHvGcZkBb8LL1_0.mp4?_nc_cat=108&_nc_sid=SCRUBBED&_nc_ht=scontent-atl3-1.cdninstagram.com&_nc_ohc=SCRUBBED&efg=SCRUBBED&ccb=SCRUBBED&vs=S…",
          "width": 1080
        }
      ],
      "mentions": [],
      "metrics": {
        "comment_count": 1636,
        "like_count": 66668,
        "quote_count": null,
        "repost_count": null,
        "save_count": null,
        "share_count": null,
        "view_count": null
      },
      "platform": "instagram",
      "platform_specific": {
        "instagram": {
          "is_ai_generated": null,
          "link": null,
          "location": null
        }
      },
      "platform_type": "reel",
      "published_at": "2026-10-31T14:27:15Z",
      "text": "New episode out today at 12 noon. 🎃🎃🎃",
      "thumbnail_url": "https://scontent-atl3-1.cdninstagram.com/v/t51.82787-15/876556304_1066808916349952_6134937113782217150_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=108&ig_cache_key=NDAyMDEyOTA0ODYyOTE4Njk3MjEwNjY4MDg5MTMwMTY2MTk%3D.3-ccb7-5&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc…",
      "title": null,
      "type": "video",
      "unknown_fields": [
        "coauthors",
        "mentions"
      ],
      "url": "https://www.instagram.com/reel/DfKXhH2xZGc/"
    },
    {
      "approximate_fields": [],
      "author": {
        "avatar_url": "https://scontent-atl3-2.cdninstagram.com/v/t51.2885-19/66401604_490669885085166_8971698300612771840_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=24&_nc_ht=scontent-atl3-2.cdninstagram.com&_nc_ss=7b689&…",
        "display_name": null,
        "id": "1311602026",
        "is_verified": null,
        "url": "https://www.instagram.com/suburban_prince/",
        "username": "suburban_prince"
      },
      "coauthors": [],
      "duration_ms": 57120,
      "hashtags": [],
      "id": "DfIizPaSPCb",
      "is_nsfw": null,
      "is_pinned": null,
      "is_sponsored": null,
      "language": null,
      "media": [
        {
          "alt_text": null,
          "duration_ms": 57120,
          "expires_at": "2026-10-25T18:00:00Z",
          "height": 2560,
          "thumbnail_url": "https://scontent-atl3-1.cdninstagram.com/v/t51.71878-15/874466886_1676249104058201_2716064828296650486_n.jpg?stp=dst-jpegr_e15_tt6&_nc_cat=108&ig_cache_key=NDAxOTYxNTcyMjI0OTk3MzkxNTExMjQxODIxMTA1NDEzODg%3D.3-ccb7-5&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_…",
          "type": "video",
          "url": "https://scontent-atl3-1.cdninstagram.com/o1/v/t16/f2/m84/AQPvrSZPtYAtPtTTBXfoYIr3MNu9zQAiDLqH3pwswoAA-GveiM_uz947YYWZrT4LivNq9tVcrpP-LH1Qbiewb64ftwV-KXBqd7lUYDo.mp4?_nc_cat=108&_nc_sid=SCRUBBED&_nc_ht=scontent-atl3-1.cdninstagram.com&_nc_ohc=SCRUBBED&efg=SCRUBBED&ccb=SCRUBBED&vs=…",
          "width": 1440
        }
      ],
      "mentions": [
        "700creditedwin"
      ],
      "metrics": {
        "comment_count": 2547,
        "like_count": 177783,
        "quote_count": null,
        "repost_count": null,
        "save_count": null,
        "share_count": null,
        "view_count": null
      },
      "platform": "instagram",
      "platform_specific": {
        "instagram": {
          "is_ai_generated": null,
          "link": null,
          "location": null
        }
      },
      "platform_type": "reel",
      "published_at": "2026-10-30T21:27:06Z",
      "text": "@700creditedwin",
      "thumbnail_url": "https://scontent-atl3-1.cdninstagram.com/v/t51.71878-15/874466886_1676249104058201_2716064828296650486_n.jpg?stp=dst-jpegr_e15_tt6&_nc_cat=108&ig_cache_key=NDAxOTYxNTcyMjI0OTk3MzkxNTExMjQxODIxMTA1NDEzODg%3D.3-ccb7-5&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_…",
      "title": null,
      "type": "video",
      "unknown_fields": [
        "coauthors"
      ],
      "url": "https://www.instagram.com/reel/DfIizPaSPCb/"
    },
    {
      "approximate_fields": [],
      "author": {
        "avatar_url": "https://scontent-atl3-2.cdninstagram.com/v/t51.82787-19/579682655_18537208666023480_440396525652691733_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=105&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=24&_nc_ht=scontent-atl3-2.cdninstagram.com&_nc_gid=…",
        "display_name": null,
        "id": "41495479",
        "is_verified": null,
        "url": "https://www.instagram.com/nakkiagold/",
        "username": "nakkiagold"
      },
      "coauthors": [],
      "duration_ms": 122136,
      "hashtags": [],
      "id": "DfBMmcnpSIO",
      "is_nsfw": null,
      "is_pinned": null,
      "is_sponsored": null,
      "language": null,
      "media": [
        {
          "alt_text": null,
          "duration_ms": 122136,
          "expires_at": "2026-10-25T18:00:00Z",
          "height": 854,
          "thumbnail_url": "https://scontent-atl3-1.cdninstagram.com/v/t51.82787-15/870167702_18639152566023480_8900343708547536273_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=109&ig_cache_key=NDAxNzU0Nzc2MTIxOTM0Njk1ODE4NjM5MTUyNTYzMDIzNDgw.3-ccb7-5&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=…",
          "type": "video",
          "url": "https://scontent-atl3-2.cdninstagram.com/o1/v/t2/f2/m86/AQPlfIWHtV0agduy_sxdh4bqKUit09uG4iMz8E96rAB-_fGN9LDwnUYqgJFCGMRfI2Nij1BAwKar1wRuEDuziuRW_mHVARS4Ls_kghs.mp4?_nc_cat=104&_nc_sid=SCRUBBED&_nc_ht=scontent-atl3-2.cdninstagram.com&_nc_ohc=SCRUBBED&efg=SCRUBBED&ccb=SCRUBBED&vs=S…",
          "width": 480
        }
      ],
      "mentions": [],
      "metrics": {
        "comment_count": 22609,
        "like_count": 174412,
        "quote_count": null,
        "repost_count": null,
        "save_count": null,
        "share_count": null,
        "view_count": null
      },
      "platform": "instagram",
      "platform_specific": {
        "instagram": {
          "is_ai_generated": null,
          "link": null,
          "location": null
        }
      },
      "platform_type": "reel",
      "published_at": "2026-10-28T01:04:16Z",
      "text": "When all the Wives show up to the funeral 👀 I guess the MAIN one the only one who got up to speak! 📍",
      "thumbnail_url": "https://scontent-atl3-1.cdninstagram.com/v/t51.82787-15/870167702_18639152566023480_8900343708547536273_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=109&ig_cache_key=NDAxNzU0Nzc2MTIxOTM0Njk1ODE4NjM5MTUyNTYzMDIzNDgw.3-ccb7-5&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=…",
      "title": null,
      "type": "video",
      "unknown_fields": [
        "coauthors",
        "mentions"
      ],
      "url": "https://www.instagram.com/reel/DfBMmcnpSIO/"
    }
  ],
  "page": {
    "has_more": true,
    "next_cursor": "c1.EXAMPLE_CURSOR",
    "next_cursor_expires_at": "2026-10-26T12:00:00Z",
    "end_reason": null
  },
  "meta": {
    "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f",
    "platform": "instagram",
    "source": "api",
    "is_cached": false,
    "credits_charged": 1,
    "latency_ms": 996,
    "fetched_at": "2026-10-25T12:00:00Z",
    "input": null,
    "credits_remaining": 9999,
    "client_request_id": null,
    "warnings": []
  }
}

import { SocialTap } from "socialtap";

const client = new SocialTap(); // apiKey defaults to process.env.SOCIALTAP_API_KEY

const res = await client.instagram.trendingPosts.list({});
console.log(res.data);
console.log(res.credits.charged, res.meta.request_id);

import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;

public class Main {
    public static void main(String[] args) throws Exception {
        String query = "";
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://socialtap.dev/v1/instagram/trending_posts?" + query))
            .header("x-api-key", System.getenv("SOCIALTAP_API_KEY"))
            .GET()
            .build();
        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        // An error is {"error": {"code", "message", ...}}; success is {data, meta}, meta.credits_charged its price.
        if (response.statusCode() >= 400) throw new RuntimeException(response.body());
        System.out.println(response.body());
    }

    static String encode(String value) {
        return URLEncoder.encode(value, StandardCharsets.UTF_8);
    }
}

using System.Text.Json;

using var http = new HttpClient();
http.DefaultRequestHeaders.Add("x-api-key", Environment.GetEnvironmentVariable("SOCIALTAP_API_KEY"));

var query = string.Join("&",);
var res = await http.GetAsync("https://socialtap.dev/v1/instagram/trending_posts?" + query);
using var body = JsonDocument.Parse(await res.Content.ReadAsStringAsync());
if (!res.IsSuccessStatusCode)
{
    var error = body.RootElement.GetProperty("error");
    throw new Exception($"{error.GetProperty("code")}: {error.GetProperty("message")}");
}
Console.WriteLine(body.RootElement.GetProperty("data"));
Console.WriteLine(body.RootElement.GetProperty("meta").GetProperty("credits_charged"));

// Cargo.toml: reqwest = { version = "0.12", features = ["blocking", "json"] }, serde_json = "1"
use std::env;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let res = reqwest::blocking::Client::new()
        .get("https://socialtap.dev/v1/instagram/trending_posts")
        .query(&[])
        .header("x-api-key", env::var("SOCIALTAP_API_KEY")?)
        .send()?;
    let ok = res.status().is_success();
    let body: serde_json::Value = res.json()?;
    if !ok {
        return Err(format!("{}: {}", body["error"]["code"], body["error"]["message"]).into());
    }
    println!("{} {}", body["data"], body["meta"]["credits_charged"]);
    Ok(())
}

200 OK · GET https://socialtap.dev/v1/instagram/trending_postsLong arrays and strings are shortened here. Real responses are complete.Docs

One schema on 21 platforms.

The response reference lists every field, its type and when it is null. See the full schema.

Null means unknown
A field Instagram doesn't show is null, never zero or an empty string, so a real zero always means zero.
No input needed
Every parameter is optional: the plain request returns the default list.
Write one parser
Instagram, TikTok, Facebook and 18 more platforms answer in these fields, so the code that reads one reads them all.

platformstring: Platform ID (tiktok, youtube, …).
idstring: Platform-native post ID (string; Instagram shortcode, Reddit with its t3_ prefix).
urlstring: Canonical post URL.
typestring: Normalized content shape. New values may be added; treat unknown values as other.
platform_typestring: The platform's own product label, lowercase (reel, short, story, live, tweet, …).
titlestring: Headline (YouTube title, Reddit title); null on caption-only platforms.
textstring: Caption, description or body as plain text.
languagestring: BCP-47 language of text, when the platform states it.

What teams build with the Instagram Trending Reels API.

Spot reels spreading on Instagram now
Find rising creators and formats
Feed a trend dashboard
Sample what Instagram shows new visitors

Good to know before you build.

It's a recommendation feed, not a chart, so reels differ per request and come in no time order. since and until only filter.
Instagram stops a logged-out scroll after a few dozen reels, so the walk ends at platform_limit. Start again for a fresh batch.
Page with the default limit, because a smaller one skips the rest of each batch.
Play counts and the author's display name and verified badge are null: this feed doesn't show them. The Instagram Post API has them for one reel.
Media URLs are Instagram CDN links that expire at media[].expires_at.

1 credit per page. Failed requests are free.

Buy credits once and spend them on any endpoint, on any platform.

Plans and packs How this endpoint is priced How credits work

Source	Price per successful page	Per 1,000 pages
Platform API `api`	1 credit	$0.75–$1.97
Public page `page`	1 credit	$0.75–$1.97

Cache hits are free.
Credits from packs and top-ups never expire.
A monthly plan's credits are spent first, and what is left of them ends at each renewal.
Prices exclude tax: sales tax is added at checkout where it applies.
Outside the US, plans and packs are sold to businesses: checkout asks for your VAT, GST or other business tax ID.

Questions about the Instagram Trending Reels API.

See what's on the list right now.

Run it in the playground, or copy the request into your code.

free credits

No credit card
Failed requests are free
Works on all 218 endpoints

Start for free Read the docs

Instagram Trending Reels API. Trending reels, on request.