# solari catalog tiktok account search

> Find tracked TikTok accounts 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`
- **Plans**: Free Trial · Plus · Pro · Enterprise
- **Credit**: 1

Look up a brand or creator among the TikTok accounts SOLARI already tracks, by username or display name. The TikTok catalog is small, so start with fetch tiktok account search. Instagram account_ids will not work here.

**When to use it** — When the account is already tracked and you need its account_id. For a new name, start with fetch tiktok account search.

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

## Parameters

- `query` (string, required) — Name or TikTok username.
- `limit` (integer, optional, default 8, 1–50) — 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. Find them with fetch tiktok account search, or 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://clip-pub.bzine.co/docs/tools/catalog-tiktok-account-profile.md)
- [`solari_catalog_tiktok_account_posts`](https://clip-pub.bzine.co/docs/tools/catalog-tiktok-account-posts.md)
- [`solari_catalog_instagram_account_search`](https://clip-pub.bzine.co/docs/tools/catalog-instagram-account-search.md)