List what Instagram is trending
The search terms Instagram itself is promoting, grouped into its own sections, each with Instagram’s count of posts under it. Use it to see what Instagram is putting in front of everyone; it is not keyword search, which Instagram does not make public.
/trending-searches Discovery https://api.fetchlayer.dev/instagram/trending-searches Headers
Authorization string required Bearer token — your FetchLayer API key.
Parameters
limit integer optional Maximum terms returned, up to 100. Use -1 for the maximum. When Instagram publishes more terms than were returned, the note says how many. (default: 48)
format string optional json or markdown, lowercase; any other value is a 400. Over MCP, markdown returns the result rendered as text; the REST API accepts it and returns JSON. (default: json)
timeoutMs integer optional Time limit for the whole request, in milliseconds (1000–120000); a value outside that range is a 400. When it runs out, a paged request returns what it has with nextCursor, billed for the pages it returned; a request with nothing to return yet fails with a 503 you can retry, marked with the response header X-Timeout-Source: caller. Left out, the request runs as long as it needs.
Response Fields
trending-searches
List what Instagram is trending
transport string The data source: always the platform id, "instagram".
notes string[] Caveats you can act on — a ceiling Instagram imposes, a counter it withholds, a list that stopped early. Several real limits are reported only here, so read them. An empty result always comes with a note explaining it, never as an unexplained empty array.
pagesFetched number Pages of results fetched, which is what the request costs: one credit per page. resolve-url reports 0 and is not billed.
searches object[] The trending terms, in Instagram’s own order.
searches[].keyword string The term Instagram is promoting.
searches[].mediaCount number Posts Instagram counts under the term. Instagram’s own figure, and rounded by it; null when Instagram shows no count for the term.
searches[].section string The section Instagram published it under. There are currently seven — "Trending now", "Pop culture moments", "Find what you’re into", "Get inspired", "Learn something new", "Shop the trends" and "What’s happening now" — but the set changes over time, and the note names the sections in each response.
searchCount number How many terms are in this response.
Request
curl -X POST "https://api.fetchlayer.dev/instagram/trending-searches" \
-H "Authorization: Bearer ss-your-key" \
-H "Content-Type: application/json" \
-d '{"limit":48}'Response
{
"transport": "instagram",
"notes": [
"Grouped into the 7 sections Instagram publishes: \"Trending now\", \"Pop culture moments\", \"Find what you're into\", \"Get inspired\", \"Learn something new\", \"Shop the trends\", \"What's happening now\".",
"Counts are Instagram’s own figure for posts under each term, and are rounded by it.",
"Instagram published 84 terms; raise limit to get the rest."
],
"pagesFetched": 1,
"searches": [
{
"keyword": "kash patel",
"mediaCount": 142014,
"section": "Trending now"
},
{
"keyword": "nlcs",
"mediaCount": 470996,
"section": "Trending now"
},
{
"keyword": "halloween costume ideas",
"mediaCount": 901431,
"section": "Get inspired"
},
{
"keyword": "cute animals",
"mediaCount": null,
"section": "Find what you're into"
}
],
"searchCount": 48
}