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

# v1 vers v2 (Enterprise)

<div id="enterprise-compared-to-x-api-v2">
  ### Comparaison entre Enterprise et X API v2
</div>

**Similarités**

* Pagination
* Fuseau horaire
* Prise en charge de l’historique des modifications d’une Publication et de ses métadonnées. 

**Différences**

* URL des endpoints
* App et Project requis
* Périodes disponibles
* Format des données de réponse
* Méthodes HTTP
* Formats de date/heure des requêtes
* Paramètres de requête
* Opérateurs de filtrage

<div id="similarities">
  #### Similarités
</div>

**Pagination**

Bien que la v2 dispose de fonctionnalités de pagination supplémentaires (de nouveaux paramètres de pagination qui vous permettent de naviguer à l’aide d’ID de Publications avec `since_id` et `until_id`), les versions Enterprise et v2 vous permettent toutes deux de paginer en fonction de l’heure (`fromDate` et `toDate` avec Enterprise, et `start_time` et `end_time` pour la v2).
 

**Fuseau horaire**

Comme indiqué dans la section sur la pagination, vous pouvez naviguer entre différentes pages de données en fonction de l’heure, aussi bien pour Enterprise que pour la v2. Dans les deux cas, vous utiliserez UTC comme fuseau horaire lorsque vous utilisez ces paramètres.

**Prise en charge de l’historique de modification et des métadonnées des Publications**

Les deux versions fournissent des métadonnées qui décrivent l’historique des modifications. Consultez la [Référence de l’API de recherche](/fr/x-api/posts/recent-search) et la [page sur les principes fondamentaux de l’édition de Publications](/fr/x-api/fundamentals/edit-posts) pour plus de détails. 

<div id="differences">
  #### Différences
</div>

**URL d’endpoint**

* Endpoints Enterprise :
  * 30 jours - `http://gnip-api.x.com/search/30day/accounts/:account_name/:label.json`
  * Archive complète - `http://gnip-api.x.com/search/fullarchive/accounts/:account_name/:label.json`
* Endpoints X API v2
  * Récent (7 jours) - `https://api.x.com/2/tweets/search/recent`
  * Archive complète - `https://api.x.com/2/tweets/search/all`

**Exigences liées aux Apps et aux Projects**

Les endpoints X API v2 exigent que vous utilisiez des identifiants provenant d’un Project lorsque vous authentifiez vos requêtes. Tous les endpoints X API v1.1 peuvent utiliser des identifiants provenant d’Apps ou d’Apps associées à une App.
 

**Périodes disponibles**

L’API Enterprise et X API v2 proposent toutes deux des endpoints qui vous permettent de récupérer des données de Publications filtrées pour l’archive complète des Publications.

Cependant, X API v2 ne propose pas d’endpoint pour une période de 30 jours comme le fait l’API Enterprise. À la place, elle propose l’archive complète mentionnée ci‑dessus, ou une période de 7 jours, qui sont alignées avec le processus Native Enriched vers v2 et [Activity Streams vers v2](/fr/x-api/migrate/data-format-migration#migrating-from-activity-streams-data-format-to-v2), qui peuvent vous aider à faire correspondre les champs Enterprise aux nouveaux champs v2. Ce guide vous fournira également les paramètres d’expansion et de champ spécifiques dont vous aurez besoin de passer dans votre requête v2 pour renvoyer des champs spécifiques.
 

**Format des données de réponse**

L’une des plus grandes différences entre le [format de réponse Enterprise](https://developer.x.com/x-api/enterprise-gnip-2.0/fundamentals/data-dictionary) et le [format de X API v2](/fr/x-api/fundamentals/data-dictionary) est la manière dont vous sélectionnez les champs qui doivent être renvoyés dans votre charge utile.

Pour l’API Enterprise Search, vous recevez un grand nombre de champs de réponse par défaut, puis avez la possibilité d’utiliser des paramètres pour identifier quels champs ou ensembles de champs doivent être renvoyés dans la charge utile.

La version X API v2 ne fournit par défaut que les champs `id` et `text` de la Publication. Pour demander des champs ou des objets supplémentaires, vous devrez utiliser les paramètres [fields](/fr/x-api/fundamentals/fields) et [expansions](/fr/x-api/fundamentals/expansions). Tous les champs de Publication que vous demandez à partir de ces endpoints seront renvoyés dans l’objet Publication principal. Tous les objets et champs user, media, poll ou place étendus seront renvoyés dans un objet `includes` au sein de votre réponse. Vous pouvez ensuite faire correspondre tout objet étendu à l’objet Publication en faisant correspondre les identifiants situés à la fois dans la Publication et dans l’objet étendu.

Nous vous encourageons à en savoir plus sur ces nouveaux paramètres dans leurs guides respectifs, ou en lisant notre guide sur [comment utiliser les champs et les expansions](/fr/x-api/fundamentals/data-dictionary#how-to-use-fields-and-expansions).

En plus des changements dans la façon dont vous demandez certains champs, X API v2 introduit également de nouveaux modèles JSON pour les objets renvoyés par les API, notamment les objets [Post](/fr/x-api/fundamentals/data-dictionary#tweet) et [user](/fr/x-api/fundamentals/data-dictionary#user).

* Au niveau racine JSON, les endpoints standard renvoient les objets Publication dans un tableau `statuses`, tandis que X API v2 renvoie un tableau `data`.
* Au lieu de faire référence aux « statuses » Retweeted et Quoted, le JSON de X API v2 fait référence aux Tweets Retweeted et Quoted. De nombreux champs hérités et obsolètes, tels que `contributors` et `user.translator_type`, sont supprimés.
* Au lieu d’utiliser à la fois `favorites` (dans l’objet Publication) et `favourites` (dans l’objet user), X API v2 utilise le terme `like`.
* X adopte la convention selon laquelle les valeurs JSON sans valeur (par exemple, `null`) ne sont pas écrites dans la charge utile. Les attributs de Publication et de user ne sont inclus que s’ils ont des valeurs non nulles.
   

Nous avons également introduit un nouvel ensemble de champs dans l’objet Publication, dont les suivants :

* Un champ [conversation\_id](/fr/x-api/fundamentals/conversation-id)
* Deux nouveaux champs [annotations](/fr/x-api/fundamentals/post-annotations), dont `context` et `entities`
* Plusieurs nouveaux champs [metrics](/fr/x-api/fundamentals/metrics)
* Un nouveau champ `reply_setting`, qui indique qui peut répondre à une Publication donnée

Et une dernière remarque. La réponse premium inclut un objet `requestParameters` au niveau racine, qui contient les paramètres que vous avez inclus dans votre requête. La version v2 contient à la place un objet `meta` situé au niveau racine, qui inclut `newest_id`, `oldest_id`, `result_count` et `next_token` s’il existe une page de résultats supplémentaire.

**Méthodes HTTP**

La version entreprise de l’API vous permet d’envoyer la requête soit avec la méthode HTTP POST et un corps JSON, soit avec la méthode HTTP GET et une chaîne de requête.

Avec v2, vous ne pouvez utiliser que la méthode HTTP GET avec une chaîne de requête.
 

**Formats d’horodatage des requêtes**

La version entreprise de cet endpoint utilise le format de date/heure suivant à la fois dans les paramètres de pagination et dans le champ de réponse `timePeriod` : `YYYYMMDDHHmm`

L’endpoint v2 utilise le format de date/heure ISO 8601/RFC 3339 à la fois dans les paramètres de pagination et dans les champs de réponse `start` et `end` : `YYYY-MM-DDTHH:mm:ssZ
 `

**Paramètres de requête**

Vous trouverez ci-dessous un tableau des paramètres de requête pour Enterprise et X API v2 :

| Enterprise              | Search Posts v2                    |
| :---------------------- | :--------------------------------- |
| query                   | query                              |
| maxResults              | max\_results                       |
| fromDate (YYYYMMDDHHmm) | start\_time (YYYY-MM-DDTHH:mm:ssZ) |
| toDate (YYYYMMDDHHmm)   | end\_time (YYYY-MM-DDTHH:mm:ssZ)   |
|                         | since\_id                          |
|                         | until\_id                          |
| next                    | next\_token or pagination\_token   |

**Opérateurs de filtrage**

Même si les opérateurs entre Enterprise et X API v2 sont pour la plupart identiques, il existe certaines différences de disponibilité d’opérateurs ainsi que de nouveaux opérateurs qui ont été introduits uniquement dans X API v2.

Pour consulter un tableau complet des opérateurs disponibles pour X API v2, Enterprise, ainsi que premium et standard, veuillez consulter la [page de migration Search Posts](/fr/x-api/posts/search/migrate/overview).

**Prochaines étapes**

[Consultez notre guide de démarrage rapide pour la recherche dans l’archive complète avec X API v2](/fr/x-api/posts/search/quickstart/full-archive-search)

[Consultez la Référence de l’API pour la recherche dans l’archive complète](/fr/x-api/posts/full-archive-search)

[Découvrez des exemples de code pour ces endpoints](https://github.com/xdevplatform/Twitter-API-v2-sample-code)
