# solari catalog tiktok content batch

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

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

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

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

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

## パラメータ

- `post_ids` (uuid[], 必須, 1–100 items, uuid) — 取得する TikTok の投稿 ID（最大 100 件）。
- `sort` (enum, 任意, 既定値 "recent") — 新しい順、またはエンゲージメント順。 値: `recent`, `engagement`.
- `include_transcript` (boolean, 任意, 既定値 false) — 動画の文字起こしを含めます。

## レスポンス

### `Response`

- `requested` (integer) — 送信した ID の件数。
- `found` (integer) — 見つかった件数。
- `items` (object[]) — 見つかった投稿。

### `items[]`

- `post_id` (uuid) — TikTok の投稿 ID。Instagram の投稿 ID とは別物です。
- `video_id` (string) — TikTok の URL に含まれる公開の数値 ID。
- `url` (string) — 公開パーマリンク。
- `account_id` (uuid) — 投稿者の account_id。
- `username` (string) — 投稿者のユーザー名。
- `post_type` (string) — video または carousel。
- `posted_at` (timestamp) — 投稿日時（UTC）。
- `caption` (string) — キャプション。
- `duration_seconds` (integer) — 動画の長さ。
- `width / height` (integer) — 解像度。
- `play_count` (integer) — 再生数。
- `like_count` (integer) — いいね数。
- `comment_count` (integer) — コメント数。
- `share_count` (integer) — シェア数。
- `collect_count` (integer) — 保存数。
- `is_ad` (boolean) — TikTok の広告フラグ。
- `is_pinned` (boolean) — プロフィールに固定されているかどうか。
- `aigc_label_type` (string | null) — AI 生成コンテンツのラベル（TikTok が付けている場合）。
- `original_language_code` (string | null) — 元の言語。
- `cover_url` (string) — カバー画像の URL。
- `video_url` (string) — 動画ファイルの URL。
- `images` (string[]) — カルーセルの各スライド。動画の場合は空です。
- `hashtags` (string[]) — キャプション内のハッシュタグ。
- `mentions` (string[]) — キャプションでメンションされているユーザー名。
- `transcript` (string | null) — 動画の文字起こし。account posts と content batch では include_transcript=true のときだけ返ります。
- `assets` (object[]) — メディアファイル（掲載順）。それぞれに asset_url、media_type、video_duration があります。
- `assets[].asset_url` (string | null) — フルサイズの画像または動画の直接ダウンロードリンク。ファイルが保存されていない場合は null。

## 例

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

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

```json
{
  "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 で呼び出す場合

```json
{
  "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 は別物で、互いに使えません。

## 関連ツール

- [`solari_catalog_tiktok_content_detail`](https://clip-pub.bzine.co/docs/tools/catalog-tiktok-content-detail.md?lang=ja)
- [`solari_catalog_tiktok_content_search`](https://clip-pub.bzine.co/docs/tools/catalog-tiktok-content-search.md?lang=ja)