Instagram data API

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

cURL
curl "https://api.igramapi.com/v1/hashtags/streetphotography?limit=12" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

200 OK · application/json
{
  "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

NameInDescription
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

FieldTypeDescription
hashtag / titlestringNormalized tag and display title.
items[].shortcode / permalinkstringIdentify and link the post.
items[].media_typestringimage or video.
items[].thumbnail / video_urlstring | nullMedia links (temporary).
items[].author / like_count / play_countstring / integer | nullCreator and engagement.
pageobjecthas_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.