API for lists timeline

您需要在本周发布一个“列表式”时间线视图——展示用户的个人资料，拉取干净的回复源，并用他们关注的人进行丰富。到本文结束时，您将知道在 Zyla API Hub 的 Twitter 数据全能 API 上调用的确切端点，以获取用户个人资料，检索他们的回复时间线，并列出他们关注的人——足以在您的应用中呈现一个紧凑、易于浏览的时间线组件。

此 API 提供的内容及其使用时机

Twitter 数据全能 API 返回公共 Twitter 账户的结构化数据。通过此处涵盖的端点，您可以：

通过屏幕名称解析个人资料，包括状态、头像、头图和计数。
检索详细的“关于个人资料”元数据，例如验证、附属标签和来源信息。
列出用户关注的账户，以种子为基础的人员源。
获取用户的回复时间线（当您想要专注于对话内容时，这是“列表时间线”的实用替代品）。

这些内容通常用于为用户卡片、详细视图和仪表板、CRM 侧边栏、研究工具和内部监控控制台中的时间线面板提供动力。

在 Zyla API Hub 上开始

Zyla API Hub 将超过 10,000 个公共 API 集中在一个账户、一个密钥和一个订阅模型下。打开 API 页面，订阅，并在列出的端点中使用您的密钥。

打开 Zyla API Hub，找到 Twitter 数据全能 API 页面（下面 CTA 中的链接）。Zyla 的目录可以在 zylalabs.com 浏览。
点击订阅（或在可用时点击开始免费试用）以生成您的 API 密钥。
使用 Authorization: Bearer YOUR_API_KEY 向下面的 Hub URL 发送请求。

计费为订阅 + 配额（而不是按调用计费）。对于第一个 API，您可以期待 7 天的试用或 50 次请求——请查看 API 页面以获取当前访问选项和定价。没有免费计划。

您将使用的端点

以下是公开文档的 Hub URL、HTTP 方法和所需参数，完全按照提供的内容。所有请求都使用头 Authorization: Bearer YOUR_API_KEY。请勿添加额外参数。

1) 个人资料

方法：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"

官方 JSON 响应：

{
"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"
}

您可能会立即使用的内容：

status：获取时的账户状态。
rest_id 和 id：您可以存储以进行连接的内部标识符。
avatar、header_image、name、desc、location：用于渲染个人资料卡。
friends、sub_count、statuses_count、media_count：用于徽章/计数器的统计信息。
created_at：带有 UTC 偏移量的 RFC822 类时间戳（+0000）。

2) 关于个人资料

方法：GET
URL：https://zylalabs.com/api/3399/twitter-data-all-in-one-api/22582/about-profile
所需查询参数：screenname（字符串）
目的：返回个人资料的额外验证、附属和“关于”元数据。

当您需要验证/徽章信息和来源详细信息以补充核心个人资料响应时，此端点非常有用。

3) 关注

方法：GET
URL：https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3679/following
所需查询参数：screenname（字符串）
目的：返回用户关注的账户列表，包含关键计数和个人资料信息。

使用此功能构建“关注的人”部分，调整您的时间线以关注的账户，或构建过滤回复源的允许列表。

4) 用户回复

方法：GET
URL：https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3682/user-replies
所需查询参数：screenname（字符串）
目的：返回用户的回复列表（一个以对话为中心的时间线）。

对于希望发布以选择性讨论为中心的“列表时间线”体验的开发者来说，回复时间线是一个实用的替代方案：一个更小、更相关的源，可以嵌入到分析、支持票或 CRM 记录旁边。

您现在可以运行的一个有效请求

这是您可以粘贴到终端中的官方个人资料获取请求。它使用个人资料端点和授权头：

Python 示例：渲染紧凑的个人资料卡

此 Python 代码段调用相同的个人资料端点，读取您实际渲染的字段，并打印您可以放入日志或模板的摘要。

import os
import requests

API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
SCREENNAME = "elonmusk"
URL = "https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3673/profile"

resp = requests.get(
URL,
params={"screenname": SCREENNAME},
headers={"Authorization": f"Bearer {API_KEY}"}
)
resp.raise_for_status()
data = resp.json()

card = {
"status": data.get("status"),
"id": data.get("id"),
"rest_id": data.get("rest_id"),
"name": data.get("name"),
"handle": data.get("profile"),
"avatar": data.get("avatar"),
"header_image": data.get("header_image"),
"desc": data.get("desc"),
"location": data.get("location"),
"counts": {
"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")
}

print("个人资料卡：")
for k, v in card.items():
print(f"- {k}: {v}")

理解您将解析的响应

关于个人资料

当您使用屏幕名称调用关于个人资料时，您将收到详细的元数据，包括验证、附属和“关于”部分。确切示例：

您将使用的字段：

blue_verified：用于徽章渲染的布尔值。
affiliates.label.badge.url 和 affiliates.label.description：在名称旁边显示组织徽章。
about.account_based_in，about.source：关于个人资料来源的上下文工具提示。

关注

关注端点返回个人资料关注的轻量级用户对象数组。确切示例：

需要注意的字段：

following：适合用于芯片/卡的账户数组。
more_users：如果为 true，您应该计划进行分页或后续获取。

用户回复

用户回复端点返回以对话为中心的用户时间线。确切示例（按提供的内容截断）：

{"timeline":[{"tweet_id":"1867196702865674450","bookmarks":0,"created_at":"Thu Dec 12 13:15:59 +0000 2024","favorites":0,"text":"RT @cb_doge: 每个与遗留媒体叙事作斗争并在本次选举中传播真相的公民记者都是年度人物。…","lang":"en","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":"en","quotes":2,"replies":60,"retweets":10,"conv…

实施注意事项：

created_at 是带有 UTC 偏移量的 RFC822 类时间戳（+0000）。如果需要，在您的服务层将其标准化为 UTC 或 ISO 8601。
entities 包含标准的 URL、提及和标签对象以进行自动链接。
retweeted 和 retweeted_tweet 在项目为转发时出现；检查文本和嵌套对象以一致地渲染。

如何从这些部分组合“列表时间线”

虽然此处没有记录专用的“列表时间线”端点，但您可以通过组合以下内容来组装一个专注的、类似列表的源：

获取关注以构建用户感兴趣的账户集合。
获取用户回复以从该用户中提取对话项——通常是监控的最相关信号。
与个人资料/关于个人资料连接，以徽章和上下文（blue_verified、附属徽章）在线呈现信任和来源详细信息。

这种方法对于希望获得紧凑、以讨论为中心的视图而不是完整主页时间线的仪表板是实用的。缓存个人资料和关注结果几分钟，以避免重复获取元数据；如果您显示近实时活动，请保持回复获取的新鲜。

节省时间的生产注意事项

身份验证：每个请求必须包括 Authorization: Bearer YOUR_API_KEY。
时间处理：created_at 字段包含 +0000 偏移量——视为 UTC。在获取时转换一次并在您的数据库中存储为日期时间。
分页：如果在关注中出现 more_users，请计划后续获取。如果时间线端点在您的 UI 中指示截断，请添加“加载更多”，即使在摘录中未显示。
缓存：个人资料和关于个人资料的更改频率较低。将它们与回复或其他时间线分开缓存。
配额：Hub 使用订阅 + 配额。对于第一个 API，预计 7 天的试用或 50 次请求；请勿硬编码限制——请查看项目页面。

通过 MCP 从 AI 代理调用这些 API

如果您将其连接到 AI 编码代理（Claude Code、Cursor、Windsurf 或任何兼容 MCP 的客户端），请将其指向 MCP 端点并在 URL 中传递您的 Zyla 密钥：

https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY

使用代理的 MCP 配置来公开 HTTP 工具，并将调用路由到本文中的 Hub URL。有关参考，请参见 MCP。这使得代理可以读取个人资料、获取回复，并在不手动编写每个请求的情况下进行转换。

端点参考：确切请求 URL 和参数

GET https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3673/profile
- 参数：screenname（字符串，必需）
GET https://zylalabs.com/api/3399/twitter-data-all-in-one-api/22582/about-profile
- 参数：screenname（字符串，必需）
GET https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3679/following
- 参数：screenname（字符串，必需）
GET https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3682/user-replies
- 参数：screenname（字符串，必需）