← All tools
instagram · fetch · accountsolari:readWorks with any signed-in SOLARI account.

solari fetch instagram account search

Find accounts on Instagram by name, live.

MCP tool
solari_fetch_instagram_account_search
CLI
solari fetch instagram account search
Access
solari:readWorks with any signed-in SOLARI account.Works with any signed-in SOLARI account.
Required plan
Free
Credit
0

Overview

Ask Instagram itself for accounts matching a name or handle fragment. Catalog account search only knows tracked accounts; this finds the rest and tells you which ones are already tracked.

When to use it — When catalog account search returns nothing for a name, or you need the exact handle before ingesting it.

What comes back — Up to 50 accounts in Instagram's order, with account_id on the ones already in the catalog.

Parameters

querystringrequired
Name or handle fragment, with or without @.≤ 100 chars

Response

Response

querystring
The text the lookup ran on, without @.
itemsobject[]
Matching accounts, Instagram's order.
foundinteger
Accounts returned.
trackedinteger
How many carry an account_id.

items[]

usernamestring
Handle, lowercased.
full_namestring | null
Display name.
is_verifiedboolean
Verified badge.
is_privateboolean
Private account.
profile_picture_urlstring | null
Profile picture URL.
account_iduuid | null
SOLARI account id if already tracked; null means ingest it with fetch instagram account first.

Example

Request

$ solari fetch instagram account search query=innisfree

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

{
  "query": "innisfree",
  "items": [
    {
      "username": "innisfreeofficial",
      "full_name": "innisfree official",
      "is_verified": true,
      "is_private": false,
      "profile_picture_url": "https://scontent.cdninstagram.com/v/t51.2885-19/example.jpg",
      "account_id": "018cabce-14cc-7544-8890-7811ec33ef74"
    },
    {
      "username": "innisfree_jp",
      "full_name": "innisfree Japan",
      "is_verified": false,
      "is_private": false,
      "profile_picture_url": null,
      "account_id": null
    }
  ],
  "found": 2,
  "tracked": 1
}

As an MCP call

{
  "name": "solari_fetch_instagram_account_search",
  "arguments": {
    "query": "innisfree"
  }
}

Notes

  • Nothing is stored. To bring an untracked hit into the catalog, run fetch instagram account with its username.
  • Order and ranking are Instagram's, so the official account is not always first: check is_verified.
  • No follower counts here; read them with catalog account profile once the account is tracked.

Related tools

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