The search terms Instagram itself is promoting, grouped into the sections it publishes — what is trending now, pop-culture moments, profiles to watch, categories, and what is happening this month — each with the number of posts Instagram counts under it. This is not keyword search. Instagram publishes no search to a signed-out reader at all; this is what Instagram is putting in front of everyone, which is a different and smaller thing. mediaCount is Instagram's own figure, rounded by Instagram. Up to 100 terms, 48 by default; when Instagram publishes more than were returned, notes says how many. Billing: 1 credit.

POST /trending-searches Discovery

https://api.fetchlayer.dev/instagram/trending-searches

OpenAPI JSON

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. (default: 48)

format string optional

json or markdown. Markdown returns a rendered summary instead of the structured record. (default: json)

timeoutMs integer optional

Time limit for each individual page read, in milliseconds (max 60000). It bounds one page, not the whole request.

Response Fields

trending-searches

List what Instagram is trending

transport string

The upstream source. Always "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 read, 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.

searches[].section string

The section Instagram published it under, e.g. "Trending now" or "Pop culture moments".

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 4 sections the source publishes, such as what is trending now and what is popular this month.",
    "Counts are the source’s own figure for posts under each term, and are rounded by it.",
    "The source published 84 terms; raise limit to read the rest."
  ],
  "pagesFetched": 1,
  "searches": [
    {
      "keyword": "kash patel",
      "mediaCount": 142014,
      "section": "Trending now"
    },
    {
      "keyword": "helicoptercrash",
      "mediaCount": 18,
      "section": "Trending now"
    },
    {
      "keyword": "independencia",
      "mediaCount": 4905537,
      "section": "Trending now"
    }
  ],
  "searchCount": 48
}

{
  "error": "Invalid API key"
}