for agents
← All tools
tiktok · catalog · accountsolari:read

solari catalog tiktok account search

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

Overview

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

querystringrequired
Name or TikTok username.
limitintegeroptional
How many accounts to return.default 81–50
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. 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

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