← すべてのツール
tiktok · catalog · contentsolari:read

solari catalog tiktok content batch

複数の TikTok 投稿をまとめて取得。

MCP ツール
solari_catalog_tiktok_content_batch
CLI
solari catalog tiktok content batch
アクセス権
solari:read
対象プラン
  • 無料トライアル
  • Plus
  • Pro
  • Enterprise
クレジット
1

概要

TikTok の投稿 ID のリストから、キャプションと指標をまとめて取得します。見つからない ID はスキップされます。

どんなときに使うか — 検索やアカウントの投稿一覧で得た ID を、まとめて取得したいとき。

返される内容 — 見つかった投稿。

パラメータ

post_idsuuid[]必須
取得する TikTok の投稿 ID(最大 100 件)。1–100 items, uuid
sortenum任意
新しい順、またはエンゲージメント順。既定値 "recent"値recentengagement
include_transcriptboolean任意
動画の文字起こしを含めます。既定値 false

レスポンス

Response

requestedinteger
送信した ID の件数。
foundinteger
見つかった件数。
itemsobject[]
見つかった投稿。

items[]

post_iduuid
TikTok の投稿 ID。Instagram の投稿 ID とは別物です。
video_idstring
TikTok の URL に含まれる公開の数値 ID。
urlstring
公開パーマリンク。
account_iduuid
投稿者の account_id。
usernamestring
投稿者のユーザー名。
post_typestring
video または carousel。
posted_attimestamp
投稿日時(UTC)。
captionstring
キャプション。
duration_secondsinteger
動画の長さ。
width / heightinteger
解像度。
play_countinteger
再生数。
like_countinteger
いいね数。
comment_countinteger
コメント数。
share_countinteger
シェア数。
collect_countinteger
保存数。
is_adboolean
TikTok の広告フラグ。
is_pinnedboolean
プロフィールに固定されているかどうか。
aigc_label_typestring | null
AI 生成コンテンツのラベル(TikTok が付けている場合)。
original_language_codestring | null
元の言語。
cover_urlstring
カバー画像の URL。
video_urlstring
動画ファイルの URL。
imagesstring[]
カルーセルの各スライド。動画の場合は空です。
hashtagsstring[]
キャプション内のハッシュタグ。
mentionsstring[]
キャプションでメンションされているユーザー名。
transcriptstring | null
動画の文字起こし。account posts と content batch では include_transcript=true のときだけ返ります。
assetsobject[]
メディアファイル(掲載順)。それぞれに asset_url、media_type、video_duration があります。
assets[].asset_urlstring | null
フルサイズの画像または動画の直接ダウンロードリンク。ファイルが保存されていない場合は null。

例

リクエスト

$ solari catalog tiktok content batch post_ids='["01a0631e-f0df-7e9d-a09b-d84bc31d3834"]'

レスポンス · 読みやすさのため、長い文字列と繰り返しの配列要素を省略しています。

{
  "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
    }
  ]
}

MCP で呼び出す場合

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

注意点

  • SOLARI の投稿 ID のみ受け付けます。数値の動画 ID は content detail に video_id として渡してください。
  • TikTok の投稿 ID と Instagram の投稿 ID は別物で、互いに使えません。

機械可読な形式: /docs/tools/catalog-tiktok-content-batch.md