SocialToAIStart freeConsole

Instagram API

Posts, comments, accounts.

The Instagram API lets you search accounts and read post details, comments, account profiles and an account's posts, with no Instagram account or login. Calls cost 2 to 3 credits each (from $0.004); failed calls are free. Instagram does not give the author's follower count with a post, so that field is returned as null. Use it over HTTP with an API key, or through MCP from your AI client. Last tested 2026-11-19.

5 of 6actions available
From 2 creditsper call
92% fewer tokensfor your AI than the raw JSON (8 interfaces measured)

Last tested: Last updated:

POST/v1/search200 OK3 credits
platform: "instagram" · query: "nike" · type: "user"
@…·text removed from the sample
null followersnull followingnull posts
Always null here:biofollowersfollowingposts_count
pageNext pagecursor
billingThis call3 credits
Sample data1 of the 46 items recorded

5 actions.
Plus 1 only Instagram has.

Open a row to see its request. Its full parameters and response fields are on its own page.

ActionsCredits per call
SearchFind accounts by keyword: name./v1/search3 credits≈ $0.01$0.20 per 1,000 (up to 50 a page)
You send
platformquery
Instagram Search API: All parameters and response fields
Sign in to run3 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/search \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "platform": "instagram",    "query": "nike",    "type": "user"  }'
POST /v1/searchYour key goes in the Authorization header
DetailOne post by ID or link: text, author, likes, comment count, views and publish time./v1/detail2 credits≈ $0.0067
You send
platformid or url
include=transcriptthe transcript of the video2 credits
Instagram Detail API: All parameters and response fields
Sign in to run2 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/detail \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "platform": "instagram",    "id": "DeCPVhERA8e"  }'
POST /v1/detailYour key goes in the Authorization header
CommentsThe comments under one post: text, likes and time./v1/comments2 credits≈ $0.0067$0.45 per 1,000 (up to 15 a page)
You send
platformid or url
reply_ofthe replies under one comment2 credits
Instagram Comments API: All parameters and response fields
Sign in to run2 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/comments \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "platform": "instagram",    "id": "DeCPVhERA8e"  }'
POST /v1/commentsYour key goes in the Authorization header
User ProfileOne account: name, bio, followers and following./v1/user_profile2 credits≈ $0.0067
You send
platformusername
Instagram User Profile API: All parameters and response fields
Sign in to run2 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/user_profile \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "platform": "instagram",    "username": "nasa"  }'
POST /v1/user_profileYour key goes in the Authorization header
User PostsThe recent posts of one account./v1/user_posts2 credits≈ $0.0067$0.56 per 1,000 (up to 12 a page)
You send
platformusername+1 optional
Instagram User Posts API: All parameters and response fields
Sign in to run2 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/user_posts \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "platform": "instagram",    "username": "nasa"  }'
POST /v1/user_postsYour key goes in the Authorization header

Not offered on Instagram: trending.

Compared with TikTok: Instagram posts also give images but do not give author followers, shares or saves; its accounts do not give posts.

Only on Instagram · Content and accountsCredits per call
Hashtag postsGet a page of the newest Instagram posts under a hashtag, by its name, about 33 a page.instagram.hashtag_posts2 credits≈ $0.0067$0.19 per 1,000 (up to 35 a page)

Get a page of the newest Instagram posts under a hashtag, by its name, about 33 a page: caption, author's ID, like and comment counts, time posted, image.

id
Instagram hashtag posts API: All parameters and response fields
Sign in to run2 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/instagram.hashtag_posts \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "id": "nasa"  }'
POST /v1/call/instagram.hashtag_postsYour key goes in the Authorization header

What a whole job costs.

The jobHow it adds upCreditsAbout
Read 1,000 Instagram commentsusually 15 a page, 67 pages134 creditsabout $0.45
Backfill one Instagram account: a list of 200 posts and 20 in full17 list pages + 20 full reads74 creditsabout $0.25
Watch 1 Instagram account daily, at most a month12 credits × 31 days372 creditsabout $1.24

Priced at the $10 pack; larger purchases bring it down. A watch runs only while it is on, and you can pause it at any time. There is no subscription.

Or skip the parameters.
Just ask.

Connect SocialToAI once over MCP. Your AI picks the calls, and you see what each one cost.

You ask01

Read the comments on this Instagram post and tell me what people complain about.

Your AI calls
  • detailthe post you pasted2 credits
  • commentsfirst 3 pages6 credits
Total8 credits
You ask02

Find five Instagram accounts that post about camping coffee and show me what they posted lately.

Your AI calls
  • searchaccounts · “camping coffee”3 credits
  • user_posts5 accounts10 credits
Total13 credits
You ask03

How big is this Instagram account, and what has it posted lately?

Your AI calls
  • user_profilethe account you named2 credits
  • user_postsits latest page2 credits
Total4 credits

Instagram MCP Server

Same shape on every platform.
Learn it once.

A Instagram post and a Xiaohongshu note come back with the same field names. What a platform cannot give comes back as null.

Instagramdetail · 2 credits
{  "platform": "instagram",  "id": "…",  "ref": "…",  "approx": [],  "extra": {},  "type": "content",  "url": "https://example.com/…",  "format": "video",  "title": null,  "text": "…",  "published_at": "2026-10-03T14:10:18.000Z",  "author": {    "id": "…",    "username": "…",    "name": "…",    "verified": true,    "followers": null  },  "metrics": {    "likes": 221586,    "comments": 2299,    "shares": null,    "collects": null,    "views": 5610912,    "reposts": null  },  "images": ["https://example.com/…"],  "hashtags": [],  "is_pinned": null}
Null on Instagram:titleauthor.followersmetrics.sharesmetrics.collectsmetrics.repostsis_pinned
Xiaohongshudetail · 12 credits
{  "platform": "xiaohongshu",  "id": "…",  "ref": "…",  "approx": [],  "extra": {},  "type": "content",  "url": "https://example.com/…",  "format": "image",  "title": "…",  "text": "…",  "published_at": "2026-10-09T01:00:34.000Z",  "author": {    "id": "…",    "username": "…",    "name": "…",    "verified": null,    "followers": null  },  "metrics": {    "likes": 927,    "comments": 122,    "shares": 256,    "collects": 59,    "views": null,    "reposts": null  },  "images": ["https://example.com/…", "https://example.com/…"],  "hashtags": ["…", "…"],  "is_pinned": false}
Null on Xiaohongshu:author.verifiedauthor.followersmetrics.viewsmetrics.reposts
Sample dataThe fields are always there; only the values differ.

6 tools read Instagram.

All tools

Does Instagram have an official API?

Instagram's official API works through Business or Creator accounts. Besides an account's own data, it can read basic metadata and media of other professional accounts and search hashtags; serving accounts you don't manage needs App Review and Business Verification, and hashtag search needs App Review.

Source: Instagram's developer documentation, checked 2026-10-17.

Who can use itCostLimitsSource
Instagram Platform APIApps working through Business or Creator accounts.The overview states no price.Reads the account's own data, basic metadata and media of other professional accounts; serving accounts you don't manage needs App Review and Business Verification.developers.facebook.com, checked 2026-10-17
Hashtag searchApps approved in App Review for Instagram Public Content Access.The page states no price.At most 30 unique hashtags per account in a rolling 7 days; returns top or recent media for a hashtag.developers.facebook.com, checked 2026-10-29
SocialToAIAnyone with a key; no Instagram account of yours and no review.From 2 credits a call (≈$0.0067); failed calls are free.Publicly visible content only; up to 50 items a call.Pricing

1,000 posts here: about 84 instagram.user_posts calls (typically 12 a page), 168 credits, $0.56 at the first pack. Estimate your cost

Instagram official API: access, prices and limits

The same calls work on 17 more.

All platforms and prices

Your AI is one URL away
from all of social media.

100 credits on sign-up, no card needed