tiktok · catalog · accountsolari:read

solari catalog tiktok account posts

Posts from a TikTok account.

MCP tool: solari_catalog_tiktok_account_posts
CLI: solari catalog tiktok account posts
Access: solari:readWorks with any signed-in SOLARI account.Works with any signed-in SOLARI account.
Required plan: Free
Credit: 0

Overview

List a TikTok account's posts. Turn on include_transcript only when the spoken words matter.

When to use it — When you need more posts than the profile preview, or a date range or format.

What comes back — Posts, with transcripts when you ask for them.

Parameters

account_idstringoptional: Pass the TikTok account_id 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 username. Ignored when account_id is set.≤ 64 chars
limitintegeroptional: How many posts per page.≥ 1
offsetintegeroptional: How many posts to skip.default 0≥ 0
sincestringoptional: Only posts on or after this UTC date (YYYY-MM-DD).pattern ^\d{4}-\d{2}-\d{2}$
untilstringoptional: Only posts on or before this UTC date (YYYY-MM-DD).pattern ^\d{4}-\d{2}-\d{2}$
post_typeenumoptional: Limit to video or carousel.Valuesvideocarousel
include_transcriptbooleanoptional: Include spoken transcripts.default false

Response

foundboolean: false if the username is not on TikTok.
account_id / usernamestring: The resolved account.
totalinteger: Posts matching the filters.
has_moreboolean: Whether there is another page.
itemsobject[]: Posts, newest first.
fetched_on_demandboolean: true when only the most recent posts are available so far.

items[]

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.

Example

Request

$ solari catalog 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_catalog_tiktok_account_posts",
  "arguments": {
    "username": "innisfree_official",
    "limit": 2
  }
}

Notes

Transcripts are large, so include_transcript is off by default.
This reads the catalog only. If the username is missing, call solari fetch tiktok posts username=… then retry.

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

Overview

Parameters

Response

Example

Notes

Related tools