for agents
← All tools
tiktok · fetchsolari:read

solari fetch tiktok posts

Collect one TikTok account's posts into the catalog.

MCP tool
solari_fetch_tiktok_posts
CLI
solari fetch tiktok posts
Access
solari:read
Plans
  • Free Trial
  • Plus
  • Pro
  • Enterprise
Credit
1

Overview

Collect posts for one TikTok account into the SOLARI catalog by exact username. This is not a post listing. If the handle is already stored, nothing is scraped.

When to use it — When catalog posts does not know an exact handle you already have.

What comes back — Whether it was ingested, how many posts came back, and the catalog command to read them.

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.
foundboolean
false if the handle could not be collected.
account_iduuid
The ingested account.
usernamestring
Resolved handle.
totalinteger
Posts available so far.
notestring
What to expect next.
nextstring
Catalog command to read the result.

Example

Request

$ solari fetch tiktok posts username=innisfree_official

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

{
  "ingested": false,
  "already_tracked": true,
  "fetched_on_demand": false,
  "found": true,
  "account_id": "01a0631e-f0df-7e9d-a09b-d84bc31d3834",
  "username": "innisfree_official",
  "total": 12,
  "note": "Already in the SOLARI catalog. Nothing was scraped.",
  "next": "solari catalog tiktok account posts username=innisfree_official"
}

As an MCP call

{
  "name": "solari_fetch_tiktok_posts",
  "arguments": {
    "username": "innisfree_official"
  }
}

Notes

  • Do not use this to list stored posts. Use catalog tiktok account posts for that.
  • A first-time ingest can take 10 to 40 seconds. Only recent posts exist until the crawl finishes.

Related tools

Machine-readable: /docs/tools/fetch-tiktok-posts.md