# solari fetch threads account search

> Find Threads accounts by name, live.

- **CLI**: `solari fetch threads account search`
- **MCP tool**: `solari_fetch_threads_account_search`
- **Access**: `solari:read` — Available on any SOLARI plan, including the trial. One credit per successful call.
- **Plans**: Any paid plan or trial
- **Credit**: 1

Ask Threads itself for accounts matching a name or handle fragment. Hits are thin: handle, display name, verified badge, profile picture, and URL, in Threads' own order. Threads has no catalog, so this is its only account search; nothing is stored and no account_id is issued. Pick a hit, then fetch threads account reads its full profile.

**When to use it** — When you know a name or part of a handle but not the exact Threads handle.

**What comes back** — Up to limit candidates in Threads' order, and the fetch command to read the first one's profile.

## Parameters

- `query` (string, required, ≤ 100 chars) — Name or handle fragment, with or without @.
- `limit` (integer, optional, ≥ 1) — How many hits, at most.

## Response

### `Response`

- `query` (string) — The text the lookup ran on, without @.
- `items` (object[]) — Matching accounts, Threads' order.
- `total` (integer) — Hits returned.
- `next` (string) — Fetch command to read the first hit's profile. Only when there is a hit.

### `items[]`

- `username` (string) — Handle, lowercase, without the @.
- `full_name` (string | null) — Display name.
- `is_verified` (boolean | null) — Verified badge.
- `profile_pic_url` (string | null) — Profile picture URL.
- `url` (string | null) — Public profile URL.

## Example

```console
$ solari fetch threads account search query=nike limit=1
```

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

```json
{
  "query": "nike",
  "items": [
    {
      "username": "nike",
      "full_name": "Nike",
      "is_verified": true,
      "profile_pic_url": "https://scontent-gmp1-1.cdninstagram.com/v/t51.2885-19/467733497_2299328197118830_1129133478722126916_n.jpg?…",
      "url": "https://www.threads.com/@nike"
    }
  ],
  "total": 1,
  "next": "solari fetch threads account username=nike"
}
```

## As an MCP call

```json
{
  "name": "solari_fetch_threads_account_search",
  "arguments": {
    "query": "nike",
    "limit": 1
  }
}
```

## Notes

- Order and ranking are Threads' own, so the official account is not always first: check is_verified and full_name before choosing.
- Nothing is stored and hits carry no account_id. fetch threads account with the chosen username reads follower count, bio, and bio links; fetch threads posts reads its posts.
- Every call asks Threads live, takes a second or two, is not cached, and costs 1 credit. An empty items list means Threads matched nothing.

## Related tools

- [`solari_fetch_threads_account`](https://solari.sh/docs/tools/fetch-threads-account.md)
- [`solari_fetch_threads_posts`](https://solari.sh/docs/tools/fetch-threads-posts.md)
- [`solari_fetch_threads_post_search`](https://solari.sh/docs/tools/fetch-threads-post-search.md)