tiktok · fetchsolari:readWorks with any signed-in SOLARI account.
solari fetch tiktok account
Ingest one TikTok handle into the catalog.
- MCP tool
- solari_fetch_tiktok_account
- CLI
- solari fetch tiktok account
- Access
- solari:readWorks with any signed-in SOLARI account.Works with any signed-in SOLARI account.
- Required plan
- Free
- Credit
- 0
Overview
Add one TikTok account to the SOLARI catalog by exact username. This is not a search. If it is already stored, nothing is scraped.
When to use it — When catalog search does not know an exact handle you already have.
What comes back — Whether it was ingested, the account_id, and the catalog command to read it.
Parameters
- usernamestringrequired
- TikTok username.≤ 64 chars
Response
Response
- ingestedboolean
- true if this call collected it live.
- already_trackedboolean
- true if it was already in the catalog.
- fetched_on_demandboolean
- Same as ingested.
- account_iduuid
- The ingested account.
- usernamestring
- Resolved handle.
- notestring
- What to expect next.
- nextstring
- Catalog command to read the result.
Example
Request
$ solari fetch tiktok account username=innisfree_officialResponse · Long strings and repeated array entries are trimmed for readability.
{
"ingested": false,
"already_tracked": true,
"fetched_on_demand": false,
"account_id": "01a0631e-f0df-7e9d-a09b-d84bc31d3834",
"username": "innisfree_official",
"note": "Already in the SOLARI catalog. Nothing was scraped.",
"next": "solari catalog tiktok account profile username=innisfree_official"
}As an MCP call
{
"name": "solari_fetch_tiktok_account",
"arguments": {
"username": "innisfree_official"
}
}Notes
- Do not use this to search a name. Use catalog account search first.
- A first-time ingest can take 10 to 40 seconds. Only recent posts exist until the crawl finishes.
Related tools
- solari_catalog_tiktok_account_searchFind TikTok users by username or name. Use this to get an account_id.
- solari_catalog_tiktok_account_profileA TikTok account's profile and recent posts.
- solari_fetch_tiktok_postsCollect one TikTok account's posts into the catalog.
Machine-readable: /docs/tools/fetch-tiktok-account.md