> ## Documentation Index
> Fetch the complete documentation index at: https://docs.x.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Conversation ID
> X 上のすべての返信は会話スレッドに属します。conversation_id フィールドによって、会話ツリー全体を特定、追跡、再構築できます。
X 上のすべての返信は会話スレッドに属します。`conversation_id` フィールドによって、会話ツリー全体を特定、追跡、再構築できます。
***
## 仕組み
誰かが投稿し、他のユーザーが返信すると、すべての返信は同じ `conversation_id`（会話を開始した元の post の ID）を共有します。
```mermaid actions={false} theme={null}
flowchart TD
A["Original post (ID: 1234567890)
← conversation_id for all replies"] --> B["Reply 1 (ID: 1234567891)
conversation_id: 1234567890"]
A --> C["Reply 2 (ID: 1234567892)
conversation_id: 1234567890"]
B --> D["Reply to Reply 1
conversation_id: 1234567890"]
C --> E["Reply to Reply 2
conversation_id: 1234567890"]
```
スレッドの階層がどれだけ深くなっても、すべての post は同じ `conversation_id` を共有します。
***
## conversation\_id のリクエスト
`conversation_id` を `tweet.fields` に追加します。
```bash theme={null}
curl "https://api.x.com/2/tweets/1234567891?tweet.fields=conversation_id,in_reply_to_user_id,referenced_tweets" \
-H "Authorization: Bearer $TOKEN"
```
レスポンス:
```json title="Example response" lines wrap icon="https://mintcdn.com/x-preview/Vn2KEkZaPF9LiPi3/icons/xds/icon-brackets.svg?fit=max&auto=format&n=Vn2KEkZaPF9LiPi3&q=85&s=ed2428e77bab43e57800e1a590e982fa" theme={null}
{
"data": {
"id": "1234567891",
"text": "@user Great point!",
"conversation_id": "1234567890",
"in_reply_to_user_id": "2244994945",
"referenced_tweets": [{
"type": "replied_to",
"id": "1234567890"
}]
}
}
```
***
## 会話全体の取得
`conversation_id` を検索オペレーターとして使用して、スレッド内のすべての post を取得します。
```bash theme={null}
curl "https://api.x.com/2/tweets/search/recent?\
query=conversation_id:1234567890&\
tweet.fields=author_id,created_at,in_reply_to_user_id&\
expansions=author_id" \
-H "Authorization: Bearer $TOKEN"
```
これは元の post に対するすべての返信を、新しい順で返します。
***
## ユースケース
会話ツリー全体を構築します。
```python title="Example" lines wrap icon="python" theme={null}
import requests
conversation_id = "1234567890"
url = f"https://api.x.com/2/tweets/search/recent"
params = {
"query": f"conversation_id:{conversation_id}",
"tweet.fields": "author_id,in_reply_to_user_id,referenced_tweets,created_at",
"max_results": 100
}
response = requests.get(url, headers=headers, params=params)
replies = response.json()["data"]
# created_at でソートして時系列順にする
replies.sort(key=lambda x: x["created_at"])
```
特定の会話への返信をリアルタイムでストリームします。
```bash theme={null}
# 会話用の filtered stream ルールを追加
curl -X POST "https://api.x.com/2/tweets/search/stream/rules" \
-H "Authorization: Bearer $TOKEN" \
-d '{"add": [{"value": "conversation_id:1234567890"}]}'
```
会話内の返信をカウントします。
```bash theme={null}
curl "https://api.x.com/2/tweets/counts/recent?\
query=conversation_id:1234567890" \
-H "Authorization: Bearer $TOKEN"
```
***
## 関連フィールド
| Field | Description |
| :-------------------- | :-------------------------------------- |
| `conversation_id` | スレッドを開始した元の post の ID |
| `in_reply_to_user_id` | 返信対象の post のユーザー ID |
| `referenced_tweets` | `type: "replied_to"` と親 post の ID を含む配列 |
***
## 例: スレッド全体の取得
```json title="Example response" expandable lines wrap icon="https://mintcdn.com/x-preview/Vn2KEkZaPF9LiPi3/icons/xds/icon-brackets.svg?fit=max&auto=format&n=Vn2KEkZaPF9LiPi3&q=85&s=ed2428e77bab43e57800e1a590e982fa" theme={null}
{
"data": [
{
"id": "1234567893",
"text": "@user2 @user1 I agree with you both!",
"conversation_id": "1234567890",
"author_id": "3333333333",
"created_at": "2024-01-15T12:05:00.000Z",
"in_reply_to_user_id": "2222222222",
"referenced_tweets": [{"type": "replied_to", "id": "1234567892"}]
},
{
"id": "1234567892",
"text": "@user1 That's interesting!",
"conversation_id": "1234567890",
"author_id": "2222222222",
"created_at": "2024-01-15T12:03:00.000Z",
"in_reply_to_user_id": "1111111111",
"referenced_tweets": [{"type": "replied_to", "id": "1234567890"}]
},
{
"id": "1234567891",
"text": "@user1 Great point!",
"conversation_id": "1234567890",
"author_id": "4444444444",
"created_at": "2024-01-15T12:02:00.000Z",
"in_reply_to_user_id": "1111111111",
"referenced_tweets": [{"type": "replied_to", "id": "1234567890"}]
}
],
"meta": {
"result_count": 3
}
}
```
***
## 注意事項
* 元の post の `conversation_id` はその post 自身の `id` と等しくなります
* `conversation_id` は post を返すすべての v2 エンドポイントで利用可能です
* 会話をリアルタイムでモニタリングするために [filtered stream](/x-api/posts/filtered-stream/introduction) と組み合わせて使用できます
* 大きなスレッドの場合は [pagination](/x-api/fundamentals/pagination) と組み合わせてください
***
## 次のステップ
conversation\_id で検索。
会話をリアルタイムでモニタリング。