X の ID

X API における一意の識別子について理解する

X API のあらゆるオブジェクト (投稿、ユーザー、リスト、DM、スペース) には一意の ID が割り当てられています。これらの ID の仕組みを理解することで、信頼性の高い統合を構築できます。

---

ID の形式

X の ID は、「Snowflake」と呼ばれるシステムで生成される 64 ビット符号なし整数 です。各 ID には次の情報がエンコードされています。

• Timestamp — オブジェクトが作成された時刻
• Worker number — どのサーバーがその ID を生成したか
• Sequence number — そのミリ秒内での順序

そのため、ID はおおよそ時間順になっており、より大きな ID は一般的に新しいオブジェクトを表します。

ID は、単一のオブジェクト type 内だけでなく、X 全体でグローバルに一意です。

---

文字列表現と整数表現

コード内では常に文字列のidを使用してください。 一部のプログラミング言語 (JavaScript など) は 64 ビット整数を正確に表現できません。

JavaScript では、整数は 53 ビットに制限されています。このため、大きな id では精度が失われます。

// This loses precision!
const id = 10765432100123456789;
console.log(id.toString()); // "10765432100123458000" — 誤り!

// Use strings instead
const id = "10765432100123456789";
console.log(id); // "10765432100123456789" — correct!

API バージョン

バージョン	ID 形式
X API v2	ID はデフォルトで文字列として返されます
X API v1.1	id (整数) と id_str (文字列) の両方を返します — 常に id_str を使用してください

---

ID の扱い方

id の保存

データベースでは id を文字列または 64 ビット整数として保存することを推奨します：

データベース	推奨される型
PostgreSQL	BIGINT または TEXT
MySQL	BIGINT UNSIGNED または VARCHAR(20)
MongoDB	文字列
SQLite	TEXT (SQLite の整数は最大 63 ビットです)

id の比較

時系列順に並べる目的で id を比較する場合:

# Python - safe for 64-bit integers
if int(id1) > int(id2):
    print("id1 is newer")

# JavaScript - 文字列として比較(同じ長さのIDに対して辞書順で機能)
# またはBigIntを使用
if (BigInt(id1) > BigInt(id2)) {
    console.log("id1 is newer");
}

---

一般的な ID の種類

オブジェクト	ID の例	注記
ポスト (ツイート)	1234567890123456789	Tweet ID とも呼ばれます
ユーザー	2244994945	古いアカウントの ID はより短くなります
リスト	1234567890
スペース	1YqGodQbNXDxv	英数字で構成されており、Snowflake 形式ではありません
DM イベント	1234567890123456789

---

関連リソース

Data Dictionary

各オブジェクトの種類ごとの ID フィールドを確認できます。

ポスト検索

ID を指定して投稿を取得します。