Skip to main content
アノテーションは post の内容に関するセマンティックなメタデータを提供します。X は post を解析して entity(人物、場所、製品)と context(トピック、ドメイン)を識別し、コンテンツの理解とフィルタリングを支援します。

アノテーションのタイプ

Entity アノテーション

固有表現認識(NER)は post テキスト内の特定の言及を識別します。 Entity アノテーションには信頼度スコアとテキスト内の位置が含まれます。

Context アノテーション

post をトピックとドメインで分類するセマンティック分析です。
  • Domain: 大きなカテゴリ(Sports、Entertainment、Technology)
  • Entity: ドメイン内の具体的なトピック(NBA、Marvel Movies、AI)
Context アノテーションを使うと、キーワードに頼らずに post をフィルタリング・分類できます。

アノテーションのリクエスト

context_annotationsentitiestweet.fields に追加します。

レスポンスの構造

Example response

Entity アノテーションのフィールド


Context ドメイン

X は 80 以上のドメインを使用して post を分類します。よく使われるドメイン:
ドメイン 131(Unified Twitter Taxonomy)は、プラットフォーム上でユーザーに表示される X の Topics 機能を支えています。

フィルタでのアノテーション利用

Search と filtered stream

Context アノテーションの entity ID で post をフィルタします。

実用例


言語サポート

アノテーションは複数の言語で利用できます。 カバレッジはドメインやマーケットによって異なります。

重要な注意事項

すべての post にアノテーションが付くわけではありません。 アノテーションのカバレッジは以下に依存します。
  • 言語サポート
  • X のタクソノミにおけるトピックのカバレッジ
  • post テキストのセマンティックな豊かさ
  • アノテーションはさかのぼって付与されません — entity が追跡されているときのみ適用されます
  • 同じ entity が複数のドメインに現れることがあります(例: セレブは Person かつ Actor)
  • Entity ID はドメイン間で安定です

リソース

Context Entity List

利用可能な context アノテーション entity の CSV。