# solari catalog tiktok account search

> Find TikTok users by username or name. Use this to get an account_id.

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

Search TikTok for a brand or creator by username or display name. Instagram account_ids will not work here.

**When to use it** — When you have a TikTok name or username, and not an account_id yet.

**What comes back** — Matching accounts, closest first.

## Parameters

- `query` (string, required) — Name or TikTok username.
- `limit` (integer, optional, ≥ 1) — How many accounts to return.
- `region` (string, optional, ≤ 8 chars) — Country code such as KR or JP. Leave this off to search everywhere.

## Response

### `Response`

- `found` (boolean) — Whether anyone matched.
- `items` (object[]) — Accounts that matched, closest first.

### `items[]`

- `account_id` (uuid) — TikTok account_id. Not interchangeable with Instagram.
- `username` (string) — TikTok username.
- `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 catalog 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_catalog_tiktok_account_search",
  "arguments": {
    "query": "innisfree",
    "limit": 5
  }
}
```

## Notes

- region keeps only the specified country, and drops accounts with no region. Leave it off unless you need one.
- Usernames SOLARI has not seen yet will not show up here. Pass an exact handle to solari fetch tiktok account, then read it with catalog tiktok account profile.

## Related tools

- [`solari_catalog_tiktok_account_profile`](https://solari.sh/docs/tools/catalog-tiktok-account-profile.md)
- [`solari_catalog_tiktok_account_posts`](https://solari.sh/docs/tools/catalog-tiktok-account-posts.md)
- [`solari_catalog_instagram_account_search`](https://solari.sh/docs/tools/catalog-instagram-account-search.md)