Instagram hashtag suggestions API

Q: What if no Instagram hashtag matches my word?

An unusual word answers an empty list. query takes a word or the start of one, with or without #.

Q: Is the hashtag post count exact?

extra.post_count is the number. extra.post_count_label is the rounded label Instagram prints beside it, such as 4.8M for nikeairmax.

Q: What do I send?

query (required): The word or start of a word to find hashtags for, with or without #.

Q: Which errors can it return?

invalid_params and not_found . None is charged, and the errors list says which to retry.

Q: Is there an SDK call for it?

client.instagram.search(...) in Python and client.instagram.search() in TypeScript.

Instagram's own hashtag search for the words.

Get an API key See a sample response

100 free credits. No card needed.

Each request1 credit

Fields in each suggestion10

A failed requestFree

A cached repeatFree

What you get for each suggestion

The text

The suggestion's full text.

kindhashtag

Account type

What kind of account it is, such as hashtag.

id17841562978125529

Ids

Instagram's own id for it.

What you can build with it

Hashtags sized before you use them

Type a word and get the hashtags that start with it, each with its post count. For nike, the sample's first two are nikewomen at 2,027,008 posts and nikeairmax at 4,839,167.

Posts per hashtag for nikeSample

2,027,008

nikewomen

4,839,167

nikeairmax

The tags a brand name has spawned

About 50 hashtags come back in one page, in Instagram's order, the family of tags people have built around a brand or product name.

Brand monitoring

Fields on the first suggestionSample

text

nikewomen

label

kind

hashtag

Niche tags worth owning

Small tags read 100+ in extra.post_count_label, the mark of a tag quiet enough for a campaign to lead rather than drown in.

Fields on result 2Sample

text

nikeairmax

posts

4,839,167

label

4.8M

How it works

1
Get a key
Sign up and get 100 free credits. No card needed.
Your API key100 free credits
2
Send a search
Pass query (nike).
nike
3
Page through the results
Send back cursor until has_more is false.
Page 2Page 3

Request and response

Request

1curl -G "https://api.socialscrape.dev/v1/instagram/search" \2  -d query=nike \3  -H "x-api-key: $SOCIALSCRAPE_API_KEY"

1import requests2 3r = requests.get(4  "https://api.socialscrape.dev/v1/instagram/search",5  params={"query": "nike"},6  headers={"x-api-key": KEY},7)8suggestions = r.json()["data"]["items"]

1const url = new URL("https://api.socialscrape.dev/v1/instagram/search");2url.searchParams.set("query", "nike");3 4const res = await fetch(url, {5  headers: { "x-api-key": KEY },6});7const { data } = await res.json();

Response200 OKSample values

{
  "ok": true,
  "credits_charged": 1,
  "data": {
    "items": [
      { "text": "nikewomen",
        "url": "https://www.instagram.com/explore...",
        "kind": "hashtag" },
      ...
    ],
    "has_more": false
  }
}

See every parameter in the docs

Use it from your AI agent

Ask in plain words

Ask your agent for Instagram hashtag suggestions in plain words, and the SocialScrape MCP server makes the call.

Set up the MCP server

One tool call

Instagram hashtag suggestions, given a search.

Same price as the API

1 credit a call; a repeat within 1 days is free.

Runs on your machine

Your key stays in your agent's settings.

Pairs well with

Pay only for data you get

A page of suggestions1 credit

The same request within max_age_daysFree

A failed requestFree

Free credits for new accounts100

Starter

18,000 credits a month

GrowthMost popular

50,000 credits a month

Scale

150,000 credits a month

$27/mo

$73/mo

$209/mo

Get an API key

$1.50 per 1,000

$1.46 per 1,000

$1.39 per 1,000

Resets monthly

No rate limits

Over 1M credits a month? Talk to us. Or see full pricing.

Questions

Does Instagram hashtag search return accounts too?

No, hashtags only: accounts, places and keyword suggestions are not in the answer. For accounts use Instagram profile search, and for a tag's posts Instagram posts by hashtag.

What if no Instagram hashtag matches my word?

An unusual word answers an empty list. query takes a word or the start of one, with or without #.

Is the hashtag post count exact?

extra.post_count is the number. extra.post_count_label is the rounded label Instagram prints beside it, such as 4.8M for nikeairmax.

What does it return?

The hashtags that start with them, in Instagram's order, about 50 in one page with no cursor. Each carries its id, url and post count (extra.post_count, and extra.post_count_label, the rounded label Instagram prints; small tags read 100+). An unusual word answers an empty list. Accounts, places and keyword suggestions are not in the answer. For a hashtag's posts use search/hashtag; for accounts search/profiles. Each suggestion has up to 10 fields, and the sample fills kind, text, id and url.

What do I send?

query (required): The word or start of a word to find hashtags for, with or without #.

Which errors can it return?

invalid_params and not_found. None is charged, and the errors list says which to retry.

Is there an SDK call for it?

client.instagram.search(...) in Python and client.instagram.search() in TypeScript.

Same key works everywhere

TikTokFacebookYouTubeGitHubLinkedInRedditX (Twitter)SpotifyCosmosThreadsPinterestTwitchSee all 29 platforms