Skip to main content
Anotações fornecem metadados semânticos sobre o conteúdo do post. O X analisa posts para identificar entidades (pessoas, lugares, produtos) e contexto (tópicos, domínios) para ajudá-lo a entender e filtrar conteúdo.

Tipos de anotações

Entity annotations

Reconhecimento de entidade nomeada (NER) identifica menções específicas no texto do post: Entity annotations incluem uma pontuação de confiança e a posição no texto.

Context annotations

Análise semântica que classifica posts por tópico e domínio:
  • Domain: Categoria ampla (Sports, Entertainment, Technology)
  • Entity: Tópico específico dentro do domínio (NBA, Marvel Movies, AI)
Context annotations ajudam a filtrar e categorizar posts sem depender de palavras-chave.

Solicitando anotações

Adicione context_annotations e entities ao seu tweet.fields:

Estrutura da resposta

Exemplo de resposta

Fields de entity annotation


Domínios de contexto

O X usa mais de 80 domínios para categorizar posts. Domínios comuns incluem:
O domínio 131 (Unified Twitter Taxonomy) alimenta o recurso Topics do X visível para os usuários na plataforma.

Usando anotações em filtros

Search e filtered stream

Filtre posts pelo entity ID de context annotation:

Exemplos práticos


Suporte a idiomas

As anotações estão disponíveis para vários idiomas: A cobertura varia por domínio e mercado.

Observações importantes

Nem todos os posts são anotados. A cobertura de anotações depende de:
  • Suporte ao idioma
  • Cobertura de tópicos na taxonomia do X
  • Riqueza semântica do texto do post
  • As anotações não são retroativas — só são aplicadas quando as entidades são rastreadas
  • A mesma entidade pode aparecer em vários domínios (ex.: uma celebridade é tanto Person quanto Actor)
  • Os entity IDs são estáveis entre domínios

Recursos

Lista de Context Entity

CSV das entidades de context annotation disponíveis.