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

solari catalog tiktok content batch

Several TikTok posts at once.

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

Overview

Load captions and metrics for a list of TikTok post ids. Ids that cannot be found are skipped.

When to use itWhen you have ids from search or account posts and want them together.

What comes backThe posts that were found.

Parameters

post_idsuuid[]required
TikTok post ids to load, up to 100.1–100 items, uuid
sortenumoptional
Order by newest, or by engagement.default "recent"Valuesrecentengagement
include_transcriptbooleanoptional
Include spoken transcripts.default false

Response

Response

requestedinteger
How many ids were sent.
foundinteger
How many resolved.
itemsobject[]
The posts found.

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 content batch post_ids='["01a0631e-f0df-7e9d-a09b-d84bc31d3834"]'

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

{
  "requested": 1,
  "found": 1,
  "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-b.bzine.co/tiktok/users/019b2137-f76e-7b33-9437-26044fa7b1ed/posts/01a0631e-f0df-7e9d-a09b-d84bc31d3834/medias/origin.mp4",
      "images": [],
      "hashtags": [],
      "mentions": [],
      "transcript": null
    }
  ]
}

As an MCP call

{
  "name": "solari_catalog_tiktok_content_batch",
  "arguments": {
    "post_ids": [
      "01a0631e-f0df-7e9d-a09b-d84bc31d3834"
    ]
  }
}

Notes

  • This takes SOLARI post ids only. A numeric video id goes to content detail as video_id.
  • TikTok post ids and Instagram post ids are not interchangeable.

Machine-readable: /docs/tools/catalog-tiktok-content-batch.md