您的团队本周需要在 Python 应用中获取 Twitter 风格的社交媒体数据:个人资料元数据、用户关注的人以及他们最近的回复。在本指南结束时,您将使用 Zyla API Hub 上的 Twitter 数据全合一 API 查询所有这些内容,在 Python 中解析响应,甚至通过 MCP 将其连接到 AI 代理,以便自动化工作流程。
您可以使用 Twitter 数据全合一 API 构建的内容
Twitter 数据全合一 API 返回结构化的社交媒体数据,以帮助您:
- 获取有关公共个人资料的附加信息(验证、头像 URL、标签、rest_id)。
- 列出用户关注的帐户。
- 获取用户的最近回复(包括推文 ID、时间戳、互动计数和实体)。
此 API 可在 Zyla API Hub 上使用,并且可以通过单个 API 密钥调用。它适用于依赖社交媒体上下文的仪表板、警报管道、ETL 作业、CRM 增强和审核工具。
在 Zyla API Hub 上开始
要调用端点,请打开 Zyla 上 API 的页面:Twitter 数据全合一 API。点击订阅或开始免费试用(如果可用),并复制您的 API 密钥。
- 身份验证:在每个请求中添加 Authorization: Bearer YOUR_API_KEY。
- 计费:订阅 + 配额(不是按调用计费)。
- 访问:第一个 API 通常提供 7 天试用或 50 次请求。没有免费计划。请查看 API 页面以获取当前访问选项和定价。
如果您还没有帐户,请在此处创建一个:注册。您将收到一个在 Zyla API Hub 上的所有订阅 API 中有效的密钥。
身份验证和基本 URL
以下示例均使用 Authorization 头和真实的 Hub URL。将 YOUR_API_KEY 替换为您在 Zyla 中的实际密钥。
- 头部:Authorization: Bearer YOUR_API_KEY
- 基本模式:https://zylalabs.com/api/{marketplace_id}/{api-slug}/{endpoint_id}/{path}
您将使用的端点
以下是此列表中可用的路径。每个路径都需要 screenname 查询参数。请勿包含任何额外的参数或请求体。
关于个人资料
- 方法:GET
- URL:https://zylalabs.com/api/3399/twitter-data-all-in-one-api/22582/about-profile
- 描述:返回有关个人资料的附加信息。
- 所需查询参数:
- screenname(字符串):例如,elonmusk
cURL
curl -s -X GET "https://zylalabs.com/api/3399/twitter-data-all-in-one-api/22582/about-profile?screenname=elonmusk" \
-H "Authorization: Bearer YOUR_API_KEY"
JSON
{"status":"active","profile":"elonmusk","rest_id":"44196397","blue_verified":true,"affiliates":{"label":{"badge":{"url":"https:\/\/pbs.twimg.com\/profile_images\/1955359038532653056\/OSHY3ewP_bigger.jpg"},"description":"X","url":{"url":"https:\/\/twitter.com\/X","urlType":"DeepLink"},"userLabelDisplayType":"Badge","userLabelType":"BusinessLabel"}},"business_account":null,"verified_since":"-156836000000000","avatar":"https:\/\/pbs.twimg.com\/profile_images\/2008546467615580160\/57KcqsTA_normal.jpg","name":"Elon Musk","protected":false,"about":{"account_based_in":"United States","location_accurate":false,"learn_more_url":"https:\/\/help.twitter.com\/managing-your-account\/about-twitter-verified-accounts","affiliate_username":"X","source":"United States App Store","username_changes":{"count":"0"}},"id":"44196397"}
您通常会使用的字段亮点:
- status:帐户状态字符串。
- profile 和 name:处理和显示名称。
- rest_id 和 id:用户标识符。
- blue_verified:用于验证的布尔值。
- avatar:个人资料图片 URL。
- about.account_based_in 和 about.username_changes.count:对合规性和丰富性有用的个人资料元数据。
关注
- 方法:GET
- URL:https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3679/following
- 描述:获取用户关注的帐户列表。
- 所需查询参数:
- screenname(字符串):例如,elonmusk
cURL
curl -s -X GET "https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3679/following?screenname=elonmusk" \
-H "Authorization: Bearer YOUR_API_KEY"
JSON
{"following":[{"user_id":"1671483632551186433","screen_name":"TechMine_Mw","description":"Malawi’s premier SAAS firm 🌐 | Leaders in digital transformation, website development, design, and marketing 🖥️🎨 | Shaping Malawi’s tech future 🇲🇼","profile_image":"https:\/\/pbs.twimg.com\/profile_images\/1847661011731431425\/FNhbpOqP_normal.jpg","statuses_count":5,"followers_count":6,"friends_count":10,"media_count":3,"name":"TechMine INC."},{"user_id":"44196397","screen_name":"elonmusk","description":"","profile_image":"https:\/\/pbs.twimg.com\/profile_images\/1874558173962481664\/8HSTqIlD_normal.jpg","statuses_count":65409,"followers_count":210941749,"friends_count":926,"media_count":3038,"name":"Elon Musk"}],"status":"ok","more_users":false}
您通常会使用的字段亮点:
- following:帐户数组,每个帐户都有 user_id、screen_name、name、description。
- followers_count、friends_count、statuses_count、media_count:用于排名和过滤的快速大小信号。
- more_users:布尔值,指示是否存在超出此响应的更多关注。
用户回复
- 方法:GET
- URL:https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3682/user-replies
- 描述:用户回复的列表。
- 所需查询参数:
- screenname(字符串):例如,elonmusk
cURL
curl -s -X GET "https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3682/user-replies?screenname=elonmusk" \
-H "Authorization: Bearer YOUR_API_KEY"
响应返回一个回复时间线数组,包含 tweet_id、created_at、text、language、互动计数(收藏、转发、回复、引用)、作者元数据和实体等字段。时间戳使用 Twitter 风格的字符串,例如 “Thu Dec 12 13:15:59 +0000 2024”(包含 UTC 偏移),您可以将其解析为日期时间。
Python 快速入门:获取个人资料信息并解析字段
此最小示例调用关于个人资料路径,检查 HTTP 状态,并提取您可能会映射到应用用户模型的关键字段。
Python
import requests
API_KEY = "YOUR_API_KEY"
BASE_URL = "https://zylalabs.com/api/3399/twitter-data-all-in-one-api/22582/about-profile"
params = {"screenname": "elonmusk"}
headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.get(BASE_URL, params=params, headers=headers, timeout=30)
resp.raise_for_status()
data = resp.json()
# 最小字段提取
profile = {
"status": data.get("status"),
"screenname": data.get("profile"),
"name": data.get("name"),
"rest_id": data.get("rest_id"),
"id": data.get("id"),
"blue_verified": data.get("blue_verified"),
"avatar": data.get("avatar"),
"account_based_in": (data.get("about") or {}).get("account_based_in"),
"username_change_count": ((data.get("about") or {}).get("username_changes") or {}).get("count"),
}
print(profile)
节省时间的实用技巧
- 仅限身份验证头:所有显示的路径都需要 Authorization: Bearer YOUR_API_KEY。请勿添加其他身份验证参数。
- 所需参数:此处的每个端点都需要 screenname。使用确切的键名:screenname。
- 时间戳:用户回复中的 created_at 包含 UTC 偏移;存储时标准化为 UTC。
- 分页:关注路径包括 more_users。如果为真,请计划后续提取。请参考 API 页面以获取任何可用的分页详细信息。
- 缓存:个人资料元数据(例如,头像、验证)相对静态。缓存关于个人资料的响应,并按计划刷新以减少调用。
- 错误处理:根据您的 SLA,将非 2xx 视为可重试或面向用户的错误。记录原始 JSON 以便观察。
- 配额:Zyla 使用订阅 + 配额。监控您的使用情况,并保持关键调用的幂等性。请查看 API 页面以获取当前限制。
端到端示例:检索关注并构建索引
这概述了一个简单的管道,以丰富您的 CRM 以获取社交关注图信号:
- 查找带有关于个人资料的帐户(存储 rest_id、name、blue_verified、avatar)。
- 调用关注以获取他们关注的帐户(存储 user_id、screen_name、description)。
- 如果 more_users 为真,请安排后续提取(实现细节取决于 API 页面在可用时)。
- 在您的应用中公开一个过滤器:“显示 @elonmusk 关注的联系人”或“按关注者计数对联系人进行排名。”
当您需要确认联系人的公共存在和地位时,结合关于个人资料(验证和标签)和关注(社交图谱锚点),然后可选地提取用户回复以分析互动的时效性和主题。
通过 MCP 从 AI 代理调用 API
如果您使用 Claude Code、Cursor、Windsurf 或任何兼容 MCP 的客户端自动化社交数据任务,您可以通过 Zyla 的 MCP 端点路由调用:
- 端点:MCP
- MCP 的身份验证:在 MCP URL 中附加 apikey=YOUR_API_KEY,如所示。
- 然后,您的代理可以通过指定 Hub URL 和 MCP 工具配置中的 Authorization 头来调用相同的列表路径(例如,关于个人资料、关注、用户回复),具体取决于您的客户端设置。
保持您的工具描述准确,并在构建请求时仅传递文档化的参数 screenname。
常见工作流程和模式
- 注册时的个人资料丰富:首次登录时使用 handle 字段,调用关于个人资料,存储 rest_id、头像 URL、blue_verified 标志和国家。
- 影响者发现:使用关注来映射种子帐户跟踪的内容。按 followers_count 排名以缩短目标列表。
- 互动诊断:使用用户回复检查最近的活动和主题,然后再启动外展或内容响应。
- 监控:定期提取少量 VIP 帐户;比较 rest_id 和头像以触发警报。
安全性、部署和可观察性注意事项
- 密钥:将 YOUR_API_KEY 保存在秘密管理器或环境变量中。切勿提交凭据。
- 超时:在 Python 请求中,设置有限的超时(例如,30 秒),并在瞬态错误上实施短重试策略。
- 日志记录:记录请求 URL(不带凭据)、HTTP 状态和 JSON 的顶级键以便快速分类。
- 退避:如果接近配额,请减少轮询频率并缓存结果,例如关于个人资料,以避免冗余调用。
附录:其他端点示例
以下是此列表中每个可用路径的可复制 cURL 示例,仅使用所需参数。
关于个人资料(cURL)
curl -s -X GET "https://zylalabs.com/api/3399/twitter-data-all-in-one-api/22582/about-profile?screenname=elonmusk" \
-H "Authorization: Bearer YOUR_API_KEY"
关注(cURL)
curl -s -X GET "https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3679/following?screenname=elonmusk" \
-H "Authorization: Bearer YOUR_API_KEY"
用户回复(cURL)
curl -s -X GET "https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3682/user-replies?screenname=elonmusk" \
-H "Authorization: Bearer YOUR_API_KEY"
接下来探索的地方
- 带有实时控制台和详细信息的 API 页面:Twitter 数据全合一 API
- 更多社交媒体列表的 Zyla API Hub 首页:zylalabs.com
常见问题解答
1) 我如何验证我的请求?
在对上述 Hub URL 的每次调用中包含头部 Authorization: Bearer YOUR_API_KEY。
2) 这些端点需要哪些参数?
本指南中的每个路径都需要查询参数 screenname。仅使用 screenname;请勿添加额外参数或请求体。
3) 响应中是否包含时间戳和互动计数?
是的。用户回复路径包括 created_at 和互动计数,例如收藏、转发、回复和引用。时间戳遵循带有 UTC 偏移的 Twitter 风格字符串。
4) 计费模型是什么?
Zyla 采用订阅 + 配额(不是按调用计费)。对于此 API,第一个 API 通常提供 7 天试用或 50 次请求,并且没有免费计划。请查看 API 页面以获取当前访问选项和定价。
5) 我可以在 AI 代理中使用此 API 吗?
是的。使用 MCP 端点 MCP 和您的 API 密钥,让您的代理调用相同的 Hub URL,并带上 Authorization 头。
准备好发布了吗?创建您的帐户,获取 API 密钥,并开始在 Twitter 数据全合一 API 上集成 Zyla API Hub:注册。