instagram · accountsolari:read

solari instagram account search

Turn a brand or creator name — or a phrase from a profile bio — into an Instagram account_id.

MCP tool: solari_instagram_account_search
CLI: solari instagram account search
Access: solari:readWorks with any signed-in SOLARI account.Works with any signed-in SOLARI account.

Overview

Resolves a brand/creator name or Instagram handle to candidate tracked accounts via fast deterministic index search — like a typeahead, all candidates are returned — and also searches profile bio text. query_type picks what the query is matched against: auto (default) matches handles by prefix and profile display names (Korean or English) by text match; username or full_name narrows to just one of those; bio runs a full-text search over profile bio text, which is how you discover accounts by what they say about themselves ("skincare", "협찬 문의", "コスメ") rather than by name. Ranked by match quality and follower count. Returns found plus items ordered best-first (items[0] is the top match), each with account_id (the SOLARI account UUID every other tool takes), username, full_name, biography, follower_count, region, is_verified, and profile_pic_url; found=false with empty items means nothing matched. In the name modes the query must actually appear in the handle or display name — phonetic aliases and abbreviations do not resolve, so retry with the native spelling (for example the English brand name). Set brands_only=true when resolving a brand name to filter out fan and meme accounts; pair it with query_type=bio to sweep a category of brands. Leave region unset unless the user asked for one country — it drops every account outside that region. Works with any signed-in SOLARI account. Use this first to resolve any entity mentioned by name.

When to use it — Call this first whenever the user names an entity. Every other Instagram tool takes the account_id it returns.

What comes back — Candidate accounts ordered best-first; items[0] is the top match.

Parameters

querystringrequired: Brand or creator name (Korean/English) or Instagram handle to resolve, or — with query_type=bio — the words to look for in profile bios.
query_typeenumoptional: Which text to match. auto = handle and display name together; username = handle only; full_name = display name only; bio = profile bio text.default "auto"Valuesautousernamefull_namebio
brands_onlybooleanoptional: Restrict matches to known brand accounts. Recommended when resolving a brand name.default false
limitintegeroptional: Maximum candidates to return, default 8. Values above 50 are clamped to 50.≥ 1
regionstringoptional: Optional region code such as KR, JP, or US. Leave unset unless the user asked for one country: it filters results to that region and drops the rest.≤ 8 chars

Response

foundboolean: true when at least one candidate matched.
itemsobject[]: Candidates, ranked by match quality then follower count.

items[]

account_iduuid: SOLARI account id — the value every other Instagram tool accepts.
usernamestring: Instagram handle.
full_namestring: Profile display name.
biographystring: Profile bio text.
follower_countinteger: Follower count at snapshot time.
regionstring: Region code.
is_verifiedboolean: Instagram verification badge.
profile_pic_urlstring: Profile picture URL.

Example

Request

$ solari instagram account search query=oliveyoung brands_only=true limit=5

Response · Long strings and repeated array entries are trimmed for readability.

{
  "found": true,
  "items": [
    {
      "account_id": "018cab6d-1648-7071-9734-c47a2be2fd19",
      "username": "oliveyoung_official",
      "full_name": "올리브영 OLIVE YOUNG",
      "biography": "ALL LIVE YOUNG 🫒\nALL LIVE BETTER @olivebetter.official",
      "follower_count": 1199628,
      "region": "KR",
      "is_verified": true,
      "profile_pic_url": "https://dcr.bzine.co/instagram/users/oliveyoung_official/profile-picture"
    },
    {
      "account_id": "018dc63c-31b5-740f-bde0-2c00931385e1",
      "username": "oliveyoung_global",
      "full_name": "OLIVE YOUNG Global",
      "biography": "Korea's No.1 Health & Beauty Store\n✈️ FREE SHIPPING on orders over $60",
      "follower_count": 535949,
      "region": "KR",
      "is_verified": true,
      "profile_pic_url": "https://dcr.bzine.co/instagram/users/oliveyoung_global/profile-picture"
    },
    {
      "account_id": "018cabcf-e60e-70af-95eb-eff777ce5195",
      "username": "oliveyoung_magazine",
      "full_name": "올리브영 매거진",
      "biography": "내 일상과 가까운 뷰티 매거진",
      "follower_count": 142316,
      "region": "KR",
      "is_verified": false,
      "profile_pic_url": "https://dcr.bzine.co/instagram/users/oliveyoung_magazine/profile-picture"
    },
    "… 2 more"
  ]
}

As an MCP call

{
  "name": "solari_instagram_account_search",
  "arguments": {
    "query": "oliveyoung",
    "brands_only": true,
    "limit": 5
  }
}

Notes

In the name modes the query has to actually appear in the handle or the display name. Phonetic aliases and abbreviations do not resolve — retry with the native spelling.
Set brands_only=true when resolving a brand name; it filters out fan and meme accounts.
query_type=bio searches profile bio text instead of names, so you can find accounts by what they say about themselves — "skincare", "협찬 문의", "コスメ". Korean, Japanese and Chinese bios match on substrings, so a query word does not have to be a separate word in the bio.
Bios are searchable for accounts SOLARI already tracks, and roughly one account in ten has no bio at all — treat bio search as discovery, not as an exhaustive census.
region filters results down to that region and drops every other account, so leave it unset unless the user asked for one country.

Machine-readable: /docs/tools/instagram-account-search.md

Overview

Parameters

Response

Example

Notes

Related tools