アノテーションのタイプ
Entity アノテーション
固有表現認識(NER)は post テキスト内の特定の言及を識別します。
Entity アノテーションには信頼度スコアとテキスト内の位置が含まれます。
Context アノテーション
post をトピックとドメインで分類するセマンティック分析です。- Domain: 大きなカテゴリ(Sports、Entertainment、Technology)
- Entity: ドメイン内の具体的なトピック(NBA、Marvel Movies、AI)
アノテーションのリクエスト
context_annotations と entities を tweet.fields に追加します。
レスポンスの構造
Example response
Entity アノテーションのフィールド
Context ドメイン
X は 80 以上のドメインを使用して post を分類します。よく使われるドメイン:- Entertainment
- Sports
- Business & Tech
- Other
ドメイン 131(Unified Twitter Taxonomy)は、プラットフォーム上でユーザーに表示される X の Topics 機能を支えています。
フィルタでのアノテーション利用
Search と filtered stream
Context アノテーションの entity ID で post をフィルタします。実用例
言語サポート
アノテーションは複数の言語で利用できます。
カバレッジはドメインやマーケットによって異なります。
重要な注意事項
- アノテーションはさかのぼって付与されません — entity が追跡されているときのみ適用されます
- 同じ entity が複数のドメインに現れることがあります(例: セレブは Person かつ Actor)
- Entity ID はドメイン間で安定です
リソース
Context Entity List
利用可能な context アノテーション entity の CSV。