您需要可靠、最新的 Twitter 个人资料上下文、关注者图表和回复时间线,以便在本周发布的功能中使用。在本指南结束时,您将能够使用 Zyla API Hub 上的 Twitter 数据全能 API 获取用户的个人资料、附加的个人资料元数据、他们关注的人以及他们的最近回复,并提供可复制的 curl 和 Python 示例,您可以立即将其放入您的服务中。
此 API 提供的内容
Twitter 数据全能 API 提供对您在社交功能中通常需要的公共 Twitter (X) 数据点的编程访问:
- 个人资料:核心账户属性(名称、头像、计数、创建时间)。
- 关于个人资料:附加元数据,例如蓝色验证、附属标签信息和位置上下文。
- 关注:用户关注的账户列表,包含关注者/朋友/媒体计数。
- 用户回复:用户的最近回复时间线,包含推文级别的参与度指标和实体。
这些端点支持常见的社交媒体用例,如影响者审核、社区自动化、客户支持分流和分析仪表板。
在 Zyla API Hub 上开始
打开 API 页面并订阅以获取您的密钥。Zyla API Hub 使用订阅 + 配额模型(不是按调用付费)。对于第一个 API,您可以开始 7 天试用或 50 次请求——请查看列表以获取当前访问选项。订阅后,您将收到一个在市场上通用的 API 密钥。
身份验证
在每个请求的 Authorization 头中发送您的密钥:
- Authorization: Bearer YOUR_API_KEY
您本周可以发布的端点
个人资料
返回给定屏幕名称的核心个人资料属性。
- 方法:GET
- URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3673/profile
- 所需查询参数:screenname
curl -s -X GET "https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3673/profile?screenname=elonmusk" \
-H "Authorization: Bearer YOUR_API_KEY"
{
"status": "active",
"profile": "MikeCiesla",
"rest_id": "23880336",
"blue_verified": true,
"affiliates": [],
"business_account": [],
"avatar": "https://pbs.twimg.com/profile_images/1699329166234247168/G1W8YKJy_normal.jpg",
"header_image": "https://pbs.twimg.com/profile_banners/23880336/1695301088",
"desc": "Web3 at Google Cloud",
"name": "MikeCiesla",
"protected": null,
"location": "🦘🇦🇺",
"friends": 969,
"sub_count": 219,
"statuses_count": 48,
"media_count": 2,
"pinned_tweet_ids_str": [],
"created_at": "Thu Mar 12 02:45:15 +0000 2009",
"id": "23880336"
}
您可能会立即使用的关键字段:name、desc、avatar、header_image、blue_verified、counts(friends、sub_count、statuses_count、media_count)、created_at(Twitter 日期格式的字符串)以及用于交叉引用的 id/rest_id。使用 protected 来标记您 UI 逻辑中的受限账户。
关于个人资料
返回关于个人资料的附加元数据,例如验证状态、附属标签和账户级别的“关于”属性。
- 方法:GET
- URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/22582/about-profile
- 所需查询参数:screenname
使用 blue_verified 和 affiliates.label 来显示验证或商业关系。关于对象包括高信号元数据,如 account_based_in 和 username_changes.count,用于欺诈检查和入职流程。将 verified_since 视为字符串,除非您明确转换它。
关注
返回用户正在关注的账户列表,包括每个被关注账户的基本计数。
- 方法:GET
- URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3679/following
- 所需查询参数:screenname
对于增长和图表功能,遍历关注以计算重叠,显示共同兴趣,或预填“建议关注”。检查 more_users 以了解在构建分页 UI 时是否有其他页面需要获取。
用户回复
返回用户的最近回复时间线,包括推文参与度指标和可用的引用转发。
- 方法:GET
- URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3682/user-replies
- 所需查询参数:screenname
{"timeline":[{"tweet_id":"1867196702865674450","bookmarks":0,"created_at":"Thu Dec 12 13:15:59 +0000 2024","favorites":0,"text":"RT @cb_doge: 每个与传统媒体叙事作斗争并传播真相的公民记者都是年度人物。…","lang":"zh","in_reply_to_status_id_str":null,"views":null,"quotes":0,"replies":0,"retweets":10,"conversation_id":"1867196702865674450","media":[],"entities":{"user_mentions":[{"id_str":"1389913567671975937","name":"DogeDesigner","screen_name":"cb_doge"}],"urls":[],"hashtags":[],"symbols":[]},"author":{"rest_id":"44196397","name":"Elon Musk","screen_name":"elonmusk","followers_count":207267106,"favourites_count":99802,"avatar":"https:\/\/pbs.twimg.com\/profile_images\/1858316737780781056\/kPL61o0F_normal.jpg","blue_verified":true},"retweeted":{"id":"1867196122143563838"},"retweeted_tweet":{"tweet_id":"1867196122143563838","bookmarks":0,"created_at":"Thu Dec 12 13:13:41 +0000 2024","favorites":119,"text":"每个与传统媒体叙事作斗争并传播真相的公民记者都是年度人物。
https:\/\/t.co\/B8boPofzKx","lang":"zh","quotes":2,"replies":60,"retweets":10,"conv…
使用 text、created_at、参与计数(retweets、replies、favorites、quotes)和 entities.user_mentions 来推动审核、社区回复仪表板或优先响应队列。当存在时,retweeted 和 retweeted_tweet 提供您可能需要呈现的 RT 的上下文。
Python 示例:获取和规范化个人资料
此代码段调用个人资料端点,提取关键字段,并展示如何处理布尔值和计数。将 YOUR_API_KEY 替换为您的令牌。
import requests
API_KEY = "YOUR_API_KEY"
BASE_URL = "https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3673/profile"
def fetch_profile(screenname: str) -> dict:
resp = requests.get(
BASE_URL,
headers={"Authorization": f"Bearer {API_KEY}"},
params={"screenname": screenname},
timeout=20,
)
resp.raise_for_status()
data = resp.json()
# 规范化您的 UI 需要的字段
return {
"id": data.get("id") or data.get("rest_id"),
"name": data.get("name"),
"username": data.get("profile"),
"avatar": data.get("avatar"),
"header_image": data.get("header_image"),
"bio": data.get("desc"),
"verified": bool(data.get("blue_verified")),
"friends": data.get("friends"),
"subscribers": data.get("sub_count"),
"statuses": data.get("statuses_count"),
"media": data.get("media_count"),
"created_at": data.get("created_at"),
"location": data.get("location"),
"protected": data.get("protected"),
}
if __name__ == "__main__":
profile = fetch_profile("elonmusk")
print(f"{profile['name']} (@{profile['username']}) — verified={profile['verified']}")
print(f"Tweets: {profile['statuses']}, Followers-like metric (subscribers): {profile['subscribers']}")
print(f"Avatar: {profile['avatar']}")
实际实施注意事项
- 身份验证头:始终包括 Authorization: Bearer YOUR_API_KEY。
- 时间戳:created_at 是 Twitter 风格的字符串(例如,Thu Mar 12 02:45:15 +0000 2009)。如果需要 UTC 纪元,请谨慎解析。
- 计数器:计数是整数;将缺失字段视为 None,以避免强制转换错误。
- 布尔值:blue_verified 和 protected 在存在时为布尔值;某些字段如果未知可能为 null。
- 分页:如果存在像 more_users 这样的字段(关注端点),请使用它来决定是否有更多数据可用。如果您需要更深的分页,请查看 API 页面以获取选项。
- 缓存:个人资料和关于个人资料的更改频率较低;根据您的 SLA 缓存几分钟到几小时。回复更新迅速;如果您需要新鲜度,请保守缓存。
- 错误处理:计划进行网络重试和 JSON 解码错误;不要假设每个字段总是被填充。
- 订阅模型:Zyla 使用订阅 + 配额。对于您的第一个 API,您可以开始 7 天试用或 50 次请求——在负载测试之前,请验证 API 页面上的当前条款。
您现在可以构建的常见社交媒体用例
- 影响者发现:使用个人资料和关于个人资料按验证、活动(statuses_count、media_count)和传记关键字对候选人进行排名。
- 社区健康:跟踪关注以分析兴趣和网络集群;计算跨群体的共享关注,以建议小众社区。
- 支持分流:提取用户回复以检测未解决的提及和高紧急线程;按回复和引用计数进行优先排序。
- CRM 的丰富性:将个人资料/关于个人资料中的头像、名称和验证状态附加到用户记录中,以提供更好的支持上下文。
- 内容审核队列:解析用户回复中的实体和语言,以将项目路由到正确的审核者。
通过 MCP 从 AI 代理调用
您还可以通过讲 Model Context Protocol 的 AI 编码代理访问相同的中心端点。将您的 MCP 兼容客户端(Claude Code、Cursor、Windsurf 等)指向 MCP 端点,并将您的密钥作为查询参数传递。
配置完成后,您的代理可以调用上述显示的个人资料、关于个人资料、关注和用户回复 URL,并带上 Authorization 头。这对于自动化非常有用,例如“总结 @username 的最后五条回复”或“验证账户的蓝色验证状态”。
端点参考和示例
关于个人资料(回顾)
GET https://zylalabs.com/api/3399/twitter-data-all-in-one-api/22582/about-profile?screenname=elonmusk
返回附加的个人资料元数据,包括验证、附属标签和位置上下文。
关注(回顾)
GET https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3679/following?screenname=elonmusk
返回被关注账户的列表,每个账户都有计数和个人资料图片 URL。使用 more_users 来驱动您 UI 中的分页逻辑。
用户回复(回顾)
GET https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3682/user-replies?screenname=elonmusk
返回带有参与度指标和实体的回复时间线,以便进行下游处理。
常见问题解答
我如何验证请求?
在您对中心 URL 的每个请求的头中包含 Authorization: Bearer YOUR_API_KEY。
获取用户数据需要哪个参数?
此处显示的所有端点都需要 screenname 查询参数(例如,screenname=elonmusk)。
是否有分页?
在可用的情况下,响应将包括像 more_users 这样的提示(如在关注端点中)。有关更深分页详细信息或其他游标,请查看 API 页面。
当前的访问选项是什么?
Zyla 使用订阅 + 配额模型。对于您的第一个 API,您可以开始 7 天试用或 50 次请求;请查看 API 列表以获取当前条款。
我可以从 AI 代理使用这个吗?
是的。配置您的 MCP 兼容客户端以调用中心端点,使用上述提到的 MCP 端点和您的 API 密钥。
准备将其集成到您的社交媒体堆栈中吗?订阅,获取您的密钥,并使用上述示例发布您的集成。试用在项目页面开始: 开始 Twitter 数据全能 API 的 7 天试用。