solari tiktok account posts
Page through one TikTok account's posts, newest first.
- MCP tool
- solari_tiktok_account_posts
- CLI
- solari tiktok account posts
- Access
- solari:readWorks with any signed-in SOLARI account.Works with any signed-in SOLARI account.
Overview
Posts by one TikTok account, newest first, with pagination and filters. Identify the account by account_id (TikTok account UUID from solari_tiktok_account_search) or by username (TikTok handle). Each item has post_id (SOLARI post UUID), video_id (the public numeric TikTok id) and url, post_type (video or carousel), posted_at, caption, duration_seconds, play/like/comment/share/collect counts, is_ad, cover_url, images (carousel slides), hashtags, mentions, and transcript when include_transcript=true. Transcripts are long, so include_transcript is off by default; turn it on only when the spoken content matters. The response carries found, account_id, username, total, has_more, and items; page with limit and offset, narrow with since/until (UTC dates, inclusive) and post_type. A handle not tracked yet is fetched live on first request (allow 10 to 40 seconds), and fetched_on_demand=true marks that only its most recent posts are available until the background crawl lands; found=false means the handle does not exist on TikTok. Works with any signed-in SOLARI account.
When to use it — Going deeper than the profile preview, or narrowing by date range and format.
What comes back — Posts, optionally with spoken-word transcripts.
Parameters
- account_idstringoptional
- account_id of the TikTok account (SOLARI account UUID). Provide this or username.uuid, pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
- usernamestringoptional
- TikTok handle, with or without a leading @. Ignored when account_id is set.≤ 64 chars
- limitintegeroptional
- Posts per page, default 12. Values above 200 are clamped to 200.≥ 1
- offsetintegeroptional
- Pagination offset, default 0.default
0≥ 0 - sincestringoptional
- Only posts on or after this UTC date, YYYY-MM-DD inclusive.pattern ^\d{4}-\d{2}-\d{2}$
- untilstringoptional
- Only posts on or before this UTC date, YYYY-MM-DD inclusive.pattern ^\d{4}-\d{2}-\d{2}$
- post_typeenumoptional
- Only posts of this format. video is a single clip; carousel is an image slideshow.Values
videocarousel - include_transcriptbooleanoptional
- Attach the spoken-word transcript to each item. Off by default because transcripts are long.default
false
Response
Response
- foundboolean
- false means the handle does not exist on TikTok.
- account_id / usernamestring
- The resolved account.
- totalinteger
- Posts matching the filters.
- has_moreboolean
- Whether another page exists.
- itemsobject[]
- Posts, newest first.
- fetched_on_demandboolean
- true when only the most recent posts are available so far.
items[]
- post_iduuid
- SOLARI post id. A different namespace from Instagram post ids.
- video_idstring
- Public numeric TikTok id — the digits after /video/ or /photo/.
- urlstring
- Public TikTok permalink.
- account_iduuid
- TikTok account_id of the author.
- usernamestring
- Author handle.
- post_typestring
- video (single clip) or carousel (image slideshow).
- posted_attimestamp
- Publication time (UTC).
- captionstring
- Caption text.
- duration_secondsinteger
- Video length.
- width / heightinteger
- Video resolution.
- play_countinteger
- Plays.
- like_countinteger
- Likes.
- comment_countinteger
- Comments.
- share_countinteger
- Shares.
- collect_countinteger
- Saves.
- is_adboolean
- Whether TikTok flags the post as an ad.
- is_pinnedboolean
- Pinned to the top of the profile.
- aigc_label_typestring | null
- AI-generated-content label, when TikTok applies one.
- original_language_codestring | null
- Source language code.
- cover_urlstring
- Cover image URL.
- video_urlstring
- Video file URL.
- imagesstring[]
- Carousel slides. Empty for a video post.
- hashtagsstring[]
- Hashtags parsed from the caption.
- mentionsstring[]
- Handles mentioned in the caption.
- transcriptstring | null
- Spoken-word transcript. Only filled when include_transcript=true.
Example
Request
$ solari tiktok account posts username=innisfree_official limit=2Response · Long strings and repeated array entries are trimmed for readability.
{
"found": true,
"account_id": "019b2137-f76e-7b33-9437-26044fa7b1ed",
"username": "innisfree_official",
"total": 87,
"has_more": true,
"items": [
{
"post_id": "01a0631e-f0df-7e9d-a09b-d84bc31d3834",
"video_id": "7680375687139642645",
"url": "https://www.tiktok.com/@innisfree_official/video/7680375687139642645",
"account_id": "019b2137-f76e-7b33-9437-26044fa7b1ed",
"username": "innisfree_official",
"post_type": "video",
"posted_at": "2026-09-02T12:00:00Z",
"caption": "Deeply hydrated skin—NO OFF HOURS. 💚 wherever the day takes MINGYU—his hydration stays SUPERCHARGED ⚡️ Green Tea Ceramide Milk: Lightweight milky toner that won't clog your pores Green Tea Ceramide Mist: Touch-free, fa …",
"duration_seconds": 23,
"width": 1080,
"height": 1920,
"play_count": 493,
"like_count": 37,
"comment_count": 2,
"share_count": 0,
"collect_count": 3,
"is_ad": false,
"is_pinned": false,
"aigc_label_type": null,
"original_language_code": null,
"cover_url": "https://smr-images-b.bzine.co/tiktok/users/019b2137-f76e-7b33-9437-26044fa7b1ed/posts/01a0631e-f0df-7e9d-a09b-d84bc31d3834/medias/cover.jpg",
"video_url": "https://smr-images-a.bzine.co/tiktok/users/019b2137-f76e-7b33-9437-26044fa7b1ed/posts/01a0631e-f0df-7e9d-a09b-d84bc31d3834/medias/origin.mp4",
"images": [],
"hashtags": [],
"mentions": [],
"transcript": null
},
"… 1 more"
],
"fetched_on_demand": false
}As an MCP call
{
"name": "solari_tiktok_account_posts",
"arguments": {
"username": "innisfree_official",
"limit": 2
}
}Notes
- Transcripts are long, so include_transcript is off by default. Turn it on only when the spoken content matters.
- Up to 200 per page.
Related tools
- solari_tiktok_account_profileEverything SOLARI knows about one TikTok account.
- solari_tiktok_content_detailOne TikTok post in full.
- solari_instagram_account_postsPage through one account's posts, newest first.
Machine-readable: /docs/tools/tiktok-account-posts.md