← All tools
tiktok · fetchsolari:readAvailable on any SOLARI plan, including the trial. One credit per successful call.

solari fetch tiktok post

Collect one TikTok post by URL and get its author.

MCP tool
solari_fetch_tiktok_post
CLI
solari fetch tiktok post
Access
solari:readAvailable on any SOLARI plan, including the trial. One credit per successful call.Available on any SOLARI plan, including the trial. One credit per successful call.
Plans
Any paid plan or trial
Credit
1

Overview

Collect one TikTok post into the SOLARI catalog by its public URL, and learn who posted it. If the post is already stored, nothing is scraped.

When to use it — When you were given a post link, catalog content detail says item=null, and you do not know the author.

What comes back — Whether it was collected, the post with its author, and the fetch command to crawl that author.

Parameters

urlstringrequired
Public post URL, including vm.tiktok.com and vt.tiktok.com short links.≤ 512 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 TikTok has no public post at that URL.
post_iduuid
The stored post.
account_iduuid
The author's account.
usernamestring
The author's handle.
itemobject | null
The post, with assets.
notestring
What to expect next.
nextstring
Fetch command to crawl the author.

item

post_iduuid
TikTok post id. Not interchangeable with Instagram.
video_idstring
Public numeric id from the TikTok URL.
urlstring
Public permalink.
account_iduuid
Author account_id.
usernamestring
Author username.
post_typestring
video or carousel.
posted_attimestamp
Published at (UTC).
captionstring
Caption.
duration_secondsinteger
Video length.
width / heightinteger
Resolution.
play_countinteger
Plays.
like_countinteger
Likes.
comment_countinteger
Comments.
share_countinteger
Shares.
collect_countinteger
Saves.
is_adboolean
TikTok ad flag.
is_pinnedboolean
Pinned on the profile.
aigc_label_typestring | null
AI-content label, when TikTok sets one.
original_language_codestring | null
Source language.
cover_urlstring
Cover image URL.
video_urlstring
Video file URL.
imagesstring[]
Carousel slides. Empty for video.
hashtagsstring[]
Hashtags from the caption.
mentionsstring[]
Usernames mentioned in the caption.
transcriptstring | null
Spoken transcript. Only when include_transcript=true.
assetsobject[]
Media files in order. Each has asset_url, media_type, and video_duration.
assets[].asset_urlstring | null
Direct download link to the full-size image or video. Null when no file is stored.

Example

Request

$ solari fetch tiktok post url=https://www.tiktok.com/@innisfree_official/video/7680375687139642645

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

{
  "ingested": true,
  "already_tracked": false,
  "fetched_on_demand": true,
  "found": true,
  "post_id": "01a0631e-f0df-7e9d-a09b-d84bc31d3900",
  "account_id": "01a0631e-f0df-7e9d-a09b-d84bc31d3834",
  "username": "innisfree_official",
  "item": {
    "account_id": "01a0631e-f0df-7e9d-a09b-d84bc31d3834",
    "post_id": "01a0631e-f0df-7e9d-a09b-d84bc31d3900",
    "video_id": "7680375687139642645",
    "url": "https://www.tiktok.com/@innisfree_official/video/7680375687139642645",
    "username": "innisfree_official",
    "post_type": "video",
    "posted_at": "2026-09-01T09:00:00Z",
    "play_count": 12000,
    "like_count": 800
  },
  "note": "Collected live and stored now. The author is known by name only: run next to crawl their profile and posts.",
  "next": "solari fetch tiktok account username=innisfree_official"
}

As an MCP call

{
  "name": "solari_fetch_tiktok_post",
  "arguments": {
    "url": "https://www.tiktok.com/@innisfree_official/video/7680375687139642645"
  }
}

Notes

  • The author arrives as a name-only account. Run next (fetch tiktok account) to crawl their profile and posts.
  • A first-time collect takes a few seconds.

Related tools

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