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
Last 24 hours
Last 30 days
1Request
POST /api/v1/social { "platform": "instagram", "action": "hashtag_search", "params": { "keyword": "coffee" } }2JSON response
{ "results": [ { "rank": 1, "name": "coffeecoffeecoffee", "post_count": 1277620, "post_count_label": "1.2M posts" }, … ], "count": 5 }3Rows
rank name post_count post_count_label 1 coffeecoffeecoffee 1277620 1.2M posts 2 coffeephotography 1211660 1.2M posts 4CSV
instagram-hashtag_search-sample.csv rank,name,id,post_count,post_count_label,url,platform
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.
| rank | name | id | post_count | post_count_label | url | platform |
|---|---|---|---|---|---|---|
1 | coffeecoffeecoffee | 1277620 | 1.2M posts | https://www.instagram.com/explore/tags/coffeecoffeecoffee/ | ||
2 | coffeephotography | 1211660 | 1.2M posts | https://www.instagram.com/explore/tags/coffeephotography/ |
Use cases
Pick a hashtag
Read
nameandpost_countto 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
hashtagto read the posts under it.Compare how big the hashtags are
Compare
post_count_labelto 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.
| Compared | Hashtag Search | EveryInfra |
|---|---|---|
| What it returns | Endpoint 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
keywordis required: one word at a time, such ascoffee, 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
hashtagfor the posts. post_countis the post count of the hashtag.post_count_labelis 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.
| Calls | Cost |
|---|---|
| 10,000 | $5.56 |
| 100,000 | $55.56 |
| 1,000,000 | $555.56 |
Totals use the list price per call.
Code samples
#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.
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
#| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
Authorization | header | string | Yes | - | Bearer followed by your API key. Create it in the console; never put it in a URL or a code repository. |
platform | body | string | Yes | instagram | Platform identifier, fixed value. |
action | body | string | Yes | hashtag_search | Capability identifier, fixed value. |
keyword | body.params | string | Yes | - | The word to search, such as coffee, one word per call, with or without #. |
Response example
#{ "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.
| Field | Meaning |
|---|---|
rank | Position 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. |
name | Name of the object itself, for account, product and business capabilities. |
id | The record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms. |
post_count | Total posts. null means not disclosed, not 0. |
post_count_label | The post count as Instagram writes it, such as 2.2K posts. |
url | Link to the record on the platform. |
platform | Source 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.
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.
Related Instagram endpoints
You can call the other Instagram endpoints with the same key, such as hashtag to read the posts under one hashtag.
- Post details
post$0.56 per 1,000 callsFetch one or more Instagram posts or Reels from the links inurls. - Details
profile$0.56 per 1,000 callsLook up an Instagram account by handle or profile URL. - Account insights
persona$0.56 per 1,000 callsGet an account overview for an Instagram handle, built from its public profile. - Posts by user
user_posts$0.56 per 1,000 callsList posts from an Instagram account byusername, each with caption, media type, likes, comments, views, location, hashtags and top comments. - Content discovery
discover$0.56 per 1,000 callsTrack posts under an Instagram hashtag passed inkeyword. - Comments
comments$0.79 per 1,000 callsRead comments on one Instagram post or Reel aturl. - Reels
reels$1.19 per 1,000 callsPull an Instagram account's Reels byusername, with caption, play count, duration in seconds, likes, comments, hashtags, music and video link. - Hashtag
hashtag$0.56 per 1,000 callsCollect posts for an Instagram hashtag inhashtag, without the # sign. - Followers
followers$0.56 per 1,000 callsSee the follower and following counts of an Instagram account byusername. - Follower list
followers_list$0.56 per 1,000 callsList the accounts that follow an Instagram user, byusername, with handle, name, avatar, private and verified flags and relation type. - Following list
following_list$0.56 per 1,000 callsList the accounts an Instagram user follows, byusername, with handle, name, avatar, private and verified flags and relation type. - Account search
user_search$4.81 per 1,000 callsSearch Instagram accounts bykeyword, in the order Instagram search ranks them for that word. - Reels search
reels_search$7.19 per 1,000 callsSearch Instagram Reels bykeyword, such as coffee. - Similar accounts
similar_profiles$8.81 per 1,000 callsFind accounts Instagram suggests as similar to one account, byusernamesuch as nasa. - Tagged posts
tagged_posts$7.44 per 1,000 callsList public posts by other accounts that tag one Instagram account, given asusername, profile URL or numeric user ID. - Stories
stories$1.5 per 1,000 callsGet the stories an Instagram account has live right now, from its username. - Story highlights
highlights$1.6 per 1,000 callsList the story highlights on an Instagram profile. - Comment replies
comment_replies$0.88 per 1,000 callsRead the replies under one comment on an Instagram post or Reel, from the post link and the comment'sidreturned bycomments. - Post likers
likers$1.32 per 1,000 callsList the accounts that liked one Instagram post or Reel, from itsurl. - Posts at a location
location_posts$0.56 per 1,000 callsList the posts tagged at one Instagram location, fromlocation_id(theidin a post'slocation_detail, or a location page link). - Reels using a music track
audio_posts$0.56 per 1,000 callsList the Instagram Reels that use one piece of music, fromaudio_id(theaudio_idin a post'smusic, or an audio page link). - Explore
explore$0.56 per 1,000 callsRead one page of the posts Instagram recommends on Explore; no input is needed. - Engagement statistics
engagement$0.56 per 1,000 callsWork out an Instagram account's engagement from its latest posts, byusername. - Profile by numeric ID
profile_by_id$0.56 per 1,000 callsLook up an Instagram account from its numericuser_id. - About this account
user_about$0.56 per 1,000 callsRead the About this account panel of an Instagram profile byusername: the month it joined (joined_at), itscountry, how many times it changed its username (former_usernames_count) and when it was verified. - Location details
location_info$0.56 per 1,000 callsRead one Instagram location from itslocation_id: name, category, coordinates (lat,lng), address details when listed, andpost_count. - Link recognition
resolve_links$0.56 per 1,000 callsConvert one Instagram post reference intext(a post link, a shortcode or a numeric post ID) into all three:shortcode,media_idandurl. - Post embed code
oembed$0.56 per 1,000 callsGet the oEmbed data and embed code for one Instagram post or Reel from itsurl: the same fields as Instagram's official oEmbed, withhtmlready to paste into a web page. - Post caption translation
post_translation$6.39 per 1,000 callsTranslate the caption of one Instagram post intotarget_language(defaulten), from itsurlormedia_id. - Nearby locations
location_nearby$0.56 per 1,000 callsList the locations Instagram shows near one location, from itslocation_id: about 20 rows in one call, no next page. - Stories in a highlight
highlight_stories$0.56 per 1,000 callsRead every story in one Instagram highlight fromhighlight_id(theidfromhighlights, or a highlight link): up to 100 stories in one call, with media links,posted_atandduration_seconds. - Comment translations
comment_translations$6.39 per 1,000 callsTranslate up to 10 comments on one Instagram post, from the posturlandcomment_ids, intotarget_language(defaulten). - Recommended Reels
recommended_reels$1.18 per 1,000 callsRead the Reels Instagram recommends on its Reels page, 10 per page; no input is needed. - User reposts
user_reposts$0.56 per 1,000 callsList the posts and Reels an Instagram account reposted to its profile, byusername, 12 per page. - Cities in a country
location_cities$0.56 per 1,000 callsList the cities Instagram's location directory has for onecountry_code, 96 per page. - Locations in a city
city_locations$0.56 per 1,000 callsList the locations Instagram's location directory has for one city, fromcity_id, 96 per page. - Profiles in bulk
profiles_batch$0.56 per 1,000 callsLook up as many as 20 Instagram accounts at once fromusernames, each given as a username such asnatgeoor a profile link.