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 工具，指定 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 设置上限并控制成本（每条额外推文 $0.0004）。
• 日期范围：查询至少需要 50 条结果才能运行。如果范围内推文较少，请扩大日期范围。
• 结果中的转推：Actor 会返回所有公开推文，包括转推。