Instagram Hashtag search API

Find the hashtags that Instagram's search box gives for a keyword such as coffee: name, id, post_count, post_count_label and url, for $0.56 per 1,000 calls.

  • With or without the # sign
  • All rows in one response, no next page
  • Failed calls and empty results are not charged

API health

24h health
Normal
  • Healthy / normal
  • Available
  • Limited
  • Mostly down
Normal

Last 24 hours

Last 30 days

  1. 1Request

    POST /api/v1/social
    {
      "platform": "instagram",
      "action": "hashtag_search",
      "params": {
        "keyword": "coffee"
      }
    }
  2. 2JSON response

    {
      "results": [
        {
          "rank": 1,
          "name": "coffeecoffeecoffee",
          "post_count": 1277620,
          "post_count_label": "1.2M posts"
        },
        …
      ],
      "count": 5
    }
  3. 3Rows

    ranknamepost_countpost_count_label
    1coffeecoffeecoffee12776201.2M posts
    2coffeephotography12116601.2M posts
  4. 4CSV

    instagram-hashtag_search-sample.csv rank,name,id,post_count,post_count_label,url,platform

A request with keyword goes in. One response returns the hashtags the search box gives for that word, each row with name, post_count and url. These become table rows and a CSV file.

What data you get

The table shows rows from a real call for keyword coffee, captured November 21, 2026 at 07:18 (UTC), that returned 5 hashtags. Gray bars mark removed personal information (••• in the CSV). Your own calls return these fields as listed in the field reference.

ranknameidpost_countpost_count_labelurlplatform
1coffeecoffeecoffee12776201.2M postshttps://www.instagram.com/explore/tags/coffeecoffeecoffee/instagram
2coffeephotography12116601.2M postshttps://www.instagram.com/explore/tags/coffeephotography/instagram

Use cases

  • Pick a hashtag

    Read name and post_count to pick the one with more posts among close tags.

  • Find close hashtags for a word

    Enter one word and see which hashtags Instagram's search box gives.

  • Go on to the posts under a tag

    Once you have the tag name, use hashtag to read the posts under it.

  • Compare how big the hashtags are

    Compare post_count_label to see the post counts the page writes for each tag.

Hashtag Search vs EveryInfra

Here is how the official Hashtag Search and EveryInfra hashtag_search compare on what they return, on access review and on how many hashtags you can query each week.

ComparedHashtag SearchEveryInfra
What it returnsEndpoint GET /ig_hashtag_search: "to get a specific hashtag’s node ID"One call queries one keyword and returns the hashtags the search box gives for that word, each row with name, id and post_count.
Access review"In order to use this API, you must undergo App Review and request approval for:" "the Instagram Public Content Access feature"You send one EveryInfra API key in the Authorization: Bearer header. You do not submit a Meta app review and do not log in to Instagram.
Hashtags you can query each week"You can query a maximum of 30 unique hashtags on behalf of an Instagram Business or Creator Account within a rolling, 7 day period."One call queries one keyword, billed per call at $0.000556.

Quotes are from Meta's developer documentation, checked 2026-11-22. Official sources: Hashtag Search (updated 2026-11-18)

Limits and gotchas

  • keyword is required: one word at a time, such as coffee, with or without the # sign.
  • The result is the hashtags that Instagram's search box gives for the word. All rows come back in one response and there is no next page. The number of rows differs by word.
  • This capability only finds hashtags and does not read the posts under them. Use hashtag for the posts.
  • post_count is the post count of the hashtag. post_count_label is the post count as Instagram's page writes it, such as 2.2K posts.
  • When nothing is found, the call returns an empty result and is not charged.

Pricing

You pay $0.000556 per call, not per row. There is no paging. All rows come in one call. Failed calls and empty results are not charged.

CallsCost
10,000$5.56
100,000$55.56
1,000,000$555.56

Totals use the list price per call.

Code samples

#
bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "instagram",
  "action": "hashtag_search",
  "params": {
    "keyword": "coffee"
  }
}'

OpenAPI definition (JSON)Samples read the key from the EVERYINFRA_API_KEY environment variable; copied code never contains your key.

API reference

See the parameters, response fields, errors and billing for hashtag_search, and copy the page or open it as Markdown for an AI assistant.

POST

AI prompt

#
Please help me write a data collection script with the EveryInfra Instagram Hashtag search endpoint (instagram/hashtag_search).

How the endpoint works:
- Request: POST https://api.everyinfra.com/api/v1/social with the header Authorization: Bearer <API key>. Read the key from the EVERYINFRA_API_KEY environment variable and never hard-code it.
- In the request body, set platform to instagram and action to hashtag_search, and put the parameters inside params.
- Required parameters:
  - keyword: The word to search, such as coffee, one word per call, with or without #.
- Returns a list of records. Main fields of each record: rank (Position from 1: the order of this row…), name, id, post_count, post_count_label (The post count as Instagram writes it,…), url.
- Example request body:
{
  "platform": "instagram",
  "action": "hashtag_search",
  "params": {
    "keyword": "coffee"
  }
}
- Price: $0.56 per 1,000 requests; failed and empty results are not charged.
- For dozens or hundreds of targets, add "mode": "async" to the body: you get a job_id at once and poll GET https://api.everyinfra.com/api/v1/jobs/{job_id} for the result.
- On 422, fix the request using the suggested parameter names and allowed values in the error; on 429 or 503, wait for Retry-After and try again.

Before writing code, ask me which targets I need, how many, which fields, and what output format I want; then confirm the plan and the rough cost with me.

Request parameters

#
NameInTypeRequiredDefaultDescription
AuthorizationheaderstringYes-Bearer followed by your API key. Create it in the console; never put it in a URL or a code repository.
platformbodystringYesinstagramPlatform identifier, fixed value.
actionbodystringYeshashtag_searchCapability identifier, fixed value.
keywordbody.paramsstringYes-The word to search, such as coffee, one word per call, with or without #.

Response example

#
Captured November 21, 2026 at 07:18 (UTC) by calling this API with the parameters in the code sample above. results and count are that call's real response with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2. id, billing and quota differ on every call, so only their shape is shown.
json
{  "id": "req_…",  "platform": "instagram",  "action": "hashtag_search",  "results": [    {      "rank": 1,      "name": "coffeecoffeecoffee",      "id": "•••",      "post_count": 1277620,      "post_count_label": "1.2M posts",      "url": "https://www.instagram.com/explore/tags/coffeecoffeecoffee/",      "platform": "instagram"    },    {      "rank": 2,      "name": "coffeephotography",      "id": "•••",      "post_count": 1211660,      "post_count_label": "1.2M posts",      "url": "https://www.instagram.com/explore/tags/coffeephotography/",      "platform": "instagram"    }  ],  "count": 5,  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

Response fields

#

Business data is in results. The table lists the fields a record can contain; values the platform does not show are never made up.

FieldMeaning
rankPosition from 1: the order of this row within this result. user_search: first the accounts returned by Instagram's search box (matched_by is search_box), in the search box's order; then the authors of posts found with this keyword, added to fill up the count (matched_by is post_author); results without matched_by carry the position at which Instagram ranks the account for this keyword. similar_profiles: the account's place among the similar accounts, ordered by followers. likers: the account's place in the list of likers.
nameName of the object itself, for account, product and business capabilities.
idThe record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms.
post_countTotal posts. null means not disclosed, not 0.
post_count_labelThe post count as Instagram writes it, such as 2.2K posts.
urlLink to the record on the platform.
platformSource platform identifier, the same as platform in the request (for example xiaohongshu, tiktok).

Errors and billing

#
401
Missing or invalid key.
402
Insufficient balance. Top up first.
422
Invalid parameter name or value. Fix it using the suggestions in the error. No charge.
429
Per-minute request limit reached. Wait for Retry-After, then try again.
503
Could not complete. The held charge is returned to your balance. If the outcome is unknown, verify it before you retry.
200 empty
No data. No charge.

Errors

FAQ

What does the Instagram hashtag search API return?

Each row is one hashtag: name, id, post_count, post_count_label and url, plus rank.

How do I read the posts under a hashtag?

hashtag_search only finds hashtags. Once you have the tag name, use hashtag to read the posts under it.

Do I write the # sign in keyword?

No. It works with or without the # sign, one word at a time.

How much does one search cost?

It costs $0.000556 per call, or $0.56 per 1,000 calls, billed per call and not per row. Failed calls and empty results are not charged.

Do I need an Instagram login?

No. You send one EveryInfra API key in the Authorization: Bearer header, and the request carries only keyword. No Instagram login or access token is needed.

You can call the other Instagram endpoints with the same key, such as hashtag to read the posts under one hashtag.

Google Analytics needs consent. Privacy