Instagram Trending Searches API. Trending searches, on request.
Promoted searches with exact post counts. We handle the proxies, blocks and platform changes.
Instagram Trending Searches API at a glance
Returns the search terms Instagram promotes on its popular page, by section, with exact post counts. Sections include Trending now, Pop culture moments, What's happening now, Get inspired, Learn something new and Shop the trends. Each term comes with its rank in the section, a picture, the reel Instagram features for it and a link to its topic page. Ask for one section, or get them all in the page's order.
GET /v1/instagram/popular_trends
- 1 credit per page, $0.75–$1.97 per 1,000 pages
- 8 typed fields null when unknown
- 100 promoted searches per page, Instagram's popular page order: section by section, each by its rank
- 100 credits free when you sign up, no card, so you can build before you spend
Send one request. Get up to 100 promoted searches 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 socialtapconst params = new URLSearchParams({
});
const res = await fetch(`https://socialtap.dev/v1/instagram/popular_trends?${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/popular_trends",
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/popular_trends")
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/popular_trends?' . $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/popular_trends?"+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/popular_trends' \
-H "x-api-key: $SOCIALTAP_API_KEY"{
"data": [
{
"approximate_fields": [],
"categories": [],
"platform": "instagram",
"platform_specific": {
"instagram": {
"featured_post_url": "https://www.instagram.com/reel/DUPeJg2EY6I/",
"metrics": {
"post_count": 15544888
},
"section": "trending_now",
"section_title": "Trending now"
}
},
"rank": 1,
"term": "grammys",
"thumbnail_url": "https://scontent-ord5-2.cdninstagram.com/v/t51.71878-15/626836578_4322300201430649_3221782703227773703_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=107&_nc_map=urlgen_bucketless&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=23&_nc_ht=scontent-ord5-2.cdni…",
"unknown_fields": [],
"url": "https://www.instagram.com/popular/grammys/"
},
{
"approximate_fields": [],
"categories": [],
"platform": "instagram",
"platform_specific": {
"instagram": {
"featured_post_url": "https://www.instagram.com/reel/DPPlnHODnbf/",
"metrics": {
"post_count": 1227004
},
"section": "trending_now",
"section_title": "Trending now"
}
},
"rank": 2,
"term": "wells fargo",
"thumbnail_url": "https://scontent-ord5-1.cdninstagram.com/v/t51.82787-15/557538560_18540780817005423_5978791909315467819_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=110&_nc_map=urlgen_bucketless&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=23&_nc_ht=scontent-ord5-1.cdn…",
"unknown_fields": [],
"url": "https://www.instagram.com/popular/wells-fargo/"
},
{
"approximate_fields": [],
"categories": [],
"platform": "instagram",
"platform_specific": {
"instagram": {
"featured_post_url": "https://www.instagram.com/reel/DWbkTt7Aa_a/",
"metrics": {
"post_count": 8606170
},
"section": "trending_now",
"section_title": "Trending now"
}
},
"rank": 3,
"term": "robertpattinson",
"thumbnail_url": "https://scontent-ord5-1.cdninstagram.com/v/t51.82787-15/656880387_18049195130718224_642231060840520275_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=108&_nc_map=urlgen_bucketless&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=23&_nc_ht=scontent-ord5-1.cdni…",
"unknown_fields": [],
"url": "https://www.instagram.com/popular/robertpattinson/"
}
],
"page": {
"has_more": false,
"next_cursor": null,
"next_cursor_expires_at": null,
"end_reason": "end"
},
"meta": {
"request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f",
"platform": "instagram",
"source": "api",
"is_cached": false,
"credits_charged": 1,
"latency_ms": 1000,
"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.popularTrends.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/popular_trends?" + 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/popular_trends?" + 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/popular_trends")
.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/popular_trendsLong arrays and strings are shortened here. Real responses are complete.Docs One schema on 2 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 and Pinterest answer in these fields, so the code that reads one reads them all.
platformstring- Platform ID (pinterest, google, bluesky, …).
termstring- The trend's words as the platform shows them, whitespace-trimmed: a search term (Pinterest, Google and Instagram, usually lowercase: pass it as query to the platform's search endpoints) or a topic's headline (Bluesky).
urlstring- The trend's public page on the platform: its trend page where one answers logged out (Google Trends' explore page, Instagram's page for the term, Bluesky's feed of the topic's posts), else the platform's search results for it (Pinterest).
rankinteger- Position on the requested board, 1 = top; null when the answer is not a board.
categoriesstring[]- Categories the platform files the trend under, as shown (not normalized), the main one first; [] when none (listed in unknown_fields when the source cannot see them).
thumbnail_urlstring- A picture the platform shows beside the trend (a Pin's on Pinterest, a news article's on Google, a post's on Instagram); null when none or not read. Platform CDN URLs can expire.
approximate_fieldsstring[]- JSON paths of values rounded, bucketed or capped by the platform (Google's search volume bucket, Pinterest's rounded changes). [] when all exact.
unknown_fieldsstring[]- JSON paths of lists whose [] means unknown rather than none (a source that cannot see them, such as a board's history); null already means unknown for every other field. [] when every list is known.
Live data from 35 platforms.
What teams build with the Instagram Trending Searches API.
Spot what people search on Instagram now
Pick timely keywords for posts and reels
Track pop culture moments as they rise
Find shopping trends to sell into
Good to know before you build.
- Instagram picks the terms for everyone: there is no country or language to choose.
- rank counts within a section, so every section starts at 1. A term can sit in two sections.
- Browse categories have no post count or featured reel: Instagram shows none for them.
- A browse category's label, such as Motorsports and Cycling, is in categories; its term, such as cycling, is what Instagram searches.
- Send a term to the Instagram Topic API for its summary and related searches, or to the Instagram Search API for its reels.
- Profiles to look out for, the page's section of accounts, is left out: its entries are accounts, not searches.
1 credit per page. Failed requests are free.
Buy credits once and spend them on any endpoint, on any platform.
| 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 Searches API.
More in the API reference.
Are the post counts rounded?
How much does the Instagram Trending Searches API cost?
How do I get the next page?
See what's on the list right now.
Run it in the playground, or copy the request into your code.
- No credit card
- Failed requests are free
- Works on all 276 endpoints