scraping-twitter-profile-tweets

Twitter プロフィールのツイートをスクレイピング

生データを収集します。想定されるユースケースはありません。後続の分析に利用できる完全なデータセットを返します。

---

入力

パラメーター	型	必須	デフォルト	備考
startUrls	配列	任意	[]	Twitter プロフィールの URL（x.com または twitter.com 形式）
twitterHandles	配列	任意	[]	Twitter ユーザー名（@ なし）
start	文字列	任意	—	この日付より後のツイート（YYYY-MM-DD または YYYY-MM-DD_HH:MM:SS_UTC）
end	文字列	任意	—	この日付より前のツイート（YYYY-MM-DD または YYYY-MM-DD_HH:MM:SS_UTC）
includeNativeRetweets	ブール値	任意	false	結果にネイティブリツイートを含めます
onlyImages	ブール値	任意	false	画像を含むツイートのみを対象にします
getReplies	ブール値	任意	false	ツイートへの返信を含めます
minReplyCount	数値	任意	—	返信数の最小しきい値
getAboutData	ブール値	任意	false	プロフィールの概要データをすべて取得します
maxItems	数値	任意	無制限	返すツイートの最大数
customMapFunction	文字列	任意	—	各出力オブジェクトを変換する JavaScript 関数

実行方法

run_actor.js を使用する（推奨）

# Quick answer (table)
node scripts/run_actor.js --actor "apidojo~twitter-profile-scraper" --input '{"twitterHandles": ["elonmusk"], "maxItems": 100}'

# Save as CSV
node scripts/run_actor.js --actor "apidojo~twitter-profile-scraper" --input '{"twitterHandles": ["elonmusk"], "maxItems": 100}' --output results.csv --format csv

# Save as JSON
node scripts/run_actor.js --actor "apidojo~twitter-profile-scraper" --input '{"twitterHandles": ["elonmusk"], "maxItems": 100}' --output results.json --format json

REST API を使用する場合

curl -X POST "https://api.apify.com/v2/acts/apidojo~twitter-profile-scraper/runs" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"twitterHandles": ["elonmusk"], "maxItems": 100}'

Apify MCP が利用できる場合： Apify MCP の call_actor ツールで、アクター apidojo~twitter-profile-scraper と上記の入力を使用してください。

---

出力フィールド

フィールド	型	説明
type	文字列	常に tweet
id	文字列	ツイート ID
url	文字列	ツイート URL（x.com）
twitterUrl	文字列	ツイート URL（twitter.com）
text	文字列	ツイート本文
retweetCount	数値	リツイート数
replyCount	数値	返信数
likeCount	数値	いいね数
quoteCount	数値	引用ツイート数
bookmarkCount	数値	ブックマーク数
createdAt	文字列	作成日時
lang	文字列	検出された言語
isReply	ブール値	返信かどうか
isRetweet	ブール値	リツイートかどうか
isQuote	ブール値	引用ツイートかどうか
source	文字列	使用された Twitter クライアント
author.userName	文字列	投稿者の @ユーザー名
author.name	文字列	投稿者の表示名
author.isVerified	ブール値	従来の認証状態
author.isBlueVerified	ブール値	Twitter Blue の認証状態
author.profilePicture	文字列	投稿者のプロフィール画像 URL
author.followers	数値	投稿者のフォロワー数

エッジケース

• 非公開アカウント：ツイートを 0 件返します。アカウントが非公開であることをユーザーに伝えてください。
• アカウントが凍結されている：エラーを返します。ユーザー名が凍結されている可能性があります。
• 非常に活発なアカウント：maxItems を使って上限を設定し、コストを調整してください（追加のツイート 1 件あたり $0.0004）。
• 日付範囲：クエリの実行には最低 50 件の結果が必要です。範囲内のツイートが少ない場合は、日付範囲を広げてください。
• 結果に含まれるリツイート：アクターは、リツイートを含むすべての公開ツイートを返します。