Instagram Hashtag API
Search any hashtag and get the popular posts and reels Instagram shows for it, with thumbnails, captions, authors and engagement. Page through results with a cursor and query as many hashtags as you need.
Request
GET /v1/hashtags/{tag} ·
3 credits per successful call
Paid plans
curl "https://api.igramapi.com/v1/hashtags/streetphotography?limit=12" \
-H "Authorization: Bearer YOUR_API_KEY" import requests
response = requests.get(
"https://api.igramapi.com/v1/hashtags/streetphotography?limit=12",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=30,
)
response.raise_for_status()
print(response.json()) const response = await fetch("https://api.igramapi.com/v1/hashtags/streetphotography?limit=12", {
method: "GET",
headers: {
Authorization: "Bearer YOUR_API_KEY",
},
});
if (!response.ok) throw new Error((await response.json()).error.message);
console.log(await response.json()); <?php
$ch = curl_init("https://api.igramapi.com/v1/hashtags/streetphotography?limit=12");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer YOUR_API_KEY",
],
]);
$data = json_decode(curl_exec($ch), true);
print_r($data); Response
{
"hashtag": "streetphotography",
"title": "#streetphotography",
"items": [
{
"shortcode": "Cy9ZyXwVuTs",
"media_type": "image",
"thumbnail": "https://scontent.cdninstagram.com/v/example/tag1.jpg",
"video_url": null,
"caption": "Golden hour in the old town",
"permalink": "https://www.instagram.com/p/Cy9ZyXwVuTs/",
"author": "city_frames",
"like_count": 8210,
"play_count": null
}
],
"page": {
"has_next_page": true,
"end_cursor": "QVFDX2V4YW1wbGVjdXJzb3I"
},
"cached": false
} All values above are made-up examples. Media links are temporary Instagram CDN addresses.
Parameters
| Name | In | Description |
|---|---|---|
tagrequired | path | Hashtag with or without the # sign. |
limit | query | Items per page, 1 to 50 (default 12). |
cursor | query | `page.end_cursor` from the previous page. |
Response fields
| Field | Type | Description |
|---|---|---|
hashtag / title | string | Normalized tag and display title. |
items[].shortcode / permalink | string | Identify and link the post. |
items[].media_type | string | image or video. |
items[].thumbnail / video_url | string | null | Media links (temporary). |
items[].author / like_count / play_count | string / integer | null | Creator and engagement. |
page | object | has_next_page and end_cursor. |
No 30-hashtag weekly cap
Instagram's official hashtag search allows 30 unique hashtags per account per week. Here you simply pay per call.
Posts and reels
Each item says whether it is an image or a video and links to the post.
Authors included
See who is posting under a tag, then look them up with the Profile API.
Paid plans
Each call uses 3 credits and is available on every paid plan.
Hashtag research without the weekly limit
Meta's official hashtag search requires app review, only returns data for business accounts you connect, and caps you at 30 unique hashtags in any rolling seven days. That makes broad research or monitoring of many campaigns impractical.
The Hashtag API has no such cap. Query a hundred tags in an afternoon, and track how the popular posts for each one change over time.
What the results represent
Results are the popular posts Instagram surfaces for a hashtag, not an exhaustive list of every post that used it. That is ideal for trend research, content inspiration and finding active creators in a niche.
Frequently asked questions
Does it return every post that uses the hashtag?
No. It returns the popular posts and reels Instagram shows for that tag, which is what most research and discovery work needs.
Is there a limit on how many hashtags I can search?
There is no cap on unique hashtags. Your plan's credits and per-minute limit apply.
Can I search emoji hashtags?
Use standard text hashtags. Emoji-only tags are not supported.
Which plans include it?
All paid plans.
Errors cost nothing. Any response with a status of 400 or above is refunded, and every error has the same shape. See error handling and credits and rate limits.
Try the Hashtag API free
Create a key and make your first request in minutes. 100 free credits every month.