メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://generaltranslation.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

アノテーションは、ポストの内容に関する意味的なメタデータを提供します。X はポストを解析して、エンティティ（人物、場所、製品）やコンテキスト（トピック、ドメイン）を特定し、コンテンツの理解やフィルタリングを支援します。

​
アノテーションの種類

​
エンティティアノテーション

固有表現認識（NER）は、ポスト本文中の特定の対象を識別します。
Type例
PersonBarack Obama、Elon Musk
PlaceSan Francisco、日本
ProductiPhone、ChatGPT
OrganizationNASA、Google
OtherSuper Bowl、Diabetes
エンティティアノテーションには、各エンティティの信頼度スコアとテキスト内での位置が含まれます。

​
コンテキストアノテーション

投稿をトピックやドメインごとに分類するセマンティック解析です:
  • ドメイン: 広いカテゴリ (Sports、Entertainment、Technology)
  • エンティティ: ドメイン内の特定のトピック (NBA、Marvel Movies、AI)
コンテキストアノテーションを使用すると、キーワードに依存することなく投稿をフィルタリングおよび分類できます。

​
アノテーションをリクエストする

tweet.fields に context_annotations と entities を追加します： 
curl "https://api.x.com/2/tweets/1234567890?tweet.fields=context_annotations,entities" \
  -H "Authorization: Bearer $TOKEN"

​
レスポンスの構造

{
  "data": {
    "id": "1234567890",
    "text": "Just saw the new Marvel movie - it was amazing!",
    "entities": {
      "annotations": [
        {
          "start": 17,
          "end": 22,
          "probability": 0.9234,
          "type": "Organization",
          "normalized_text": "Marvel"
        }
      ]
    },
    "context_annotations": [
      {
        "domain": {
          "id": "86",
          "name": "Movie",
          "description": "A film"
        },
        "entity": {
          "id": "1234567890",
          "name": "Marvel Cinematic Universe"
        }
      },
      {
        "domain": {
          "id": "65",
          "name": "Interests and Hobbies Vertical"
        },
        "entity": {
          "id": "781974596752842752",
          "name": "Entertainment"
        }
      }
    ]
  }
}

​
エンティティ注釈のフィールド

FieldDescription
startテキスト内の開始位置
endテキスト内の終了位置
probability信頼度スコア (0〜1)
typeエンティティの種別 (Person、Place など)
normalized_text正規化されたエンティティ名

​
コンテキストドメイン

X では、投稿を分類するために 80 個以上のドメインを使用しています。一般的なドメインには次のようなものがあります。
IDドメイン
3テレビ番組
4テレビエピソード
54ミュージシャン
56俳優
86映画
91ポッドキャスト
ドメイン 131（Unified Twitter Taxonomy）は、プラットフォーム上でユーザーに表示される X のトピック機能の基盤となっています。

​
フィルターでアノテーションを利用する

​
検索とフィルター済みストリーム

コンテキスト注釈エンティティ ID で投稿をフィルターします。 
# 特定のエンティティに関する投稿
context:86.1234567890

# Posts in a specific domain
context:86.*

​
実用例

# Posts about the NBA
query=context:26.852137520

# Apple製品に関する投稿
query=context:47.10026792024

# Posts about movies
query=context:86.*

​
対応言語

アノテーションは複数の言語で利用できます。
言語対応状況
English最高
Japanese高
Spanish高
Portuguese中
French中
Hindi中
対応状況はドメインや市場によって異なります。

​
重要な注意事項

すべての投稿にアノテーションが付与されているわけではありません。 アノテーションの付与範囲は次の要因に依存します:
  • 対応している言語
  • X のタクソノミーでカバーされているトピック
  • 投稿本文の意味的な情報量
  • アノテーションは遡及適用されません — エンティティがトラッキングされている場合にのみ付与されます
  • 同じエンティティが複数のドメインに属することがあります（例: 有名人は Person と Actor の両方になり得る）
  • エンティティの id はドメインをまたいでも変わりません

​
リソース

Entity Explorer

アノテーションを調査できるインタラクティブツールです。

Context Entity リスト

利用可能なコンテキストアノテーションエンティティの CSV ファイル。