Instagram Hashtag Posts API
List the top posts, the newest posts or the Reels on an Instagram hashtag page, with captions, media links, publish times, engagement counts, owner details and the audio each Reel uses. Continue with nextCursor.
- Endpoint
- POST /instagram/hashtag-posts
- Price
- 1 credit per request
- SDK
- client.instagram.getHashtagPosts()
- MCP tool
- instagram_hashtag_posts
curl -X POST "https://api.bridgly.app/instagram/hashtag-posts" \ -H "Authorization: Bearer $BRIDGLY_KEY" \ -H "Content-Type: application/json" \ -d '{ "hashtag": "sunset", "tab": "recent"}'import osimport requestsresponse = requests.post( "https://api.bridgly.app/instagram/hashtag-posts", headers={"Authorization": f"Bearer {os.environ['BRIDGLY_KEY']}"}, json={ "hashtag": "sunset", "tab": "recent", },)data = response.json()const response = await fetch("https://api.bridgly.app/instagram/hashtag-posts", { method: "POST", headers: { Authorization: `Bearer ${process.env.BRIDGLY_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ "hashtag": "sunset", "tab": "recent" }),});const data = await response.json();import { Bridgly } from "@bridgly/sdk";const client = new Bridgly({ apiKey: "bgly_YOUR_KEY" });const res = await client.instagram.getHashtagPosts({ hashtag: "sunset", tab: "recent"});if (res.type === "success") { console.log(res.data);}What does the Instagram Hashtag Posts API return?
List the top posts, newest posts or Reels for an Instagram hashtag as JSON, with captions, media links, engagement counts, owners and audio. Every response has the same envelope: the result in data, plus timeMs and the creditsCost of the call.
Request body
hashtagstringrequired- Hashtag with or without the #, or its link, e.g. "sunset" or "https://www.instagram.com/explore/tags/sunset/".
tabenum · default top- Which hashtag tab to list: "top" for top posts, "recent" for the newest posts, or "reels" for Reels. Defaults to "top".
- top | recent | reels
countinteger · 1–10 · default 10- Number of results to return (1–10). Defaults to 10.
cursorstring- The previous response's `nextCursor`, to fetch the next page. Omit it for the first page.
cacheMaxAgeHoursinteger- Accept a cached result scraped up to this many hours ago. A cached result costs no credits, and its `cachedAt` says when it was scraped. When no cached result is that recent, the data is scraped live at the normal price. Leave it out to always scrape live, e.g. 24.
cacheOnlyboolean- Return only a cached result and never scrape live. With `cacheMaxAgeHours`, only a result that recent is returned; without it, the latest cached result of any age. Responds 404, at no cost, when there is none, e.g. true.
Example response
{ "timeMs": 1840, "creditsCost": 1, "cachedAt": "2026-01-15T09:30:00.000Z", "data": { "nextCursor": "string", "posts": [ { "id": "string", "type": "Image", "display_url": "string", "video_url": "string", "width": 0, "height": 0, "video_duration": 0, "accessibility_caption": "string", "image_versions": [ { "url": "string", "width": 0, "height": 0 } ], "video_versions": [ { "url": "string", "width": 0, "height": 0, "type": 0 } ], "has_audio": true, "video_dash_manifest": "string", "number_of_qualities": 0, "carousel_parent_id": "string", "user_tags": [ { "user": { "id": "string", "username": "string", "full_name": "string", "profile_pic_url": "string", "is_private": true, "is_verified": true, "profile_pic_id": "string", "latest_reel_media": 0, "is_mentionable": true }, "position": [ 0 ] } ], "shortcode": "string", "url": "string", "caption": "string", "likes": 0, "comments": 0, "timestamp": 0, "is_video": true, "video_view_count": 0, "owner": { "id": "string", "username": "string", "full_name": "string", "profile_pic_url": "string", "is_private": true, "is_verified": true, "profile_pic_id": "string", "latest_reel_media": 0, "is_mentionable": true }, "carousel_media": [ { "id": "string", "type": "Image", "display_url": "string", "video_url": "string", "width": 0, "height": 0, "video_duration": 0, "accessibility_caption": "string", "image_versions": [ { "url": "string", "width": 0, "height": 0 } ], "video_versions": [ { "url": "string", "width": 0, "height": 0, "type": 0 } ], "has_audio": true, "video_dash_manifest": "string", "number_of_qualities": 0, "carousel_parent_id": "string", "user_tags": [ { "user": { "id": "string", "username": "string", "full_name": "string", "profile_pic_url": "string", "is_private": true, "is_verified": true, "profile_pic_id": "string", "latest_reel_media": 0, "is_mentionable": true }, "position": [ 0 ] } ] } ], "caption_id": "string", "caption_created_at": 0, "caption_is_edited": true, "caption_has_translation": true, "product_type": "string", "play_count": 0, "comments_disabled": true, "like_and_view_counts_disabled": true, "is_paid_partnership": true, "coauthors": [ { "id": "string", "username": "string", "full_name": "string", "profile_pic_url": "string", "is_private": true, "is_verified": true, "profile_pic_id": "string", "latest_reel_media": 0, "is_mentionable": true } ], "pinned_user_ids": [ "string" ], "carousel_media_count": 0, "location": { "id": "string", "name": "string", "slug": "string", "url": "string", "latitude": 0, "longitude": 0, "category": "string", "posts_count": 0, "address": "string", "city": "string", "postal_code": "string", "phone": "string", "price_range": 0, "hours_status": "string" }, "audio": { "id": "string", "url": "string", "type": "string", "title": "string", "artist": "string" }, "shares": 0, "reposts": 0, "top_likers": [ "string" ], "ai_label": { "text": "string", "detection_method": "string", "is_self_disclosed": true } } ] }}What can you build with the Instagram Hashtag Posts API?
Monitor campaigns
Collect every new post using your campaign hashtag.
Find creators
See which accounts get top posts for a niche hashtag.
Track trends
Compare engagement on the top posts of a hashtag over time.
Instagram Hashtag Posts API questions
How do I get the newest posts for a hashtag?
Set tab to "recent". Use "top" for Instagram’s top posts and "reels" for Reels only.
How do I use the Instagram Hashtag Posts API?
Send a POST request to https://api.bridgly.app/instagram/hashtag-posts with hashtag in the JSON body and your API key in the Authorization header. In the TypeScript SDK, call client.instagram.getHashtagPosts(). AI agents connected to Bridgly over MCP can call the instagram_hashtag_posts tool.
How much does the Instagram Hashtag Posts API cost?
Costs 1 credit per request. Credits cost $2.00 per 1,000 on pay-as-you-go and as low as $1.67 per 1,000 at volume. New accounts on a business email start with 100 free credits, and failed requests are never charged.
More Instagram endpoints
The same API key works on every endpoint. See all Instagram API endpoints.
- Instagram Tagged Posts API→List public posts tagging an Instagram account, with captions, media links, likes, comments and owner details as paginated JSON.
- Instagram Location Posts API→List posts Instagram associates with a location, including captions, image and video URLs, publish times and engagement counts.
- Instagram Posts API→Instagram posts API: list any public account’s posts and reels by username, with caption, likes, comments, views, media URLs and publish time, as JSON.
- Instagram Audio API→Get an Instagram Reels song or original sound as JSON: title, artist, length, cover image, audio file, trending flag and the number of Reels using it.
Try the Instagram Hashtag Posts API
100 free credits on business email, no card. Your first call takes a minute.