# solari tiktok account search

> Turn a brand or creator name into a TikTok account_id.

- **CLI**: `solari tiktok account search`
- **MCP tool**: `solari_tiktok_account_search`
- **Access**: `solari:read` — Works with any signed-in SOLARI account.

Resolves a brand/creator name or TikTok handle to candidate tracked TikTok accounts via fast deterministic index search, typeahead-style: matches handles by prefix and display nicknames by text match, 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 the other solari_tiktok_* tools take; a TikTok account_id is a different value from any Instagram account_id and the two are never interchangeable), username (the TikTok handle), nickname, follower_count, video_count, region, is_verified, is_private, is_commerce_user, commerce_user_category, and profile_url; found=false with empty items means nothing matched. The query must actually appear in the handle or nickname, so retry with the native spelling when a phonetic alias does not resolve. Leave region unset unless the user asked for one country: many tracked TikTok accounts carry no region, and a region filter drops them. A handle that is not tracked yet does not appear here; pass it straight to solari_tiktok_account_profile or solari_tiktok_account_posts, which fetch it live. Works with any signed-in SOLARI account.

**When to use it** — The first call for any TikTok question. An Instagram account_id will not work here.

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

## Parameters

- `query` (string, required) — Brand or creator name or TikTok handle to resolve.
- `limit` (integer, optional, ≥ 1) — Maximum candidates to return, default 8. Values above 50 are clamped to 50.
- `region` (string, optional, ≤ 8 chars) — Optional region code such as KR, JP, or US. Leave unset unless the user asked for one country: accounts with no known region are dropped when a region is set.

## Response

### `Response`

- `found` (boolean) — true when at least one candidate matched.
- `items` (object[]) — Candidates.

### `items[]`

- `account_id` (uuid) — TikTok account_id. Never interchangeable with an Instagram account_id, even for the same brand.
- `username` (string) — TikTok handle.
- `nickname` (string) — Display name.
- `follower_count / video_count` (integer) — Followers and videos.
- `region` (string | null) — Region code. Many tracked accounts carry none.
- `is_verified / is_private` (boolean) — Verification and privacy flags.
- `is_commerce_user` (boolean) — Whether this is a commerce account.
- `commerce_user_category` (string | null) — Commerce category, e.g. Beauty.
- `profile_url` (string) — Public profile URL.

## Example

```console
$ solari tiktok account search query=innisfree limit=5
```

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

```json
{
  "found": true,
  "items": [
    {
      "account_id": "019b2137-f76e-7b33-9437-26044fa7b1ed",
      "username": "innisfree_official",
      "nickname": "Innisfreeofficial",
      "follower_count": 143800,
      "video_count": 767,
      "region": "KR",
      "is_verified": true,
      "is_private": false,
      "is_commerce_user": true,
      "commerce_user_category": "Beauty",
      "profile_url": "https://www.tiktok.com/@innisfree_official"
    }
  ]
}
```

## As an MCP call

```json
{
  "name": "solari_tiktok_account_search",
  "arguments": {
    "query": "innisfree",
    "limit": 5
  }
}
```

## Notes

- Leave region unset unless the user asked for one country. Many tracked accounts have no region, and setting one drops them entirely.
- An untracked handle does not appear here. Pass it straight to tiktok account profile or tiktok account posts, which fetch it live.

## Related tools

- [`solari_tiktok_account_profile`](https://solari.sh/docs/tools/tiktok-account-profile.md)
- [`solari_tiktok_account_posts`](https://solari.sh/docs/tools/tiktok-account-posts.md)
- [`solari_instagram_account_search`](https://solari.sh/docs/tools/instagram-account-search.md)