TikTok User Video List

概要

Want a structured list of videos associated with a TikTok user? Give it a TikTok username and a target collection count, and it returns the video records produced by the completed collection task, including content IDs, collection time, username, keyword type, and task metadata.

Data notes

The target count is a collection target rather than a strict cap, so the actual number of returned records may differ. Results are retrieved through the upstream service's paginated video-list endpoint. Fields that the upstream service cannot provide for a record may be empty, and task metadata indicates the source item and whether no data was found.

What the results look like

Each record represents one collected TikTok video:

Video content ID	Collection time	TikTok username	Keyword type	Task item	No data
7684177072012430612	2026-09-21T12:03:12	snaikseven	account	snaikseven	false

Use cases

Build a TikTok account content inventory using Video content ID and Collection time.
Compare account-level collection results using TikTok username and Keyword type.
Identify empty or unavailable account results with Task item and No data.

適用範囲と境界

One TikTok username per task; crawlNum is a target count rather than a strict cap, and results are retrieved in pages of up to 1,000 records.

適している用途
When you need a structured list of videos associated with a TikTok user account for analysis or monitoring.

適さない用途
When you need a synchronous single-video lookup or private account data that the upstream service cannot collect.

失敗時の処理

開発者が宣言した失敗時と再試行の動作です。連携時にはシステムプロンプトに含めることをおすすめします。

1If the task fails or expires, resubmit the same username after checking the account input.
2If fewer records than the target are returned, treat the result as the upstream collection outcome rather than retrying solely to force the target count.

入力

この App の呼び出しに必要なパラメータで、manifest.json の input.schema から生成されています。

TikTok usernameaccount必須string
TikTok username to collect videos from.
例snaikseven
Target video countcrawl_num任意integer
Target number of videos to collect. This is a target, not a strict upper limit; the actual returned count may differ.
例50

出力

1 件のレコードのフィールド構造で、manifest.json の output.schema から生成されています。

Video content IDcontent_idstring
Unique identifier of the TikTok video when available.
例7684177072012430612
Collection timecrawl_timestring
Time when the video record was collected, when available.
例2026-09-21T12:03:12
TikTok usernamekeywordstring
TikTok username associated with the collected record, when available.
例snaikseven
Keyword typekeyword_typestring
Type of the collection keyword reported by the upstream service.
例account

サンプルデータ

output.schema から生成したサンプルです。サンプル値のないフィールドには構造上のプレースホルダーを使用しています。

output.example

{
  "content_id": "7684177072012430612",
  "crawl_time": "2026-09-21T12:03:12",
  "keyword": "snaikseven",
  "keyword_type": "account",
  "task_meta": "<task_meta>"
}

連携方法

この App は MCP、API、SDK、ファイルエクスポートのいずれでも連携でき、どのチャネルも同じ能力と料金を共有します。すべてのリクエストは Authorization: Bearer ヘッダーで認証し、認証情報には API Key（長期有効。Data Hub コンソールで作成）を使用します。MCP クライアントは OAuth によるキー不要のログインにも対応しています。CLI や Skill など、さらに多くの連携方法も準備中です。この App は非同期で実行され、途中でキャンセルできます：キャンセル後、実行は停止します。納品済みのレコードは保持され、課金対象になります。

MCP（Model Context Protocol）を使うと、Claude や Cursor などの AI クライアントからこの App を直接呼び出せます。クライアントと認証方式を選び、下の設定をコピーしてください。

クライアント設定

Bearer の後の値を長期有効な API Key に置き換えてください。あらゆるクライアント、CI、ヘッドレス環境で利用できます。

mcpServers config

{
  "mcpServers": {
    "octoparse_datahub": {
      "type": "http",
      "url": "https://mcp-v2.octoparse.com?pin=hello_moto/tiktok-user-video-list",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

自分の API Keys を表示 →

AI に設定を任せる

設定を手作業で編集したくない場合は、インストールプロンプトをコピーして任意の AI クライアントに貼り付けてください。AI が自分のやり方でセットアップを完了します（プロンプトは AI があなたに API Key を尋ねる形になっているため、認証情報がチャット履歴や共有設定に残りません）。

detail.access.mcp.composeHint

料金

Submit one collection task

返される件数にかかわらず、実行の送信 1 回ごとに課金されます。

$0.0001/ 回

Return 35 video record

正常に返されたレコードの件数に応じて課金されます。失敗した実行には課金されません。 35 件を 1 つの課金単位とし、端数は 35 件に切り上げて課金されます。

$0.002/ 35 件

複数の課金イベントはそれぞれ独立して累計されます。詳細は各項目をご覧ください。失敗した実行には課金されません。

Credits を確認

今すぐ試す

パラメータを入力して実行してください。結果は実際の呼び出しによるものです。

サンプル

パラメータは送信前に input.schema で検証されます

TikTok usernameaccount*TikTok username to collect videos from.

Target video countcrawl_num（任意）Target number of videos to collect. This is a target, not a strict upper limit; the actual returned count may differ.

概要