Twitterの検索キーワードを1つと期待件数を指定すると、一致する公開投稿の識別子、公開日時、収集メタデータを取得します。
概要
公開中の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 から生成されています。
- Twitter投稿ID
post_items必須array<object>1~200件のエントリを追加します。各エントリの投稿ID欄にTwitter投稿IDを入れてください。無効、重複、または取得できない投稿はレコードが返らない場合があります。件数最大 200 件例[{"kw":"1034243881263542272"}]
出力
1 件のレコードのフィールド構造で、manifest.json の output.schema から生成されています。
- アカウントのアバターURL
account_avatar_urlstringこの投稿に返されたアカウントのアバター画像URLです。例https://pbs.twimg.com/profile_images/2080063431563149312/sZKFeQPr_normal.jpg - フォロワー数
account_fans_countstringソースのテキスト形式のまま保持されたアカウントのフォロワー数です。例850 - アカウントホームURL
account_home_urlstring投稿者の公開TwitterプロフィールURLです。例https://twitter.com/eCxIgvhloBVcT1C - アカウントID
account_idstringこの投稿とともに返された数値のTwitterアカウントIDです。例887883841485946882
サンプルデータ
output.schema から生成したサンプルです。サンプル値のないフィールドには構造上のプレースホルダーを使用しています。
{
"account_avatar_url": "https://pbs.twimg.com/profile_images/2080063431563149312/sZKFeQPr_normal.jpg",
"account_fans_count": "850",
"account_home_url": "https://twitter.com/eCxIgvhloBVcT1C",
"account_id": "887883841485946882",
"account_name": "ヒビトラ",
"biz_id": "1034243881263542272",
"collect_count": "0",
"comment_count": "0",
"content_id": "1034243881263542272",
"content_long_url": "https://pbs.twimg.com/ext_tw_video_thumb/1034243424356978694/pu/img/2crGII0nH74rMomk.jpg;",
"content_sec_id": "eCxIgvhloBVcT1C",
"content_text": "日曜日の全日本ジムカーナ。\nNSX &RX-7FD3S動画。\nイオックスアローザで撮影。 https://t.co/it4iuRwsiy",
"content_type": "video",
"content_url": "https://twitter.com/eCxIgvhloBVcT1C/status/1034243881263542272",
"crawl_time": "2026-08-27T14:17:06",
"cur_id": "6a8fd66397a2800ddeba8757",
"forward_count": "1",
"image_urls": "<image_urls>",
"is_forward": false,
"keyword_list": "1034243881263542272",
"like_count": "11",
"parent_content_id": "<parent_content_id>",
"partition_day": "2026-08-27",
"publish_location": "日本 日本海側",
"publish_time": "2018-08-28T08:58:51",
"quote_count": "1",
"retweet_num": "1",
"retweeted_content_id": "<retweeted_content_id>",
"tag_checked_info": "1535417931000",
"task_item": "1034243881263542272",
"task_no_data": false,
"video_urls": "https://pbs.twimg.com/ext_tw_video_thumb/1034243424356978694/pu/img/2crGII0nH74rMomk.jpg",
"view_count": "<view_count>"
}連携方法
この 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/twitter-detail",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}AI に設定を任せる
設定を手作業で編集したくない場合は、インストールプロンプトをコピーして任意の AI クライアントに貼り付けてください。AI が自分のやり方でセットアップを完了します(デフォルトではログインを案内し、API Key をチャットに送るよう求めることはありません)。
detail.access.mcp.composeHint
料金
返される件数にかかわらず、実行の送信 1 回ごとに課金されます。
正常に返されたレコードの件数に応じて課金されます。失敗した実行には課金されません。
複数の課金イベントはそれぞれ独立して累計されます。詳細は各項目をご覧ください。失敗した実行には課金されません。
Credits を確認今すぐ試す
パラメータを入力して実行してください。結果は実際の呼び出しによるものです。