INSTAGRAM API

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
Terminal
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"
}'
[ REQUEST AND RESPONSE ]

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

200 OK · application/json
{
"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
}
}
]
}
}
[ USE CASES ]

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.

[ FAQ ]

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.

Try the Instagram Hashtag Posts API

100 free credits on business email, no card. Your first call takes a minute.

APIMCPSDKCLI
free credits

On business email signup. No credit card required.

Start free with 100 credits