All tools
tiktok · accountsolari:readWorks with any signed-in SOLARI account.

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 itGoing deeper than the profile preview, or narrowing by date range and format.

What comes backPosts, 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.Valuesvideocarousel
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=2

Response · 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.

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