for agents
← All tools
tiktok · catalog · contentsolari:read

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:read
Plans
  • Free Trial
  • Plus
  • Pro
  • Enterprise
Credit
1

Overview

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

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

What comes back — The 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. In account posts and content batch, 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 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.

Related tools

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