Instagram Hashtag API
Collect the posts under an Instagram hashtag in hashtag, each with text, media_type, like_count, view_count and the author's follower count, for $0.56 per 1,000 calls.
- Up to 100 posts per call
- Pass
reelsfor short videos - No Instagram login needed
API health
- 24h health
- 63%
- 24h average time
- 15.48 s
- Healthy / normal
- Available
- Limited
- Mostly down
Last 24 hours
Last 30 days
1Request
POST /api/v1/social { "platform": "instagram", "action": "hashtag", "params": { "hashtag": "photography" } }2JSON response
{ "results": [ { "text": "📸@••• @••• @••• #photography #hobbymodel #jewelry #tattoo #quarry", "post_id": "DdvvbQ1ufeL", "media_type": "image", "like_count": 0 }, … ], "count": 30 }3Rows
text post_id media_type like_count 📸@••• @••• @••• #photography #hobbymodel #jewelry #tattoo #quarry DdvvbQ1ufeL image 0 ✨..♠️❤️..✨ #instareels #viralpost #malvan #instagram #photography Ddvva9EEUmp image 0 4CSV
instagram-hashtag-sample.csv post_id,url,text,media_type,like_count,comment_count,view_count,author_username,author_name,posted_at,location,id,image_url,video_url,author_id,width,height,is_comments_disabled,author_follower_count,hashtags,top_comments,platform
hashtag (no #) and optional results_type and limit goes in. One response returns the posts under that tag, and these become table rows and a CSV file.What data you get
The table shows rows from a real call for photography, captured September 26, 2026 at 08:56 (UTC), that returned 30 rows. Gray bars mark removed personal information (••• in the CSV). Your own calls return these fields as listed in the field reference.
| post_id | url | text | media_type | like_count | comment_count | view_count | author_username | author_name | posted_at | location | id | image_url | video_url | author_id | width | height | is_comments_disabled | author_follower_count | hashtags | top_comments | platform |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| DdvvbQ1ufeL | https://www.instagram.com/p/DdvvbQ1ufeL/ | 📸@••• @••• @••• #photography #hobbymodel #jewelry #tattoo #quarry | image | 0 | 0 | null | 2026-09-26T09:43:53+00:00 | Aschaffenburg, Germany | null | null | null | null | null | null | null | null | ["photography","hobbymodel","jewelry"] | null | |||
| Ddvva9EEUmp | https://www.instagram.com/p/Ddvva9EEUmp/ | ✨..♠️❤️..✨ #instareels #viralpost #malvan #instagram #photography | image | 0 | 0 | null | 2026-09-26T09:43:48+00:00 | Malvan , Sindhudurg | null | null | null | null | null | null | null | null | ["instareels","viralpost","malvan"] | null |
Use cases
Topic research
Read
textandlike_countunder a hashtag to see what people post and which posts draw engagement.Campaign hashtag tracking
Pull posts for a campaign tag and use
posted_atto see what is new.Find creators
Read
author_usernameandauthor_follower_countto find creators who post under a tag.Short videos only
Set
results_typetoreelsto get only the Reels under the hashtag.
Hashtag Search vs EveryInfra
Here is how Instagram's official Hashtag Search and EveryInfra hashtag compare on query volume, rows per request and author fields.
| Compared | Hashtag Search | EveryInfra |
|---|---|---|
| Query volume | "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 hashtag and costs $0.000556, billed per call. |
| Rows per request | "Responses are paginated with a maximum limit of 50 results per page." | limit is 1 to 100 and defaults to 30. One call returns at most 100 rows, and there is no page parameter. |
| Author fields | "You cannot request the username field on returned media objects." | Each row has author_username, author_name and author_follower_count. |
Quotes are from Meta's developer documentation, checked 2026-11-09. Official sources: Hashtag Search (updated 2026-08-17) · IG Hashtag Top Media (updated 2026-08-17)
Limits and gotchas
hashtagis required, without the #, and is a tag word rather than an account handle.tagis a compatibility input; if both are sent,hashtagwins.- Leave out
results_typefor regular posts, or passreelorreelsfor short videos. You cannot pass posts explicitly, and any other value returns 422. limitis an integer from 1 to 100 and defaults to 30; larger values return 422 before any charge.- There is no page parameter. One call returns at most 100 rows and can return fewer than
limit. - The rows are a batch of posts under the tag. On its own, the sample does not measure the total volume of a trend.
author_follower_countandview_countarenullwhen not disclosed; that is not 0.hashtagsandtop_commentsare absent when there is nothing to show.
Pricing
You pay $0.000556 per call, not per row, and one call reads up to 100 posts. 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",
"params": {
"hashtag": "photography"
}
}'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, 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 endpoint (instagram/hashtag).
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, and put the parameters inside params.
- Required parameters:
- hashtag: Accepts an Instagram hashtag string without the leading # symbol (e.g., coffee) to list associated posts or reels. This parameter requires a hashtag name rather than an account handle.
- Optional parameters:
- results_type: Selects the content type for discover and hashtag: omit it for regular posts, or pass reel or reels for short videos. posts cannot be passed explicitly, and any other value returns 422. (allowed: reel / reels)
- tag: Provides compatibility input for the hashtag action, automatically stripping leading # symbols. When both are supplied, hashtag takes precedence. Public requests must still include the required hashtag parameter.
- limit: The most rows to return in this call, an integer from 1 to 100. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. (default: 30)
- Returns a list of records. Main fields of each record: post_id, url, text, media_type, like_count, comment_count, view_count, author_username, author_name, posted_at, location, id; 21 fields in total, full list at https://api.everyinfra.com/api/v1/social/catalog?platform=instagram.
- Example request body:
{
"platform": "instagram",
"action": "hashtag",
"params": {
"hashtag": "photography"
}
}
- 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 | Capability identifier, fixed value. |
hashtag | body.params | string | Yes | - | Accepts an Instagram hashtag string without the leading # symbol (e.g., coffee) to list associated posts or reels. This parameter requires a hashtag name rather than an account handle. |
results_type | body.params | string (enum) | No | - | Selects the content type for discover and hashtag: omit it for regular posts, or pass reel or reels for short videos. posts cannot be passed explicitly, and any other value returns 422. It does not choose the response file format.Allowed valuesreelreels |
tag | body.params | string | No | - | Provides compatibility input for the hashtag action, automatically stripping leading # symbols. When both are supplied, hashtag takes precedence. Public requests must still include the required hashtag parameter. |
limit | body.params | integer (1–100) | No | 30 | The most rows to return in this call, an integer from 1 to 100. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. |
Response example
#{ "id": "req_…", "platform": "instagram", "action": "hashtag", "results": [ { "post_id": "DdvvbQ1ufeL", "url": "https://www.instagram.com/p/DdvvbQ1ufeL/", "text": "📸@••• \n\n@••• \n@••• \n\n#photography #hobbymodel #jewelry #tattoo #quarry", "media_type": "image", "like_count": 0, "comment_count": 0, "author_username": "•••", "author_name": "•••", "posted_at": "2026-09-26T09:43:53+00:00", "location": "Aschaffenburg, Germany", "hashtags": [ "photography", "hobbymodel", "jewelry" ], "platform": "instagram" }, { "post_id": "Ddvva9EEUmp", "url": "https://www.instagram.com/p/Ddvva9EEUmp/", "text": "✨..♠️❤️..✨\n\n#instareels #viralpost #malvan #instagram #photography", "media_type": "image", "like_count": 0, "comment_count": 0, "author_username": "•••", "author_name": "•••", "posted_at": "2026-09-26T09:43:48+00:00", "location": "Malvan , Sindhudurg", "hashtags": [ "instareels", "viralpost", "malvan" ], "platform": "instagram" } ], "count": 30, "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 |
|---|---|
post_id | Keeps the platform's own meaning |
url | Link to the record on the platform. |
text | Body text with HTML removed, returned in full and never cut short (on a few platforms the list results themselves carry only an excerpt; the platform's field notes say so). |
media_type | Keeps the platform's own meaning |
like_count | Likes. null means the platform or this capability does not disclose it; it is not 0. |
comment_count | Comments. null means not disclosed, not 0. |
view_count | Views or plays. null means not disclosed, not 0. |
author_username | Author's username (@handle), usually usable in URLs. |
author_name | Author's display name. |
posted_at | Publish time in ISO 8601, UTC (for example 2026-08-07T12:34:56+00:00). Non-standard strings from the platform are passed through as is, so parse defensively. null means the platform does not disclose it. |
location | Location description passed through as is; the format varies by platform. |
id | The record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms. |
image_url | Image link. Capabilities with several images may return an image_urls array. |
video_url | Keeps the platform's own meaning |
author_id | Author's unique ID on the platform. |
width | Keeps the platform's own meaning |
height | Keeps the platform's own meaning |
is_comments_disabled | Keeps the platform's own meaning |
author_follower_count | Author's follower count. null means not disclosed. |
hashtags | Hashtags in the text, in order of appearance; absent when there are none. |
top_comments | Keeps the platform's own meaning |
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 API return?
It returns the posts under the tag: text, media_type, like_count, view_count and author_follower_count, plus hashtags when present.
How many posts can one call return, and how do I get only Reels?
limit is 1 to 100 and defaults to 30; there is no page parameter. Set results_type to reel or reels for Reels. Leave it out for regular posts.
How much does it 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. No Instagram login or Instagram access token is needed.
What is the difference between hashtag and discover?
Both read posts under a tag. hashtag takes hashtag, answers in the same response and returns up to 100 rows. discover takes keyword, returns a job_id first and returns up to 200 rows.
Related Instagram endpoints
You can call the other Instagram endpoints with the same key, such as reading a post by its link or an account's Reels.
- 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. - 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.