> ## Documentation Index
> Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Annotations de Publication

> Annotations d’entités et de contexte pour l’analyse sémantique

Les annotations fournissent des métadonnées sémantiques sur le contenu des publications. X analyse les publications pour identifier les entités (personnes, lieux, produits) et le contexte (sujets, domaines), afin de vous aider à mieux comprendre et filtrer le contenu.

***

<div id="annotation-types">
  ## Types d’annotation
</div>

<div id="entity-annotations">
  ### Annotations d’entités
</div>

La reconnaissance d’entités nommées (NER) repère des mentions spécifiques dans le texte d’une publication :

| Type             | Exemples                |
| :--------------- | :---------------------- |
| **Person**       | Barack Obama, Elon Musk |
| **Place**        | San Francisco, Japon    |
| **Product**      | iPhone, ChatGPT         |
| **Organization** | NASA, Google            |
| **Other**        | Super Bowl, Diabète     |

Les annotations d’entités comprennent un score de confiance et la position dans le texte.

<div id="context-annotations">
  ### Annotations de contexte
</div>

Analyse sémantique permettant de classer les publications par sujet et par domaine :

* **Domaine** : Catégorie générale (Sports, Divertissement, Technologie)
* **Entité** : Sujet spécifique au sein d’un domaine (NBA, films Marvel, IA)

Les annotations de contexte aident à filtrer et à catégoriser les publications sans s’appuyer sur des mots-clés.

***

<div id="requesting-annotations">
  ## Demande d’annotations
</div>

Ajoutez `context_annotations` et `entities` à vos `tweet.fields` :

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

***

<div id="response-structure">
  ## Structure de la réponse
</div>

```json 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": "Un film"
        },
        "entity": {
          "id": "1234567890",
          "name": "Marvel Cinematic Universe"
        }
      },
      {
        "domain": {
          "id": "65",
          "name": "Interests and Hobbies Vertical"
        },
        "entity": {
          "id": "781974596752842752",
          "name": "Entertainment"
        }
      }
    ]
  }
}
```

***

<div id="entity-annotation-fields">
  ## Champs d’annotation d’entités
</div>

| Champ             | Description                         |
| :---------------- | :---------------------------------- |
| `start`           | Position de début dans le texte     |
| `end`             | Position de fin dans le texte       |
| `probability`     | Score de confiance (0-1)            |
| `type`            | Type d’entité (Person, Place, etc.) |
| `normalized_text` | Nom d’entité normalisé              |

***

<div id="context-domains">
  ## Domaines de contexte
</div>

X utilise plus de 80 domaines pour catégoriser les Publications. Les domaines courants incluent :

<Tabs>
  <Tab title="Divertissement">
    | ID | Domaine     |
    | :- | :---------- |
    | 3  | Séries TV   |
    | 4  | Épisodes TV |
    | 54 | Musicien    |
    | 56 | Acteur      |
    | 86 | Film        |
    | 91 | Podcast     |
  </Tab>

  <Tab title="Sports">
    | ID | Domaine             |
    | :- | :------------------ |
    | 6  | Événements sportifs |
    | 11 | Sport               |
    | 12 | Équipe sportive     |
    | 26 | Ligue sportive      |
    | 60 | Athlète             |
    | 93 | Entraîneur          |
  </Tab>

  <Tab title="Business et technologie">
    | ID  | Domaine             |
    | :-- | :------------------ |
    | 45  | Secteur de marque   |
    | 46  | Catégorie de marque |
    | 47  | Marque              |
    | 48  | Produit             |
    | 165 | Technologie         |
    | 166 | Actions             |
  </Tab>

  <Tab title="Autre">
    | ID  | Domaine                  |
    | :-- | :----------------------- |
    | 10  | Personne                 |
    | 13  | Lieu                     |
    | 29  | Événements               |
    | 35  | Politiciens              |
    | 119 | Jour férié               |
    | 131 | Unified Twitter Taxonomy |
  </Tab>
</Tabs>

<Note>
  Le domaine 131 (Unified Twitter Taxonomy) alimente la fonctionnalité Thèmes de X, visible par les utilisateurs sur la plateforme.
</Note>

***

<div id="using-annotations-in-filters">
  ## Utiliser les annotations dans les filtres
</div>

<div id="search-and-filtered-stream">
  ### Recherche et flux filtré
</div>

Filtrer les Publications par ID d’entité d’annotation de contexte :

```bash theme={null}
# Publications concernant une entité spécifique
context:86.1234567890

# Publications dans un domaine spécifique
context:86.*
```

<div id="practical-examples">
  ### Exemples pratiques
</div>

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

# Publications à propos des produits Apple
query=context:47.10026792024

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

***

<div id="language-support">
  ## Prise en charge des langues
</div>

Les annotations sont disponibles pour plusieurs langues :

| Langue    | Couverture |
| :-------- | :--------- |
| Anglais   | Maximale   |
| Japonais  | Élevée     |
| Espagnol  | Élevée     |
| Portugais | Moyenne    |
| Français  | Moyenne    |
| Hindi     | Moyenne    |

La couverture varie selon les domaines et les marchés.

***

<div id="important-notes">
  ## Notes importantes
</div>

<Warning>
  **Toutes les publications ne sont pas annotées.** La couverture des annotations dépend de :

  * La prise en charge linguistique
  * La couverture des sujets dans la taxonomie de X
  * La richesse sémantique du texte de la publication
</Warning>

* Les annotations ne sont pas rétroactives — elles ne sont appliquées que lorsque les entités sont suivies
* La même entité peut apparaître dans plusieurs domaines (par exemple, une célébrité est à la fois Person et Actor)
* Les id d'entité restent stables d'un domaine à l'autre

***

<div id="resources">
  ## Ressources
</div>

<CardGroup cols={2}>
  <Card title="Explorateur d’entités" icon="flask" href="https://tweet-entity-extractor.glitch.me/">
    Outil interactif pour découvrir les annotations.
  </Card>

  <Card title="Liste d’entités de contexte" icon="github" href="https://github.com/xdevplatform/twitter-context-annotations">
    CSV des entités d’annotation contextuelle disponibles.
  </Card>
</CardGroup>