Passer au contenu principal
La recherche de Posts est une fonctionnalité essentielle pour mettre en avant les conversations sur X à propos d’un sujet ou d’un événement spécifique. Bien que cette fonctionnalité existe sur X, ces endpoints offrent davantage de flexibilité et de puissance pour filtrer et ingérer des Posts, afin de trouver plus facilement des données pertinentes pour vos recherches, créer des applications d’« écoute » quasi en temps réel, ou plus généralement explorer, analyser et/ou agir sur des Posts liés à un sujet d’intérêt. Nous proposons deux endpoints qui vous permettent de rechercher des Posts : la recherche récente et la recherche dans l’archive complète. Ces endpoints REST partagent une conception et des fonctionnalités communes, notamment l’utilisation d’une unique query de recherche pour filtrer les Posts autour d’un sujet spécifique. Ces requêtes de recherche sont construites avec un ensemble d’opérateurs correspondant aux attributs des Posts et des utilisateurs, tels que des mots‑clés du message, des hashtags et des URL. Les opérateurs peuvent être combinés dans des requêtes avec une logique booléenne et des parenthèses pour affiner le comportement de correspondance des requêtes. Les endpoints de recherche récente et de recherche dans l’archive complète fournissent tous deux des metadata d’édition de Post. Tous les objets pour les Posts créés depuis le 29 septembre 2022 incluent des metadata d’édition de Post, même si le Post n’a jamais été modifié. Chaque fois qu’un Post est modifié, un nouvel ID de Post est créé. L’historique des modifications d’un Post est documenté par un tableau d’ID de Post, en commençant par l’ID d’origine. Ces endpoints renverront toujours la version la plus récente, accompagnée de tout l’historique des modifications. Tout Post collecté après sa fenêtre d’édition de 30 minutes représentera sa version finale. Pour en savoir plus sur les metadata d’édition de Post, consultez la page Principes de base des Posts modifiés. Une fois que vous avez configuré votre query et commencé à recevoir des Posts, ces endpoints permettent de parcourir les résultats à la fois par période temporelle et par plages d’ID de Post. Cela vise à prendre en charge deux cas d’usage courants :
  • Récupération d’historique : les requêtes portent sur une période d’intérêt, sans se concentrer sur l’aspect temps réel des données. Une seule requête est effectuée et toutes les données correspondantes sont renvoyées avec pagination si nécessaire. Il s’agit du mode par défaut pour Search Posts.
  • Polling ou écoute : les requêtes sont effectuées en mode « y a‑t‑il de nouveaux Posts depuis ma dernière requête ? ». Les requêtes sont envoyées en continu et, en général, l’objectif est une « écoute » quasi en temps réel des Posts d’intérêt.
De nombreux opérateurs et limites de query sont exclusifs à l’Enterprise access, ce qui signifie que vous devez utiliser des clés et des jetons d’une App au sein d’un Project avec un accès Enterprise pour bénéficier des fonctionnalités supplémentaires. Vous pouvez en savoir plus à ce sujet dans les sections d’endpoint ci‑dessous. Les Posts renvoyés par les endpoints de recherche récente et de recherche dans l’archive complète sont comptabilisés dans le Post cap mensuel. Configuration du compte Pour accéder à ces endpoints, vous aurez besoin de : Pour en savoir plus sur l’accès aux endpoints X API v2, consultez notre guide de démarrage. L’endpoint de recherche récente vous permet d’accéder par programmation à des Posts publics filtrés publiés au cours de la dernière semaine. Il est disponible pour tous les développeurs disposant d’un compte développeur et utilisant les clés et jetons d’une App au sein d’un Project. Vous pouvez authentifier vos requêtes avec le Contexte utilisateur OAuth 1.0a, OAuth 2.0 App-Only ou OAuth 2.0 Autorisation par code avec PKCE. Cependant, si vous souhaitez recevoir des métriques privées, ou une ventilation des métriques organiques et sponsorisées dans vos résultats de Post, vous devrez utiliser le Contexte utilisateur OAuth 1.0a ou OAuth 2.0 Autorisation par code avec PKCE, et transmettre des Access Tokens associés à l’utilisateur qui a publié le contenu concerné. Cet endpoint peut fournir jusqu’à 100 Posts par requête dans l’ordre antéchronologique, et des jetons de pagination sont fournis pour parcourir de grands ensembles de Posts correspondants. Lorsque vous utilisez un Project avec un accès standard, vous pouvez utiliser l’ensemble de base des opérateurs et effectuer des requêtes jusqu’à 512 caractères. Lorsque vous utilisez un Project avec un accès Enterprise, vous avez accès à des opérateurs supplémentaires. Les Projects avec un accès Enterprise peuvent effectuer des requêtes jusqu’à 4 096 caractères. En savoir plus sur les niveaux d’accès. L’endpoint de recherche v2 dans l’archive complète est uniquement disponible pour les Projects disposant d’un accès Pro et Enterprise. Cet endpoint vous permet d’accéder par programmation aux Posts publics de l’archive complète, depuis le premier Post de mars 2006, selon votre query de recherche. Vous pouvez authentifier vos requêtes vers cet endpoint avec OAuth 2.0 App-Only, et l’App Access Token doit provenir d’une App au sein d’un Project disposant d’un accès Pro ou Enterprise. Étant donné que vous ne pouvez pas effectuer de requêtes au nom d’autres utilisateurs (Contexte utilisateur OAuth 1.0a ou OAuth 2.0 Autorisation par code avec PKCE) avec cet endpoint, vous ne pourrez pas récupérer les métriques privées. Cet endpoint peut renvoyer jusqu’à 500 Posts par requête dans l’ordre antéchronologique, et des jetons de pagination sont fournis pour parcourir de grands ensembles de Posts correspondants. Remarque : si vous demandez des annotations via le paramètre tweet.fields, le paramètre max_results est actuellement limité à une valeur maximale de 100. Cela peut évoluer à l’avenir, mais veuillez tenir compte de cette limitation. Étant donné que cet endpoint est uniquement disponible pour les personnes ayant été approuvées pour un accès Pro et Enterprise, vous avez accès à l’ensemble complet des opérateurs de recherche et pouvez effectuer des requêtes jusqu’à 1 024 caractères.







Ressources d’assistance Apprenez à utiliser Postman pour effectuer des requêtes Résoudre une erreur Visiter la page de référence de l’API
⌘I