Submit a TikTok username and retrieve its collected video records after the collection task finishes
概要
TikTokのプロフィールページは、識別情報、視聴者規模、認証、連絡先の手がかりが混在しており、アカウント横断で比較しづらい構成です。このアプリは、それらの公開プロフィールを一貫した記録セットにまとめ、調査、提携、モニタリングの担当者が同じ識別子、指標、日時で作業できるようにします。
価値は結合されたプロフィールスナップショットにあります。表示名、アカウントID、公開URL、フォロワー数といいね数、公開設定と認証フラグ、自己紹介文、収集日時が、送信したユーザー名ごとに揃います。手作業でプロフィールを組み立てなくても、クリエイターの適格性確認、視聴者規模の比較、ウォッチリストの更新がしやすくなります。
データ説明
データは、送信した各ユーザー名に対応する公開TikTokプロフィールから取得します。ソースがプロフィールまたはデータなしマーカーを返すと、送信ユーザー名ごとに1件の記録が作られます。重複して送信されたユーザー名は収集ページをまたいで除かれます。視聴者数、自己紹介文、コマース属性、所在地、地域、日時はソース原文を保持し、値がない場合は空になることがあります。フォロワー数、フォロー数、フォロー中、いいね数、動画数は正規化した数値ではなくソース原文のままです。収集日時は推測したタイムゾーンを付けず、提供されたまま保存します。フォロー数とフォロー中は同じソース値になることがあり、自己紹介とイントロも同じ文を繰り返すことがあります。非公開、BAN済み、ログイン限定のアカウントは対象外です。
結果はどのような形か
各記録は、送信した1件のTikTokユーザー名について収集した公開プロフィールを表します。
| アカウント名 | アカウントID | プロフィールURL | 送信アカウント | データなし |
|---|---|---|---|---|
| Nio | 6893678385759912962 | https://www.tiktok.com/@niogitsune | niogitsune | いいえ |
| demo.account | はい |
その他の値には、アバターURL、自己紹介、バイオリンク、ビジネスID、コマース情報、収集日時、フォロワー数、フォロー数、フォロー中、メールあり、イントロ、言語、いいね数、所在地、非公開アカウント、地域、ソースキーワード、ユーザーステータス文、ユーザーステータス、認証済み、動画数、YouTube連携があります。
応用シーン
- ウォッチリスト全体でアカウント名、アカウントID、フォロワー数を比較し、提携候補を見極めます。
- すでに監視しているアカウントについて、プロフィールURL、バイオリンク、所在地、地域を並べて公開プレゼンスを整理します。
- いいね数や動画数を使う前に、データなしと送信アカウントを確認し、空の結果と使えるプロフィールを分けます。
- 非公開アカウント、認証済み、ユーザーステータスをアカウント名と合わせて読み、公開アカウントと制限アカウントを見分けます。
適用範囲と境界
1回の実行で1〜200件のTikTokユーザー名を受け取り、データがある場合はユーザー名ごとに最大1件の公開プロフィール記録を返します。
- 適している用途
- 特定のTikTokアカウントの最新公開プロフィールが必要なとき
- 表示されている視聴者規模、認証、公開設定、公開の連絡先手がかりを1件の記録で必要なとき
- 適さない用途
- アカウント単位のプロフィールではなく、動画、コメント、検索結果が必要なとき
- 収集対象のTikTokユーザー名がないとき
失敗時の処理
開発者が宣言した失敗時と再試行の動作です。連携時にはシステムプロンプトに含めることをおすすめします。
- 1プロフィールが返らない場合は、ユーザー名を確認し、アカウントが公開のままか確かめてください
- 2レート制限、一時的な利用不可、タイムアウトの後は時間をおいて再試行してください
- 3送信結果が不明なときは、重複タスクを作らないようすぐには再送信しないでください
- 4認証に失敗した場合は、実行環境に設定したAPI Keyを確認してください
入力
この App の呼び出しに必要なパラメータで、manifest.json の input.schema から生成されています。
- TikTokユーザー名一覧
items必須array<object>収集するTikTokユーザー名です。1〜200件を送信し、各項目にはユーザー名を1つ指定してください。件数最大 200 件例[{"account":"niogitsune"}]
出力
1 件のレコードのフィールド構造で、manifest.json の output.schema から生成されています。
- 送信アカウント
task_itemstringこの記録のために送信したユーザー名例niogitsune - データなし
no_databoolean送信したユーザー名で公開プロフィールが返らなかったかどうか例false - ソースキーワード
keywordstring収集アカウントに紐づくソースキーワード例niogitsune - アカウントID
account_idstringプロフィールとして返されたTikTokアカウント識別子例6893678385759912962
サンプルデータ
output.schema から生成したサンプルです。サンプル値のないフィールドには構造上のプレースホルダーを使用しています。
{
"task_item": "niogitsune",
"no_data": false,
"keyword": "niogitsune",
"account_id": "6893678385759912962",
"account_name": "Nio",
"account_avatar_url": "https://p16-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/447a24696d4a4decab543181ac90bdd5~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9640&refresh_token=724beb04&x-expires=1788069600&x-signature=YlUb%2BXGVJC8OkIjs2jyEWNIDTF8%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast8",
"account_signature": "Cosplayer, pop culture enthusiast, not a professional VA. Ko-Fi in bio 🫶",
"bio_link": "https://linktr.ee/niogitsune",
"biz_id": "niogitsune",
"commerce_user_info": "{\"commerceUser\":false,\"category\":null,\"categoryButton\":null}",
"crawl_time": "2026-08-28T14:42:15",
"fans_count": "27691",
"follow_count": "2648",
"following": "2648",
"heart_count": "1247162",
"intro": "Cosplayer, pop culture enthusiast, not a professional VA. Ko-Fi in bio 🫶",
"is_mail": false,
"is_private": false,
"is_verified": false,
"is_youtube": false,
"language": "en",
"location": "<location>",
"original_url": "https://www.tiktok.com/@niogitsune",
"publish_content_count": "126",
"region": "<region>",
"user_status": "0",
"user_status_text": "<user_status_text>"
}連携方法
この 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": {
"octoparse_datahub": {
"type": "http",
"url": "https://mcp-v2.octoparse.com?pin=hello_moto/tiktok-account-info",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}AI に設定を任せる
設定を手作業で編集したくない場合は、インストールプロンプトをコピーして任意の AI クライアントに貼り付けてください。AI が自分のやり方でセットアップを完了します(デフォルトではログインを案内し、API Key をチャットに送るよう求めることはありません)。
detail.access.mcp.composeHint
料金
返される件数にかかわらず、実行の送信 1 回ごとに課金されます。
正常に返されたレコードの件数に応じて課金されます。失敗した実行には課金されません。
複数の課金イベントはそれぞれ独立して累計されます。詳細は各項目をご覧ください。失敗した実行には課金されません。
Credits を確認今すぐ試す
パラメータを入力して実行してください。結果は実際の呼び出しによるものです。