# solari fetch instagram account search

> Find accounts on Instagram by name, live.

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

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

- `query` (string, required, ≤ 100 chars) — Name or handle fragment, with or without @.

## Response

### `Response`

- `query` (string) — The text the lookup ran on, without @.
- `items` (object[]) — Matching accounts, Instagram's order.
- `found` (integer) — Accounts returned.
- `tracked` (integer) — How many carry an account_id.

### `items[]`

- `username` (string) — Handle, lowercased.
- `full_name` (string | null) — Display name.
- `is_verified` (boolean) — Verified badge.
- `is_private` (boolean) — Private account.
- `profile_picture_url` (string | null) — Profile picture URL.
- `account_id` (uuid | null) — SOLARI account id if already tracked; null means ingest it with fetch instagram account first.

## Example

```console
$ solari fetch instagram account search query=innisfree
```

_Long strings and repeated array entries are trimmed for readability._

```json
{
  "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

```json
{
  "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

- [`solari_catalog_instagram_account_search`](https://solari.sh/docs/tools/catalog-instagram-account-search.md)
- [`solari_fetch_instagram_account`](https://solari.sh/docs/tools/fetch-instagram-account.md)
- [`solari_catalog_instagram_account_profile`](https://solari.sh/docs/tools/catalog-instagram-account-profile.md)