# Instagram Search Suggestions API. Accounts and hashtags matching your search. Accounts and hashtags matching a query. We handle the proxies, blocks and platform changes. [Get API key](https://socialtap.dev/signup/?next=%2Fplayground%2F%3Fendpoint%3Dinstagram.search_suggestions) ## Instagram Search Suggestions API at a glance Returns what Instagram's search box offers logged out for a query: the account with that exact username, then matching hashtags. The account has its user ID, display name, picture and verified badge, and each hashtag its exact post count and tag ID, in Instagram's order. Send words, a username or a hashtag, in any language. GET `/v1/instagram/search_suggestions` [Read the API reference](https://socialtap.dev/docs/reference/instagram/search_suggestions/index.md) - **1 credit** per page, $0.75–$1.97 per 1,000 pages - **9 typed fields** null when unknown - **56** accounts and hashtags per page, the exact account first, then Instagram's tag search ranking - **`query`** is all it needs, e.g. `nasa` ## Send one request. Get up to 56 accounts and hashtags back. Copy the request in your language, or hand it to your agent. Sign up for an API key and your first 100 credits are free. `$ npm install socialtap` `query = nasa` [Open in playground](https://socialtap.dev/playground/?endpoint=instagram.search_suggestions) cURL: ```shell curl 'https://socialtap.dev/v1/instagram/search_suggestions?query=nasa' \ -H "x-api-key: $SOCIALTAP_API_KEY" ``` TypeScript SDK: ```typescript import { SocialTap } from "socialtap"; const client = new SocialTap(); // apiKey defaults to process.env.SOCIALTAP_API_KEY const res = await client.instagram.searchSuggestions.list({ query: "nasa" }); console.log(res.data); console.log(res.credits.charged, res.meta.request_id); ``` Node.js (fetch): ```javascript const params = new URLSearchParams({ query: "nasa", }); const res = await fetch(`https://socialtap.dev/v1/instagram/search_suggestions?${params}`, { headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" }, }); const body = await res.json(); if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`); const { data, page, meta } = body; console.log(data, meta.credits_charged); ``` Python (requests): ```python import os import requests res = requests.get( "https://socialtap.dev/v1/instagram/search_suggestions", params={"query": "nasa"}, headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]}, ) body = res.json() if not res.ok: raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}") data, page, meta = body["data"], body["page"], body["meta"] print(data, meta["credits_charged"]) ``` Go (net/http): ```go package main import ( "encoding/json" "fmt" "log" "net/http" "net/url" "os" ) func main() { q := url.Values{} q.Set("query", "nasa") req, err := http.NewRequest("GET", "https://socialtap.dev/v1/instagram/search_suggestions?"+q.Encode(), nil) if err != nil { log.Fatal(err) } req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY")) res, err := http.DefaultClient.Do(req) if err != nil { log.Fatal(err) } defer res.Body.Close() var body struct { Data json.RawMessage `json:"data"` Page json.RawMessage `json:"page"` Meta map[string]any `json:"meta"` Error *struct { Code string `json:"code"` Message string `json:"message"` } `json:"error"` } if err := json.NewDecoder(res.Body).Decode(&body); err != nil { log.Fatal(err) } if body.Error != nil { log.Fatalf("%s: %s", body.Error.Code, body.Error.Message) } fmt.Println(string(body.Data), body.Meta["credits_charged"]) } ``` 200 OK: ```json { "data": [ { "approximate_fields": [], "hashtag": null, "platform": "instagram", "platform_specific": { "instagram": { "tag_id": null } }, "position": 0, "profile": { "avatar_url": "https://scontent-sea5-1.cdninstagram.com/v/t51.2885-19/29090066_159271188110124_1152068159029641216_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ig_cache_key=GBLhuwEsG5c225AAAAAAAADj9-wPbkULAAAB1501500j-ccb7-5&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBE…", "display_name": "NASA", "id": "528817151", "is_verified": true, "url": "https://www.instagram.com/nasa/", "username": "nasa" }, "text": "nasa", "type": "profile", "unknown_fields": [], "url": "https://www.instagram.com/nasa/" }, { "approximate_fields": [], "hashtag": { "id": "nasa", "metrics": { "post_count": 10161802 }, "name": "nasa", "url": "https://www.instagram.com/explore/tags/nasa/" }, "platform": "instagram", "platform_specific": { "instagram": { "tag_id": "17843701351037088" } }, "position": 1, "profile": null, "text": "#nasa", "type": "hashtag", "unknown_fields": [], "url": "https://www.instagram.com/explore/tags/nasa/" }, { "approximate_fields": [], "hashtag": { "id": "naša", "metrics": { "post_count": 30513 }, "name": "naša", "url": "https://www.instagram.com/explore/tags/na%C5%A1a/" }, "platform": "instagram", "platform_specific": { "instagram": { "tag_id": "17841557482094993" } }, "position": 2, "profile": null, "text": "#naša", "type": "hashtag", "unknown_fields": [], "url": "https://www.instagram.com/explore/tags/na%C5%A1a/" } ], "page": { "has_more": false, "next_cursor": null, "next_cursor_expires_at": null, "end_reason": "platform_limit" }, "meta": { "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f", "platform": "instagram", "source": "api", "is_cached": false, "credits_charged": 1, "latency_ms": 391, "fetched_at": "2026-10-25T12:00:00Z", "input": null, "credits_remaining": 9999, "client_request_id": null, "warnings": [] } } ``` Long arrays and strings are shortened here. Real responses are complete. ## One schema on 3 platforms. The [response reference](https://socialtap.dev/docs/reference/instagram/search_suggestions/index.md#response) lists every field, its type and when it is `null`. [See the full schema](https://socialtap.dev/resources/suggestion/index.md). - ### Null means unknown A field Instagram doesn't show is null, never zero or an empty string, so a real zero always means zero. - ### What it accepts What to search for, as typed into Instagram's search box: a name, a username or a word, in any language and any case (nasa, taylor swift, 料理). - ### Write one parser Instagram, TikTok and Google Ads Transparency Center answer in these fields, so the code that reads one reads them all. - **`platform`string**: Platform whose search box offers the suggestion. - **`text`string**: The suggestion as the platform shows it, whitespace-trimmed: the completed search for a query suggestion, the account's name for a profile one, the domain for a website one. - **`type`string**: query = a completed search to run; profile = an account (or community) the platform proposes, described in profile; hashtag = a hashtag, described in hashtag; website = a website the platform proposes: text is its domain (nike.com), as the platform's searches by website take it. New values may be added. - **`position`integer**: Zero-based rank of the suggestion in the list, counting every type: the platform's order (each endpoint's notes say how a list combining several of the platform's searches is ordered). - **`url`string**: Where the suggestion leads on the platform: the search results page for a query, the account's page for a profile, the hashtag's page for a hashtag, the platform's page for the website for a website. - **`profile`object**: The account a profile suggestion names; null for every other type. - **`hashtag`object**: The hashtag a hashtag suggestion names, keyed as the platform's hashtag endpoints key it; null for every other type. - **`approximate_fields`string\[\]**: JSON paths of values rounded or capped by the platform (hashtag.metrics.post_count at Instagram's ceiling). \[\] when all exact. Live data from 33 platforms. [TikTok](https://socialtap.dev/apis/tiktok/index.md) · [Instagram](https://socialtap.dev/apis/instagram/index.md) · [Facebook](https://socialtap.dev/apis/facebook/index.md) · [YouTube](https://socialtap.dev/apis/youtube/index.md) · [Reddit](https://socialtap.dev/apis/reddit/index.md) · [Threads](https://socialtap.dev/apis/threads/index.md) · [Spotify](https://socialtap.dev/apis/spotify/index.md) · [Amazon](https://socialtap.dev/apis/amazon/index.md) · [Apple Music](https://socialtap.dev/apis/applemusic/index.md) · [Pinterest](https://socialtap.dev/apis/pinterest/index.md) · [Rumble](https://socialtap.dev/apis/rumble/index.md) · [X](https://socialtap.dev/apis/x/index.md) · [Bluesky](https://socialtap.dev/apis/bluesky/index.md) · [Twitch](https://socialtap.dev/apis/twitch/index.md) · [LinkedIn](https://socialtap.dev/apis/linkedin/index.md) · [Telegram](https://socialtap.dev/apis/telegram/index.md) · [TikTok Shop](https://socialtap.dev/apis/tiktokshop/index.md) · [Kwai](https://socialtap.dev/apis/kwai/index.md) · [Snapchat](https://socialtap.dev/apis/snapchat/index.md) · [SoundCloud](https://socialtap.dev/apis/soundcloud/index.md) · [Truth Social](https://socialtap.dev/apis/truthsocial/index.md) · [Kick](https://socialtap.dev/apis/kick/index.md) · [Komi](https://socialtap.dev/apis/komi/index.md) · [Lnk.Bio](https://socialtap.dev/apis/linkbio/index.md) · [Linkme](https://socialtap.dev/apis/linkme/index.md) · [Linktree](https://socialtap.dev/apis/linktree/index.md) · [Pillar](https://socialtap.dev/apis/pillar/index.md) · [TikTok Ad Library](https://socialtap.dev/apis/tiktok-ad-library/index.md) · [Facebook Ad Library](https://socialtap.dev/apis/facebook-ad-library/index.md) · [Facebook Events](https://socialtap.dev/apis/facebook-events/index.md) · [Facebook Marketplace](https://socialtap.dev/apis/facebook-marketplace/index.md) · [Google Ads Transparency Center](https://socialtap.dev/apis/google-ads-transparency/index.md) · [LinkedIn Ad Library](https://socialtap.dev/apis/linkedin-ad-library/index.md) ## What teams build with the Instagram Search Suggestions API. - ### Check whether a brand has an Instagram account - ### Find a topic's hashtags with post counts - ### Resolve a username to its user ID - ### Build keyword lists for Instagram campaigns ## Good to know before you build. - Logged out, the account is only an exact username match, with spaces removed (taylor swift finds @taylorswift). Accounts that only resemble the query, and places, need a login. - A leading # searches hashtags only, and a leading @ looks up the account only. Case doesn't matter. - An age-restricted account, or one named like an Instagram page (@explore), isn't offered because Instagram doesn't show it logged out. - Instagram serves one list of suggestions, so page.end_reason is platform_limit. The Instagram Hashtag Search API pages further through hashtags. - A query Instagram withholds results for (a sensitive term) returns an empty page. - A hashtag's post_count at Instagram's ceiling (#love) is a lower bound, listed in approximate_fields. avatar_url is a CDN link that can expire. ## 1 credit per page. Failed requests are free. Buy credits once and spend them on any endpoint, on any platform. [Plans and packs](https://socialtap.dev/pricing/index.md) · [How this endpoint is priced](https://socialtap.dev/docs/reference/instagram/search_suggestions/index.md#pricing) · [How credits work](https://socialtap.dev/docs/credits/index.md) | Source | Price per successful page | Per 1,000 pages | | --- | --- | --- | | Platform API `api` | 1 credit | $0.75–$1.97 | - Cache hits are free. - Credits from packs and top-ups never expire. - A monthly plan's credits are spent first, and what is left of them ends at each renewal. - Prices exclude tax: sales tax is added at checkout where it applies. - Outside the US, plans and packs are sold to businesses: checkout asks for your VAT, GST or other business tax ID. ## Questions about the Instagram Search Suggestions API. More in the [API reference](https://socialtap.dev/docs/reference/instagram/search_suggestions/index.md). **How much does the Instagram Search Suggestions API cost?** A page of up to 56 accounts and hashtags costs 1 credit. Every successful page is charged, empty pages included. SocialTap credits cost $0.75–$1.97 per 1,000, depending on the plan or pack. **How do I get the next page?** Repeat the same request with cursor set to page.next_cursor from the previous response, keeping the other parameters. When page.has_more is false there are no more pages. Cursors expire after 24 hours. Other platforms ## Suggestions on 2 more platforms. - [TikTok Search Suggestions API](https://socialtap.dev/apis/tiktok/search_suggestions/index.md) (1 credit / page · `GET /v1/tiktok/search_suggestions`) - [Google Ads Transparency Center Search Suggestions API](https://socialtap.dev/apis/google/search_suggestions/index.md) (1 credit / page · `GET /v1/google/search_suggestions`) More Instagram ## Instagram API. 28 endpoints, one key. - [Instagram Post API](https://socialtap.dev/apis/instagram/post/index.md) (1 credit · `GET /v1/instagram/post`) - [Instagram Story API](https://socialtap.dev/apis/instagram/story/index.md) (1 credit · `GET /v1/instagram/story`) - [Instagram Posts API](https://socialtap.dev/apis/instagram/posts/index.md) (1 credit / page · `GET /v1/instagram/posts`) - [Instagram Reels API](https://socialtap.dev/apis/instagram/reels/index.md) (1 credit / page · `GET /v1/instagram/reels`) - [Instagram Search API](https://socialtap.dev/apis/instagram/search_posts/index.md) (1 credit / page · `GET /v1/instagram/search_posts`) - [Instagram Audio Reels API](https://socialtap.dev/apis/instagram/sound_posts/index.md) (1 credit / page · `GET /v1/instagram/sound_posts`) - [Instagram Hashtag Posts API](https://socialtap.dev/apis/instagram/hashtag_posts/index.md) (1 credit / page · `GET /v1/instagram/hashtag_posts`) - [Instagram Location Posts API](https://socialtap.dev/apis/instagram/place_posts/index.md) (1 credit / page · `GET /v1/instagram/place_posts`) - [Instagram Trending Reels API](https://socialtap.dev/apis/instagram/trending_posts/index.md) (1 credit / page · `GET /v1/instagram/trending_posts`) - [Instagram Highlight Stories API](https://socialtap.dev/apis/instagram/playlist_stories/index.md) (1 credit / page · `GET /v1/instagram/playlist_stories`) - [Instagram Profile API](https://socialtap.dev/apis/instagram/profile/index.md) (1 credit · `GET /v1/instagram/profile`) - [Instagram Similar Accounts API](https://socialtap.dev/apis/instagram/similar_profiles/index.md) (1 credit / page · `GET /v1/instagram/similar_profiles`) - [Instagram Comment API](https://socialtap.dev/apis/instagram/comment/index.md) (1 credit · `GET /v1/instagram/comment`) - [Instagram Comments API](https://socialtap.dev/apis/instagram/comments/index.md) (1 credit / page · `GET /v1/instagram/comments`) - [Instagram Reels Transcript API](https://socialtap.dev/apis/instagram/transcript/index.md) (From 1 credit · `GET /v1/instagram/transcript`) - [Instagram Hashtag API](https://socialtap.dev/apis/instagram/hashtag/index.md) (1 credit · `GET /v1/instagram/hashtag`) - [Instagram Hashtag Search API](https://socialtap.dev/apis/instagram/search_hashtags/index.md) (1 credit / page · `GET /v1/instagram/search_hashtags`) - [Instagram User Search API](https://socialtap.dev/apis/instagram/search_profiles/index.md) (From 1 credit / page · `GET /v1/instagram/search_profiles`) - [Instagram Audio Search API](https://socialtap.dev/apis/instagram/search_sounds/index.md) (From 1 credit / page · `GET /v1/instagram/search_sounds`) - [Instagram Location Search API](https://socialtap.dev/apis/instagram/search_places/index.md) (From 1 credit / page · `GET /v1/instagram/search_places`) - [Instagram Highlights API](https://socialtap.dev/apis/instagram/highlights/index.md) (1 credit / page · `GET /v1/instagram/highlights`) - [Instagram Engagement API](https://socialtap.dev/apis/instagram/engagement/index.md) (1 credit · `GET /v1/instagram/engagement`) - [Instagram Location API](https://socialtap.dev/apis/instagram/place/index.md) (1 credit · `GET /v1/instagram/place`) - [Instagram Audio API](https://socialtap.dev/apis/instagram/sound/index.md) (1 credit · `GET /v1/instagram/sound`) - [Instagram Topic API](https://socialtap.dev/apis/instagram/topic/index.md) (1 credit · `GET /v1/instagram/topic`) - [Instagram Embed API](https://socialtap.dev/apis/instagram/embed/index.md) (1 credit · `GET /v1/instagram/embed`) - [Instagram Username Availability API](https://socialtap.dev/apis/instagram/username/index.md) (1 credit · `GET /v1/instagram/username`) ## Try it with your own search. Type it in the playground, or copy the request into your code. 100free credits - No credit card - Failed requests are free - Works on all 218 endpoints [Start for free](https://socialtap.dev/signup/) [Read the docs](https://socialtap.dev/docs/index.md) --- [HTML version](https://socialtap.dev/apis/instagram/search_suggestions/) · [Docs index for AI agents](https://socialtap.dev/llms.txt) · [All docs in one file](https://socialtap.dev/llms-full.txt)