# solari fetch tiktok account search

> Find TikTok accounts by name, live.

- **CLI**: `solari fetch tiktok account search`
- **MCP tool**: `solari_fetch_tiktok_account_search`
- **Access**: `solari:read`
- **Plans**: Free Trial · Plus · Pro · Enterprise
- **Credit**: 1

Ask TikTok itself for accounts matching a name or handle fragment. Hits are thin: handle, display name, bio, verified badge, follower count, profile picture, and URL, in TikTok's own order. Hits already in the catalog carry account_id; for the rest, fetch tiktok account adds the one you pick.

**When to use it** — When catalog account search does not know a name, or you know a name but not the exact TikTok handle.

**What comes back** — Up to limit candidates in TikTok's order, a cursor for the next page, and the command to read or add the first one.

## Parameters

- `query` (string, required, ≤ 100 chars) — Name or handle fragment, with or without @.
- `limit` (integer, optional, default 10, 1–30) — How many hits per page, at most.
- `cursor` (string, optional, ≤ 1024 chars) — next_cursor from the previous page of the same query. Leave it out for the first page.

## Response

### `Response`

- `query` (string) — The text the lookup ran on, without @.
- `items` (object[]) — Matching accounts, TikTok's order.
- `total` (integer) — Hits on this page.
- `has_more` (boolean) — true when TikTok has another page.
- `next_cursor` (string | null) — Pass it back as cursor with the same query. Null on the last page.
- `next` (string) — Command for the first hit: its catalog profile when it is already collected, else fetch tiktok account. Only when there is a hit.

### `items[]`

- `username` (string) — Handle, without the @.
- `nickname` (string | null) — Display name.
- `bio` (string | null) — Bio text.
- `is_verified` (boolean | null) — Verified badge.
- `follower_count` (integer | null) — Followers, as TikTok reports them now.
- `profile_pic_url` (string | null) — Profile picture URL.
- `url` (string) — Public profile URL.
- `account_id` (uuid | null) — TikTok account_id when the account is already in the catalog, else null.

## Example

```console
$ solari fetch tiktok account search query=innisfree limit=1
```

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

```json
{
  "query": "innisfree",
  "items": [
    {
      "username": "innisfree_official",
      "nickname": "Innisfreeofficial",
      "bio": "NATURE MEETS KOREAN SKIN SCIENCE",
      "is_verified": true,
      "follower_count": 143900,
      "profile_pic_url": "https://p16-common-sign.tiktokcdn-eu.com/tos-alisg-avt-0068/3f8e48dc4a284a8ead37e93175ebdb86~tplv-tiktokx-cropcenter:720:720.jpeg?…",
      "url": "https://www.tiktok.com/@innisfree_official",
      "account_id": "019b2137-f76e-7b33-9437-26044fa7b1ed"
    }
  ],
  "total": 1,
  "has_more": true,
  "next_cursor": "eyJjIjoiMSIsInMiOiIyMDI2MDkyOTA2NDMxMkE3QzRFMTlCMkQzRjVBOEM2RTAxIn0",
  "next": "solari catalog tiktok account profile username=innisfree_official"
}
```

## As an MCP call

```json
{
  "name": "solari_fetch_tiktok_account_search",
  "arguments": {
    "query": "innisfree",
    "limit": 1
  }
}
```

## Notes

- Order and ranking are TikTok's own, so the official account is not always first: check is_verified and follower_count before choosing.
- Nothing is stored. A hit with account_id is already in the catalog, so the catalog tiktok tools read it. For a hit without one, fetch tiktok account with its username adds it.
- When has_more is true, pass next_cursor as cursor with the same query for the next page. A cursor does not carry over to another query.
- Every call asks TikTok live, takes a few seconds, and is not cached. An empty items list means TikTok matched nothing.

## Related tools

- [`solari_fetch_tiktok_account`](https://pub.brandazine.ai/docs/tools/fetch-tiktok-account.md)
- [`solari_catalog_tiktok_account_search`](https://pub.brandazine.ai/docs/tools/catalog-tiktok-account-search.md)
- [`solari_catalog_tiktok_account_profile`](https://pub.brandazine.ai/docs/tools/catalog-tiktok-account-profile.md)
- [`solari_fetch_tiktok_post_search`](https://pub.brandazine.ai/docs/tools/fetch-tiktok-post-search.md)