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

solari catalog tiktok account search

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

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

Overview

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

querystringrequired
Name or TikTok username.
limitintegeroptional
How many accounts to return.≥ 1
regionstringoptional
Country code such as KR or JP. Leave this off to search everywhere.≤ 8 chars

Response

Response

foundboolean
Whether anyone matched.
itemsobject[]
Accounts that matched, closest first.

items[]

account_iduuid
TikTok account_id. Not interchangeable with Instagram.
usernamestring
TikTok username.
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 catalog 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_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

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