← All tools
tiktok · accountsolari:readWorks with any signed-in SOLARI account.

solari tiktok account search

Turn a brand or creator name into a TikTok account_id.

MCP tool
solari_tiktok_account_search
CLI
solari tiktok account search
Access
solari:readWorks with any signed-in SOLARI account.Works with any signed-in SOLARI account.

Overview

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

querystringrequired
Brand or creator name or TikTok handle to resolve.
limitintegeroptional
Maximum candidates to return, default 8. Values above 50 are clamped to 50.≥ 1
regionstringoptional
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.≤ 8 chars

Response

Response

foundboolean
true when at least one candidate matched.
itemsobject[]
Candidates.

items[]

account_iduuid
TikTok account_id. Never interchangeable with an Instagram account_id, even for the same brand.
usernamestring
TikTok handle.
nicknamestring
Display name.
follower_count / video_countinteger
Followers and videos.
regionstring | null
Region code. Many tracked accounts carry none.
is_verified / is_privateboolean
Verification and privacy flags.
is_commerce_userboolean
Whether this is a commerce account.
commerce_user_categorystring | null
Commerce category, e.g. Beauty.
profile_urlstring
Public profile URL.

Example

Request

$ solari tiktok account search query=innisfree limit=5

Response · Long strings and repeated array entries are trimmed for readability.

{
  "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

{
  "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

Machine-readable: /docs/tools/tiktok-account-search.md