> ## 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.
# Vue d’ensemble
## Comparaison des endpoints de recherche de Publications de X API
Les endpoints v2 de recherche de Publications remplacent les endpoints v1.1 standard [GET statuses/lookup](https://developer.x.com/en/docs/twitter-api/v1/tweets/post-and-engage/api-reference/get-statuses-lookup) et [GET statuses/show](https://developer.x.com/en/docs/twitter-api/v1/tweets/post-and-engage/api-reference/get-statuses-show-id). Ce guide s’adresse aux développeurs qui migrent de ces anciennes versions vers X API v2.
***
## Tableau de comparaison des endpoints
| Description | Standard v1.1 | X API v2 |
| :------------------------------------------------------------------------------------------------------------------------------------------------------ | :----------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------- |
| **HTTP methods supported** | `GET` | `GET` |
| **Host domain** | `https://api.x.com` | `https://api.x.com` |
| **Endpoint path** | `/1.1/statuses/show.json`, `/1.1/statuses/lookup.json` | `/2/tweets` |
| **[Authentication](resources/fundamentals/authentication)** | Contexte utilisateur OAuth 1.0a | Contexte utilisateur OAuth 1.0a, OAuth 2.0 App-Only, Code d’autorisation OAuth 2.0 avec PKCE |
| **Post [JSON format](/fr/x-api/fundamentals/data-dictionary)** | Format Standard v1.1 | [Format X API v2](/fr/x-api/fundamentals/data-dictionary), déterminé par les paramètres `fields` et `expansions` (non rétrocompatible avec la v1.1) |
| **Supports selecting specific [fields](/fr/x-api/fundamentals/data-dictionary)** | | ✔ |
| **Supports the [annotations](/fr/x-api/fundamentals/post-annotations) fields** | | ✔ |
| **Supports new [metrics](/fr/x-api/fundamentals/metrics) fields** | | ✔ |
| **Supports `conversation_id` field** | | ✔ |
| **Provides Post edit history** | ✔ | ✔ |
| **Requires credentials from a [developer App](/fr/resources/fundamentals/developer-apps) associated with a [Project](resources/fundamentals/projects)** | | ✔ |
***
## Standard v1.1 comparé à X API v2
Si vous avez déjà travaillé avec les endpoints standard v1.1 GET statuses/show et GET statuses/lookup, ce guide vous aidera à comprendre les similitudes et les différences entre le standard et les endpoints de récupération de Publications de X API v2.
Vous pourriez également être intéressé par notre [outil visuel de migration de format de données](/fr/x-api/migrate/data-format-migration), qui vous aide à visualiser rapidement les différences entre le [format de données de X API v1.1](/fr/x-api/fundamentals/data-dictionary) et le [format de données de X API v2](/fr/x-api/fundamentals/data-dictionary).
* **Similarités**
* Contexte utilisateur OAuth 1.0a
* Limites du nombre de Publications par requête
* Prise en charge de l’historique des modifications des Publications et des métadonnées
* **Différences**
* URL des endpoints
* Conditions requises pour les Apps et les Projects
* Format des données de la réponse
* Paramètres de la requête
### Points communs
#### Méthode d’authentification en contexte utilisateur OAuth 1.0a
L’endpoint standard prend en charge le [contexte utilisateur OAuth 1.0a](/fr/resources/fundamentals/authentication), tandis que le nouvel endpoint X API v2 de recherche de Publications prend en charge à la fois le contexte utilisateur OAuth 1.0a et [OAuth 2.0 App-Only](/fr/resources/fundamentals/authentication). Par conséquent, si vous utilisiez auparavant l’un des endpoints standard de recherche de Publications v1.1, vous pouvez continuer à utiliser la même méthode d’authentification en migrant vers la version X API v2.
L’authentification App-Only est probablement la manière la plus simple de commencer. Pour découvrir comment générer un App Access Token, consultez [ce guide OAuth 2.0 App-Only](/fr/resources/fundamentals/authentication).
#### Limites de Publications par requête
L’endpoint v1.1 [GET statuses/lookup](https://developer.x.com/en/docs/twitter-api/v1/tweets/post-and-engage/api-reference/get-statuses-lookup) vous permet de spécifier jusqu’à 100 Publications par requête. Cela s’applique également à l’endpoint GET /tweets. Pour spécifier un ensemble complet de 100 Publications, utilisez le paramètre `ids` dans la requête avec une liste d’[ID de publication](/fr/resources/fundamentals/x-ids) séparés par des virgules.
**Prise en charge de l’historique des modifications et des métadonnées des Publications**
Les deux versions fournissent des métadonnées décrivant tout historique de modification. Consultez les Références de l’API de recherche de Publications et la [page de notions fondamentales sur la modification des Publications](/fr/x-api/fundamentals/edit-posts) pour plus de détails.
### Différences
#### URL des endpoints
* **Endpoints standard v1.1 :**
* `https://api.x.com/1.1/statuses/show`
* `https://api.x.com/1.1/statuses/lookup`
* **Endpoint X API v2 :**
* `https://api.x.com/2/tweets`
* `https://api.x.com/2/tweets/:id`
#### Conditions requises pour les Apps et les Projects
Les endpoints de X API v2 nécessitent, pour l’authentification, des identifiants provenant d’une [App développeur](/fr/resources/fundamentals/developer-apps) associée à un [Project](/fr/resources/fundamentals/developer-apps). Les endpoints de X API v1.1 peuvent utiliser des identifiants provenant d’Apps ou d’Apps associées à une App.
#### Format des données de réponse
Une différence importante entre les versions d'endpoints standard v1.1 et X API v2 réside dans la façon dont les champs sont sélectionnés dans la charge utile.
Pour les endpoints standard, de nombreux champs de réponse sont inclus par défaut, avec la possibilité d'utiliser des paramètres pour spécifier des champs supplémentaires.
X API v2, en revanche, ne fournit par défaut que les champs `id` et `text` de la Publication. Les champs et objets supplémentaires nécessitent l'utilisation des paramètres [fields](/fr/x-api/fundamentals/fields) et [expansions](/fr/x-api/fundamentals/expansions). Les champs ainsi étendus sont renvoyés dans un objet `includes` au sein de la réponse, qui peut être associé à l'objet Publication principal en faisant correspondre les identifiants.
Pour en savoir plus sur l'utilisation des champs et des expansions, consultez le [guide sur l'utilisation des champs et des expansions](/fr/x-api/fundamentals/data-dictionary). Un [guide de migration du format de données](/fr/x-api/fundamentals/fields) établit également la correspondance entre les champs standard v1.1 et les nouveaux champs v2.
De plus, X API v2 introduit de nouveaux modèles JSON pour les objets, y compris les objets Publication et [user](/fr/x-api/fundamentals/fields) :
* Les endpoints standard renvoient des objets Publication dans un tableau `statuses`, tandis que X API v2 utilise un tableau `data`.
* Les Tweets retweetés et cités dans X API v2 remplacent la terminologie « statuses ».
* Une nouvelle terminologie telle que `like` remplace des termes comme `favorites` et `favourites`.
* Les attributs sans valeur (par exemple `null`) ne sont pas inclus dans les charges utiles de X API v2.
L'objet Publication dans X API v2 inclut de nouveaux champs tels que :
* `conversation_id`
* Deux nouveaux champs [annotations](/fr/x-api/fundamentals/post-annotations) (`context` et `entities`)
* De nouveaux champs [metrics](/fr/x-api/fundamentals/metrics)
* Le champ `reply_setting` indiquant qui peut répondre à une Publication donnée
#### Paramètres de requête
Les paramètres de requête standard de la v1.1 suivants ont des équivalents dans X API v2 :
| Standard | X API v2 |
| :------- | :------- |
| `id` | `ids` |
Certains paramètres standard de la v1.1 **ne sont pas** pris en charge dans X API v2 :
| Standard | Comment |
| :--------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `tweet_mode` | Remplacé par la fonctionnalité de champs et d’expansions. |
| `trim_user` | Remplacé par les champs et les expansions. Utilisez l’expansion `author_id` et `user.fields` pour les données utilisateur. |
| `include_my_retweet` | Fournit l’ID de la Publication source pour les Publications retweetées par l’utilisateur authentifié. |
| `include_entities` | Utilisez les champs et les expansions pour contrôler les entités dans la charge utile. |
| `include_ext_alt_text` | Ajoute le champ `ext_alt_text` dans l’entité média si un texte alternatif est présent. |
| `include_card_uri` | Ajoute `card_uri` lorsqu’une carte publicitaire est associée. |
| `map` | Retourne l’ID de la Publication et le message d’erreur pour les Publications indisponibles dans X API v2, au lieu de champs définis à null dans la v1.1. |
### Requêtes cURL
Les requêtes cURL suivantes illustrent les endpoints standard de la v1.1 et leurs équivalents en v2. Remplacez `ACCESS_TOKEN` dans l’en-tête par le jeton d’accès de votre App. Pour les endpoints v2, le jeton doit appartenir à une [developer App](/fr/resources/fundamentals/developer-apps/overview) au sein d’un [Project](/fr/resources/fundamentals/developer-apps).
Les payloads de réponse de la v1.1 diffèrent de ceux de la v2. Avec la v2, vous pouvez demander différents champs à l’aide des paramètres [fields](/fr/x-api/fundamentals/fields) et [expansions](/fr/x-api/fundamentals/expansions).
**Endpoints standard v1.1 `GET statuses/lookup` et v2 `GET /tweets`**
```bash theme={null}
curl --request GET \
--url 'https://api.x.com/1.1/statuses/lookup.json?id=1460323737035677698%2C1460323743339741184' \
--header 'Authorization: Bearer $ACCESS_TOKEN'
```
```
curl --request GET \
--url 'https://api.x.com/2/tweets?ids=1460323737035677698%2C1460323743339741184&tweet.fields=created_at&expansions=author_id&user.fields=created_at' \
--header 'Authorization: Bearer $ACCESS_TOKEN'
```
**Points de terminaison standard de la v1.1 `GET statuses/show/:id` et de la v2 `GET /tweets/:id`**
```
curl --request GET \
--url 'https://api.x.com/1.1/statuses/show.json?id=1460323737035677698' \
--header 'Authorization: Bearer $ACCESS_TOKEN'
```
```
curl --request GET \
--url 'https://api.x.com/2/tweets/1460323737035677698?tweet.fields=created_at&expansions=author_id&user.fields=created_at' \
--header 'Authorization: Bearer $ACCESS_TOKEN'
```