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

solari fetch tiktok account search

Find TikTok accounts by name, live.

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

Overview

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

querystringrequired
Name or handle fragment, with or without @.≤ 100 chars
limitintegeroptional
How many hits per page, at most.default 101–30
cursorstringoptional
next_cursor from the previous page of the same query. Leave it out for the first page.≤ 1024 chars

Response

Response

querystring
The text the lookup ran on, without @.
itemsobject[]
Matching accounts, TikTok's order.
totalinteger
Hits on this page.
has_moreboolean
true when TikTok has another page.
next_cursorstring | null
Pass it back as cursor with the same query. Null on the last page.
nextstring
Command for the first hit: its catalog profile when it is already collected, else fetch tiktok account. Only when there is a hit.

items[]

usernamestring
Handle, without the @.
nicknamestring | null
Display name.
biostring | null
Bio text.
is_verifiedboolean | null
Verified badge.
follower_countinteger | null
Followers, as TikTok reports them now.
profile_pic_urlstring | null
Profile picture URL.
urlstring
Public profile URL.
account_iduuid | null
TikTok account_id when the account is already in the catalog, else null.

Example

Request

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

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

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

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

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