> ## 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.

# Anotaciones de Posts

> Usa las anotaciones de entidad y contexto de la X API v2 para identificar personas, lugares, productos, organizaciones y dominios temáticos semánticamente dentro del texto de un Post.

Las anotaciones proporcionan metadatos semánticos sobre el contenido de los posts. X analiza los posts para identificar entidades (personas, lugares, productos) y contexto (temas, dominios) para ayudarte a comprender y filtrar el contenido.

***

## Tipos de anotaciones

### Anotaciones de entidad

El reconocimiento de entidades con nombre (NER) identifica menciones específicas en el texto del post:

| Tipo             | Ejemplos                |
| :--------------- | :---------------------- |
| **Person**       | Barack Obama, Elon Musk |
| **Place**        | San Francisco, Japan    |
| **Product**      | iPhone, ChatGPT         |
| **Organization** | NASA, Google            |
| **Other**        | Super Bowl, Diabetes    |

Las anotaciones de entidad incluyen una puntuación de confianza y una posición en el texto.

### Anotaciones de contexto

Análisis semántico que clasifica los posts por tema y dominio:

* **Domain**: Categoría amplia (Sports, Entertainment, Technology)
* **Entity**: Tema específico dentro del dominio (NBA, Marvel Movies, AI)

Las anotaciones de contexto ayudan a filtrar y categorizar posts sin depender de palabras clave.

***

## Solicitar anotaciones

Añade `context_annotations` y `entities` a tus `tweet.fields`:

```bash theme={null}
curl "https://api.x.com/2/tweets/1234567890?tweet.fields=context_annotations,entities" \
  -H "Authorization: Bearer $TOKEN"
```

***

## Estructura de respuesta

```json title="Ejemplo de respuesta" 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": "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"
        }
      }
    ]
  }
}
```

***

## Campos de anotación de entidad

| Campo             | Descripción                           |
| :---------------- | :------------------------------------ |
| `start`           | Posición inicial en el texto          |
| `end`             | Posición final en el texto            |
| `probability`     | Puntuación de confianza (0-1)         |
| `type`            | Tipo de entidad (Person, Place, etc.) |
| `normalized_text` | Nombre de entidad estandarizado       |

***

## Dominios de contexto

X usa más de 80 dominios para categorizar posts. Los dominios comunes incluyen:

<Tabs>
  <Tab title="Entertainment">
    | ID | Dominio     |
    | :- | :---------- |
    | 3  | TV Shows    |
    | 4  | TV Episodes |
    | 54 | Musician    |
    | 56 | Actor       |
    | 86 | Movie       |
    | 91 | Podcast     |
  </Tab>

  <Tab title="Sports">
    | ID | Dominio       |
    | :- | :------------ |
    | 6  | Sports Events |
    | 11 | Sport         |
    | 12 | Sports Team   |
    | 26 | Sports League |
    | 60 | Athlete       |
    | 93 | Coach         |
  </Tab>

  <Tab title="Business & Tech">
    | ID  | Dominio        |
    | :-- | :------------- |
    | 45  | Brand Vertical |
    | 46  | Brand Category |
    | 47  | Brand          |
    | 48  | Product        |
    | 165 | Technology     |
    | 166 | Stocks         |
  </Tab>

  <Tab title="Other">
    | ID  | Dominio                  |
    | :-- | :----------------------- |
    | 10  | Person                   |
    | 13  | Place                    |
    | 29  | Events                   |
    | 35  | Politicians              |
    | 119 | Holiday                  |
    | 131 | Unified Twitter Taxonomy |
  </Tab>
</Tabs>

<Note>
  El Domain 131 (Unified Twitter Taxonomy) alimenta la función Topics de X visible para los usuarios en la plataforma.
</Note>

***

## Uso de anotaciones en filtros

### Search y filtered stream

Filtra posts por el ID de entidad de anotación de contexto:

```bash theme={null}
# Posts about a specific entity
context:86.1234567890

# Posts in a specific domain
context:86.*
```

### Ejemplos prácticos

```bash theme={null}
# Posts about the NBA
query=context:26.852137520

# Posts about Apple products
query=context:47.10026792024

# Posts about movies
query=context:86.*
```

***

## Soporte de idiomas

Las anotaciones están disponibles para varios idiomas:

| Idioma    | Cobertura   |
| :-------- | :---------- |
| Inglés    | La más alta |
| Japonés   | Alta        |
| Español   | Alta        |
| Portugués | Media       |
| Francés   | Media       |
| Hindi     | Media       |

La cobertura varía según el dominio y el mercado.

***

## Notas importantes

<Warning>
  **No todos los posts están anotados.** La cobertura de las anotaciones depende de:

  * Soporte de idioma
  * Cobertura de temas en la taxonomía de X
  * Riqueza semántica del texto del post
</Warning>

* Las anotaciones no son retroactivas — solo se aplican cuando las entidades se están rastreando
* La misma entidad puede aparecer en múltiples dominios (por ejemplo, una celebridad es a la vez Person y Actor)
* Los IDs de entidad son estables entre dominios

***

## Recursos

<CardGroup cols={2}>
  <Card title="Lista de entidades de contexto" icon="github" href="https://github.com/xdevplatform/twitter-context-annotations">
    CSV de entidades de anotación de contexto disponibles.
  </Card>
</CardGroup>