Skip to main content

​
Comparaison entre Enterprise et X API v2

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

​
Similarités

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 et la page sur les principes fondamentaux de l’édition de Publications pour plus de détails. 

​
Différences

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, 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 et le format de X API v2 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 et 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. 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 et 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
  • Deux nouveaux champs annotations, dont context et entities
  • Plusieurs nouveaux champs 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 :
EnterpriseSearch Posts v2
queryquery
maxResultsmax_results
fromDate (YYYYMMDDHHmm)start_time (YYYY-MM-DDTHH:mm:ssZ)
toDate (YYYYMMDDHHmm)end_time (YYYY-MM-DDTHH:mm:ssZ)
since_id
until_id
nextnext_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. Prochaines étapes Consultez notre guide de démarrage rapide pour la recherche dans l’archive complète avec X API v2 Consultez la Référence de l’API pour la recherche dans l’archive complète Découvrez des exemples de code pour ces endpoints