问答
怎么从推文 ID 算出发布时间?
简短回答
把帖子 ID 右移 22 位,再加上 1288834974657(X 的 Snowflake 纪元,Unix 毫秒),得到的就是精确到毫秒的创建时间,本地就能算,不花钱。2010 年 11 月以后的帖子都适用。如果还要正文和互动数,okdata 的 X 帖子详情接口会把 published_at 一起返回,每次 $0.0003。
X 上每条帖子都有一个 1987654321098765432 这样的数字 ID,这个数字里自带时间戳。X 用 2010 年自己设计的 Snowflake 方案生成 ID:高位存的是从某个固定起点算起的毫秒数,所以直接从 ID 里就能读出创建时间。
位的布局
| 位数 | 存的是什么 |
|---|---|
| 1(最高位) | 固定为 0 |
| 41 | 自 X 纪元起的毫秒数,纪元是 1288834974657(2010 年 11 月 4 日 01:42:54.657 UTC) |
| 10 | 机器编号 |
| 12 | 同一毫秒内的序列号 |
所以:unix_ms = (id >> 22) + 1288834974657。
手算示例
以 1987654321098765432 为例:
- 右移 22 位(等同于整除 4,194,304):
473893718981。 - 加上纪元:
473893718981 + 1288834974657 = 1762728693638毫秒。 - 也就是 2025 年 11 月 9 日 22:51:33.638 UTC,北京时间 11 月 10 日 06:51:33。
我们拿接口返回的一条真实帖子核对过:用 ID 算出的时间和帖子的 createdAt 精确到秒完全一致。
容易踩的坑
- **精度。**ID 超出了 JavaScript 普通数字能精确表示的范围,
Number("1987654321098765432")会悄悄改掉末尾几位。存储用字符串,计算用BigInt,X 官方文档也是这么建议的。 - **老帖子。**2010 年底 Snowflake 上线之前的 ID 是从小到大的顺序编号,套公式算出来的时间没有意义。TweetedAt 的研究者找到的最大的 Snowflake 之前的 ID 是 29700859247,不超过它的 ID 一律当作无法推算时间。
- **用户 ID。**近几年注册的账号,用户 ID 也是 Snowflake;我们解过一个,结果比该账号标注的注册时间早 7 秒。老账号的 ID 很短,解不出时间。
- **排序。**时间在高位,所以按 ID 排序就等于按时间排序,排序时用不着日期列。
什么时候调接口
X 帖子详情传 ID 或 x.com 链接,返回 published_at,以及正文、媒体、浏览、点赞、转发和回复数。
| 需求 | 做法 | 费用 |
|---|---|---|
| 只要发布时间 | 解 ID | 免费 |
| 时间加上当前互动数据 | 调一次详情 | $0.0003 |
| 数据集里的 1,000 条帖子 | 调 1,000 次 | $0.30 |
示例
import os, requests
from datetime import datetime, timezone
X_EPOCH_MS = 1288834974657
def posted_at(post_id: str) -> datetime:
ms = (int(post_id) >> 22) + X_EPOCH_MS
return datetime.fromtimestamp(ms / 1000, tz=timezone.utc)
pid = "1987654321098765432"
print(posted_at(pid).isoformat(timespec="milliseconds")) # 2025-11-09T22:51:33.638+00:00
body = requests.get("https://api.okdata.online/v1/x/posts/get", timeout=60,
headers={"Authorization": f"Bearer {os.environ['OKDATA_API_KEY']}"},
params={"id": pid, "fields": "id,published_at,metrics.views,metrics.likes"}).json()
print(body["data"]["item"] if body["code"] == "ok" else body["code"])
JavaScript 写法:new Date(Number((BigInt(id) >> 22n) + 1288834974657n))。
限制
- 已删除或受保护的帖子,ID 照样能解,但详情接口返回
not_found,这次调用照常计费。 - 帖子每编辑一次,新版本都有自己的 ID(X 的数据字典里叫
edit_history_tweet_ids),所以编辑版的 ID 算出来的是编辑时间,不是首发时间。
想从链接读取帖子本身,见 AI 智能体怎么读 x.com 链接里的推文。
资料来源
- X API 文档:X IDs(64 位 Snowflake ID)
- X API 数据字典:帖子和用户字段
- Snowflake ID(维基百科)
- twitter-archive/snowflake
- TweetedAt:为 Snowflake 前后的推文 ID 找时间戳
这个问题出现过的地方(读取于 2026-11-12)
更新于