/v1/search"platform": "instagram"Instagram Search API
Find accounts by keyword.
Search Instagram accounts by keyword and get back name, as JSON over HTTP or from your AI client over MCP. A call to the Instagram Search API costs 3 credits ($0.006 to $0.01 depending on the pack), failed calls are free, and the response has the same format as every other call. Last tested 2026-11-19.
Last updated:
Daily watch: tell your AI “watch this daily” and this call runs by itself every day, sending only what is new: at most 93 credits a month, about $0.31. How to set it up
What you get from the Instagram Search API.
From a recorded answer.
A recorded call returned 46 items; here is the first, field by field. Names and text are removed from the sample; the numbers are as recorded.
Lighter for your AI: the same recorded data (46 items) is about 20,002 tokens as the platform's raw JSON and about 3,874 as this interface returns it, 80% fewer (measured 2026-11-06). How it was measured
| Field | In the recorded answer |
|---|---|
| username | removed from the sample |
| name | removed from the sample |
| url | removed from the sample |
| bio | null: Instagram cannot give it |
| verified | true |
| followers | null: Instagram cannot give it |
| following | null: Instagram cannot give it |
| posts_count | null: Instagram cannot give it |
3 credits a call (≈ $0.006–$0.01): about 1,000 calls for $10.
Instagram Search API: request and response
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" }'import osimport uuidimport requestsresponse = requests.post( "https://socialtoai.app/v1/search", headers={ "Authorization": f"Bearer {os.environ['SOCIALTOAI_API_KEY']}", # A new key for each request; the same one again retries it without paying twice. "Idempotency-Key": str(uuid.uuid4()), }, json={ "platform": "instagram", "query": "nike", "type": "user", },)print(response.json())# Connected over MCP? Ask in plain words.Find Instagram accounts about "nike".# Your AI calls the search tool with:{ "platform": "instagram", "query": "nike", "type": "user"}{ "platform": "instagram", "status": "ok", "items": [ { "platform": "instagram", "id": "…", "ref": "…", "approx": [], "extra": {}, "type": "account", "username": "…", "name": "…", "url": "https://example.com/…", "bio": null, "verified": true, "followers": null, "following": null, "posts_count": null } ], "unavailable": ["bio", "followers", "following", "posts_count"], "page": { "has_more": false }, "cost_credits": 3}null followersnull followingnull postsNames and text were removed from the sample; the numbers are as recorded.
Instagram Search API parameters.
3 parameters, all required.
Send them as a JSON body with POST. Your key goes in the Authorization header, never in the URL.
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| platform | string | Required | — | Always "instagram" on this page. |
| query | string | Required | — | Search terms |
| type | string | Required | — | "user": accounts instead of posts (3 credits)."user" |
Instagram Search API response fields.
What Instagram cannot give is marked.
| Field | Type | Meaning |
|---|---|---|
| items[].extra | object | What the platform gives of this item beyond the fields below, under the platform's own names (an IP location, a uid, a showcase flag); the interface's extra_fields says what each is. Empty when there is nothing more. Of a comment or a review, never who wrote it. |
| items[].username | string | The handle. |
| items[].name | string | The display name. |
| items[].url | string | A link to the profile. |
| items[].bio | stringalways null | The bio. |
| items[].verified | boolean | Whether the account is verified. |
| items[].followers | integeralways null | Follower count. |
| items[].following | integeralways null | How many accounts it follows. |
| items[].posts_count | integeralways null | How many posts it has published. |
nullFields Instagram cannot giveRead null as “Instagram did not give this”, not as zero. These are always null on this call:
bioThe bio.followersFollower count.followingHow many accounts it follows.posts_countHow many posts it has published.
Every item also has platform, id, ref, approx and type; the response around the items is the same on every call. Response format
Instagram Search API: paging and billing.
5 calls per second per key, 20 after a purchase; going over is not charged. Rate limits
A failed call costs 0 credits and is never retried on its own. Error codes
“Last tested” above is the last day a real call of this interface succeeded. Each call reads from the platform, and fetched_at in the answer is when it was read. The same request sent again with the same key within 5 minutes is a replay (replayed: true): 0 credits, and the answer as first read.
Once connected over MCP, these questions use the Instagram Search API.
Find Instagram accounts about "nike".
3 creditssearch {"platform":"instagram","query":"nike","type":"user"}
Give this to your AI.
Copy it into Claude or ChatGPT.
How to connectUse the SocialToAI MCP server (https://socialtoai.app/mcp) for this: Find Instagram accounts about "nike".Call the search tool with {"platform":"instagram","query":"nike","type":"user"}. Needed: query.It gives its first page only, up to 50 items, with no next page; each call costs 3 credits.Before you start, work out how many credits it will take in all and ask me; call it only after I agree.What usually comes next, with the ref or username it returns: user_profile (User Profile), user_posts (User Posts).If SocialToAI is not connected yet, tell me how to connect it; never ask me to paste a key into the chat.Answer with a link to every item you used, and tell me how many credits it cost.Paste it into a chat once SocialToAI is connected over MCP. There is no key in it: Claude and ChatGPT sign in, other clients send a key in a header.
These ready-made tools call it when they run.
find-creatorsCreators who make that content, with their size, recent posts and how well each fits
creator-cardTheir accounts on other platforms, the numbers on each, and how sure the match is
Work scenarios that use it.
creator-discoveryYour AI finds creators in a niche on one platform, with their size, their recent posts and how well each one fits, then reads a shortlisted creator's accounts across platforms.
The same call on other platforms.
All platforms and prices/v1/search{ "platform": "instagram", "query": "nike", "type": "user" }3 creditsper callRead next.
What its own API allows, who can use it and what it costs, with sources.
Let your AI read Instagram.