概要
公開中のTwitter投稿詳細は、すでに把握している投稿について、本文、投稿者、エンゲージメントのスナップショット、メディア参照を一つにまとめます。このData Appは、Twitter投稿IDの一式を、確認・比較・補強・保存に使える一貫したレコードにします。
投稿を一つずつ開いて見える情報を手で写す代わりに、チームは結果を構造化された調査データとして使えます。投稿の候補リストが既にあり、次にメッセージ、投稿者の文脈、公開パターン、公開エンゲージメントを比べたいときに特に役立ちます。
データ説明
データは、指定した投稿IDに対する公開中のTwitter投稿詳細です。有効で重複排除された各投稿IDは、投稿IDで識別されるレコードを最大1件返します。無効、重複、削除、非公開、ログイン限定の投稿はレコードが返らない場合があります。
いいね数、コメント数、再生数、引用数、リツイート数、フォロワー数などの値は収集時点のスナップショットで、後から変わることがあります。件数フィールドはソースのテキスト形式のままです。投稿本文、画像URL、動画URLもソーステキストとして保持されます。公開日時と収集日時はソースのタイムスタンプを保ち、タイムゾーンは補完しません。
結果のイメージ
各レコードは、Twitter投稿1件について取得した公開詳細です。
| 投稿ID | アカウント名 | いいね数 | コンテンツタイプ | 公開場所 | 公開日時 |
|---|---|---|---|---|---|
| 1034243881263542272 | ヒビトラ | 11 | video | 日本 日本海側 | 2018-08-28T08:58:51 |
| 2090251737974059102 | AUTO.AE — Cars for sale | 0 | photo | Dubai | 2026-08-20T09:37:03 |
ほかに、アカウント識別子とプロフィールリンク、メディアURL、投稿本文全文、収集タイムスタンプ、送信済み投稿IDなどがあります。
活用シーン
- いいね数、コメント数、引用数、リツイート数を比べ、公開エンゲージメントが強い投稿を見つける。
- 投稿本文、コンテンツタイプ、画像URL、動画URLを見て、表現テーマとメディア形式を分類する。
- アカウント名、アカウントID、アカウントホームURL、アカウントハンドルで、選んだ投稿群に投稿者の文脈を足す。
- 公開日時、収集日時、投稿URL、公開場所を繰り返し収集して比べ、公開状況と投稿パターンを追う。
適用範囲と境界
1回の実行で1~200件のTwitter投稿IDを受け付けます。有効で重複排除された各投稿IDは、公開詳細を最大1件返します。
- 適している用途
- 既知のTwitter投稿IDに対して、公開メタデータとエンゲージメントのスナップショットが必要なときに使う
- 1回のバックグラウンドタスクで最大200件の投稿詳細が必要なときに使う
- 適さない用途
- キーワード、ハッシュタグ、アカウントから投稿を探す用途には使わない。既知のTwitter投稿IDを指定する
- 非公開、削除済み、ログイン限定の投稿には使わない
失敗時の処理
作者が宣言した失敗時と再試行の動作です。連携時にはシステムプロンプトに含めることをおすすめします。
- 1一時的なタスクまたはサービス失敗は、同じ投稿IDで再試行する
- 2一部だけ成功した場合は、返されたレコードを使い、欠けている投稿IDだけ再試行する
- 3空の結果は、投稿IDが無効、重複、利用不可、または非公開になったことを意味する場合がある
入力
この App の呼び出しに必要なパラメータで、manifest.json の input.schema から生成されています。
| フィールド | 業務名称 | 型 | 必須 | デフォルト | 列挙値/制約 | 例 | 説明 |
|---|---|---|---|---|---|---|---|
| post_items | Twitter投稿ID | array<object> | はい | — | 最大 200 件 | [{"kw":"1034243881263542272"}] | 1~200件のエントリを追加します。各エントリの投稿ID欄にTwitter投稿IDを入れてください。無効、重複、または取得できない投稿はレコードが返らない場合があります。 |
出力
1 件のレコードのフィールド構造で、manifest.json の output.schema から生成されています。
| フィールド | 業務名称 | 型 | 例 | 説明 |
|---|---|---|---|---|
| account_avatar_url | アカウントのアバターURL | string | https://pbs.twimg.com/profile_images/2080063431563149312/sZKFeQPr_normal.jpg | この投稿に返されたアカウントのアバター画像URLです。 |
| account_fans_count | フォロワー数 | string | 850 | ソースのテキスト形式のまま保持されたアカウントのフォロワー数です。 |
| account_home_url | アカウントホームURL | string | https://twitter.com/eCxIgvhloBVcT1C | 投稿者の公開TwitterプロフィールURLです。 |
| account_id | アカウントID | string | 887883841485946882 | この投稿とともに返された数値のTwitterアカウントIDです。 |
| account_name | アカウント名 | string | ヒビトラ | アカウントの公開表示名です。 |
| biz_id | ビジネスID | string | 1034243881263542272 | この投稿とともに返されたソース側のビジネス識別子です。 |
| collect_count | 保存数 | string | 0 | ソースのテキスト形式のまま保持された保存数です。 |
| comment_count | コメント数 | string | 0 | ソースのテキスト形式のまま保持されたコメント数です。 |
| content_id | 投稿ID | string | 1034243881263542272 | このレコードのTwitter投稿IDです。 |
| content_long_url | メディア詳細URL | string | https://pbs.twimg.com/ext_tw_video_thumb/1034243424356978694/pu/img/2crGII0nH74rMomk.jpg; | この投稿とともに返されたソース側の長いメディアURL文字列です。 |
| content_sec_id | アカウントハンドル | string | eCxIgvhloBVcT1C | この投稿とともに返された公開Twitterハンドルまたはセキュア識別子です。 |
| content_text | 投稿本文 | string | 日曜日の全日本ジムカーナ。 NSX &RX-7FD3S動画。 イオックスアローザで撮影。 https://t.co/it4iuRwsiy | ソース形式のまま保持された公開投稿本文です。 |
| content_type | コンテンツタイプ | string | video | video や photo など、この投稿のソース側コンテンツタイプです。 |
| content_url | 投稿URL | string | https://twitter.com/eCxIgvhloBVcT1C/status/1034243881263542272 | この投稿の公開Twitter URLです。 |
| crawl_time | 収集日時 | string | 2026-08-27T14:17:06 | ソース形式のまま保持された収集タイムスタンプです。タイムゾーンは補完しません。 |
| cur_id | レコードID | string | 6a8fd66397a2800ddeba8757 | この収集行のソース側レコード識別子です。 |
| forward_count | 転送数 | string | 1 | ソースのテキスト形式のまま保持された転送数です。 |
| image_urls | 画像URL | string | — | ソーステキストとして保持された画像URLです。複数ある場合はカンマ区切りです。 |
| is_forward | 転送かどうか | boolean | false | ソースがこの投稿を転送として印付けているかどうかです。 |
| keyword_list | 送信ID | string | 1034243881263542272 | ソースのキーワードテキスト欄に保持された、送信済み投稿IDです。 |
| like_count | いいね数 | string | 11 | ソースのテキスト形式のまま保持されたいいね数です。 |
| parent_content_id | 親投稿ID | string | — | この投稿が返信または入れ子投稿である場合の親投稿IDです。 |
| partition_day | パーティション日 | string | 2026-08-27 | ソース形式のまま保持された収集パーティション日です。 |
| publish_location | 公開場所 | string | 日本 日本海側 | この投稿とともに返された公開場所のテキストです。 |
| publish_time | 公開日時 | string | 2018-08-28T08:58:51 | ソース形式のまま保持された公開タイムスタンプです。タイムゾーンは補完しません。 |
| quote_count | 引用数 | string | 1 | ソースのテキスト形式のまま保持された引用数です。 |
| retweet_num | リツイート数 | string | 1 | ソースのテキスト形式のまま保持されたリツイート数です。 |
| retweeted_content_id | リツイート元投稿ID | string | — | この投稿がリツイートである場合の元投稿IDです。 |
| tag_checked_info | タグ確認情報 | string | 1535417931000 | この投稿とともに返されたソース側のタグ確認識別子です。 |
| task_item | リクエスト項目 | string | 1034243881263542272 | このレコードに対して送信された投稿IDです。 |
| task_no_data | データなしフラグ | boolean | false | 送信した投稿から公開詳細が得られなかったかどうかです。 |
| video_urls | 動画URL | string | https://pbs.twimg.com/ext_tw_video_thumb/1034243424356978694/pu/img/2crGII0nH74rMomk.jpg | ソーステキストとして保持された動画または動画プレビューのURLです。 |
| view_count | 再生数 | string | — | ソースのテキスト形式のまま保持された再生数です。 |
レコード Schema
出力はレコード単位で 1 件ずつ返されます。 detail.output.idFieldHint
{
"type": "object",
"properties": {
"account_avatar_url": {
"type": "string",
"title": "アカウントのアバターURL",
"description": "この投稿に返されたアカウントのアバター画像URLです。",
"prefill": "https://pbs.twimg.com/profile_images/2080063431563149312/sZKFeQPr_normal.jpg"
},
"account_fans_count": {
"type": "string",
"title": "フォロワー数",
"description": "ソースのテキスト形式のまま保持されたアカウントのフォロワー数です。",
"prefill": "850"
},
"account_home_url": {
"type": "string",
"title": "アカウントホームURL",
"description": "投稿者の公開TwitterプロフィールURLです。",
"prefill": "https://twitter.com/eCxIgvhloBVcT1C"
},
"account_id": {
"type": "string",
"title": "アカウントID",
"description": "この投稿とともに返された数値のTwitterアカウントIDです。",
"prefill": "887883841485946882"
},
"account_name": {
"type": "string",
"title": "アカウント名",
"description": "アカウントの公開表示名です。",
"prefill": "ヒビトラ"
},
"biz_id": {
"type": "string",
"title": "ビジネスID",
"description": "この投稿とともに返されたソース側のビジネス識別子です。",
"prefill": "1034243881263542272"
},
"collect_count": {
"type": "string",
"title": "保存数",
"description": "ソースのテキスト形式のまま保持された保存数です。",
"prefill": "0"
},
"comment_count": {
"type": "string",
"title": "コメント数",
"description": "ソースのテキスト形式のまま保持されたコメント数です。",
"prefill": "0"
},
"content_id": {
"type": "string",
"title": "投稿ID",
"description": "このレコードのTwitter投稿IDです。",
"prefill": "1034243881263542272"
},
"content_long_url": {
"type": "string",
"title": "メディア詳細URL",
"description": "この投稿とともに返されたソース側の長いメディアURL文字列です。",
"prefill": "https://pbs.twimg.com/ext_tw_video_thumb/1034243424356978694/pu/img/2crGII0nH74rMomk.jpg;"
},
"content_sec_id": {
"type": "string",
"title": "アカウントハンドル",
"description": "この投稿とともに返された公開Twitterハンドルまたはセキュア識別子です。",
"prefill": "eCxIgvhloBVcT1C"
},
"content_text": {
"type": "string",
"title": "投稿本文",
"description": "ソース形式のまま保持された公開投稿本文です。",
"prefill": "日曜日の全日本ジムカーナ。\nNSX &RX-7FD3S動画。\nイオックスアローザで撮影。 https://t.co/it4iuRwsiy"
},
"content_type": {
"type": "string",
"title": "コンテンツタイプ",
"description": "video や photo など、この投稿のソース側コンテンツタイプです。",
"prefill": "video"
},
"content_url": {
"type": "string",
"title": "投稿URL",
"description": "この投稿の公開Twitter URLです。",
"prefill": "https://twitter.com/eCxIgvhloBVcT1C/status/1034243881263542272"
},
"crawl_time": {
"type": "string",
"title": "収集日時",
"description": "ソース形式のまま保持された収集タイムスタンプです。タイムゾーンは補完しません。",
"prefill": "2026-08-27T14:17:06"
},
"cur_id": {
"type": "string",
"title": "レコードID",
"description": "この収集行のソース側レコード識別子です。",
"prefill": "6a8fd66397a2800ddeba8757"
},
"forward_count": {
"type": "string",
"title": "転送数",
"description": "ソースのテキスト形式のまま保持された転送数です。",
"prefill": "1"
},
"image_urls": {
"type": "string",
"title": "画像URL",
"description": "ソーステキストとして保持された画像URLです。複数ある場合はカンマ区切りです。"
},
"is_forward": {
"type": "boolean",
"title": "転送かどうか",
"description": "ソースがこの投稿を転送として印付けているかどうかです。",
"prefill": false
},
"keyword_list": {
"type": "string",
"title": "送信ID",
"description": "ソースのキーワードテキスト欄に保持された、送信済み投稿IDです。",
"prefill": "1034243881263542272"
},
"like_count": {
"type": "string",
"title": "いいね数",
"description": "ソースのテキスト形式のまま保持されたいいね数です。",
"prefill": "11"
},
"parent_content_id": {
"type": "string",
"title": "親投稿ID",
"description": "この投稿が返信または入れ子投稿である場合の親投稿IDです。"
},
"partition_day": {
"type": "string",
"title": "パーティション日",
"description": "ソース形式のまま保持された収集パーティション日です。",
"prefill": "2026-08-27"
},
"publish_location": {
"type": "string",
"title": "公開場所",
"description": "この投稿とともに返された公開場所のテキストです。",
"prefill": "日本 日本海側"
},
"publish_time": {
"type": "string",
"title": "公開日時",
"description": "ソース形式のまま保持された公開タイムスタンプです。タイムゾーンは補完しません。",
"prefill": "2018-08-28T08:58:51"
},
"quote_count": {
"type": "string",
"title": "引用数",
"description": "ソースのテキスト形式のまま保持された引用数です。",
"prefill": "1"
},
"retweet_num": {
"type": "string",
"title": "リツイート数",
"description": "ソースのテキスト形式のまま保持されたリツイート数です。",
"prefill": "1"
},
"retweeted_content_id": {
"type": "string",
"title": "リツイート元投稿ID",
"description": "この投稿がリツイートである場合の元投稿IDです。"
},
"tag_checked_info": {
"type": "string",
"title": "タグ確認情報",
"description": "この投稿とともに返されたソース側のタグ確認識別子です。",
"prefill": "1535417931000"
},
"task_item": {
"type": "string",
"title": "リクエスト項目",
"description": "このレコードに対して送信された投稿IDです。",
"prefill": "1034243881263542272"
},
"task_no_data": {
"type": "boolean",
"title": "データなしフラグ",
"description": "送信した投稿から公開詳細が得られなかったかどうかです。",
"prefill": false
},
"video_urls": {
"type": "string",
"title": "動画URL",
"description": "ソーステキストとして保持された動画または動画プレビューのURLです。",
"prefill": "https://pbs.twimg.com/ext_tw_video_thumb/1034243424356978694/pu/img/2crGII0nH74rMomk.jpg"
},
"view_count": {
"type": "string",
"title": "再生数",
"description": "ソースのテキスト形式のまま保持された再生数です。"
}
},
"required": [],
"additionalProperties": false
}連携方法
この App は MCP、API、SDK、ファイルエクスポートのいずれでも連携でき、どのチャネルも同じ能力と料金を共有します。すべてのリクエストは Authorization: Bearer ヘッダーで認証し、認証情報には API Key(長期有効。Data Hub コンソールで作成)を使用します。MCP クライアントは OAuth によるキー不要のログインにも対応しています。CLI や Skill など、さらに多くの連携方法も準備中です。
MCP(Model Context Protocol)を使うと、Claude や Cursor などの AI クライアントからこの App を直接呼び出せます。クライアントと認証方式を選び、下の設定をコピーしてください。
クライアント設定
Bearer の後の値を長期有効な API Key に置き換えてください。あらゆるクライアント、CI、ヘッドレス環境で利用できます。
{
"mcpServers": {
"hello_moto__twitter-detail": {
"type": "http",
"url": "https://mcp-v2.octoparse.com?pin=hello_moto/twitter-detail",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}AI に設定を任せる
設定を手作業で編集したくない場合は、インストールプロンプトをコピーして任意の AI クライアントに貼り付けてください。AI が自分のやり方でセットアップを完了します(プロンプトは AI があなたに API Key を尋ねる形になっているため、認証情報がチャット履歴や共有設定に残りません)。
detail.access.mcp.composeHint
料金
返される件数にかかわらず、実行の送信 1 回ごとに課金されます。
正常に返されたレコードの件数に応じて課金されます。失敗した実行には課金されません。
複数の課金イベントはそれぞれ独立して累計されます。詳細は各項目をご覧ください。失敗した実行には課金されません。
Credits を確認今すぐ試す
パラメータを入力して実行してください。結果は実際の呼び出しによるものです。