给 AI

问答

怎么从推文 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 为例:

  1. 右移 22 位(等同于整除 4,194,304):473893718981。
  2. 加上纪元:473893718981 + 1288834974657 = 1762728693638 毫秒。
  3. 也就是 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 链接里的推文。

资料来源

  1. X API 文档:X IDs(64 位 Snowflake ID)docs.x.com · 读取于
  2. X API 数据字典:帖子和用户字段docs.x.com · 读取于
  3. Snowflake ID(维基百科)en.wikipedia.org · 读取于
  4. twitter-archive/snowflakegithub.com · 读取于
  5. TweetedAt:为 Snowflake 前后的推文 ID 找时间戳ws-dl.blogspot.com · 读取于

这个问题出现过的地方(读取于 2026-11-12)

更新于

接上一次,以后直接问 AI。

新 key 自带 $0.10 试用额度。贴一句话,就能接进你的智能体。

免费开始
一句话接进你的 AI

把这句话发给你的智能体

读一下 https://okdata.online/zh/agents.md,帮我把 okdata 配好;我的 key 在环境变量 OKDATA_API_KEY 里。

Claude Code、Cursor、Codex 等能打开网址的智能体,读完会自己配好。

MCP 地址https://api.okdata.online/mcp