Passer au contenu principal
Cette page présente plusieurs outils et concepts essentiels pour vous aider à intégrer les endpoints de recherche de Posts dans votre système. Nous avons organisé la page en plusieurs sections :

​
Outils utiles

Avant d’aborder certains concepts clés, nous vous recommandons de vous familiariser avec les outils suivants : Postman
Postman est un excellent outil pour tester un endpoint, y compris chaque paramètre de chemin et de corps, afin de vous aider à comprendre ce qui est disponible. Consultez notre guide de prise en main de Postman pour en savoir plus. Exemples de code
Trouvez des exemples de code pour votre langage de programmation préféré sur notre page GitHub. Bibliothèques tierces
Exploitez des bibliothèques tierces créées par la communauté et compatibles avec les endpoints v2.

​
Concepts clés

​
Authentification

Tous les endpoints de la X API v2 nécessitent des requêtes authentifiées. Vous pouvez vous authentifier avec :
OAuth 1.0a peut être difficile à mettre en œuvre. Si vous ne le maîtrisez pas, envisagez d’utiliser une bibliothèque ou OAuth 2.0 pour vos requêtes. Pour les métriques privées ou les Posts, utilisez Contexte utilisateur OAuth 1.0a ou OAuth 2.0 Autorisation par code avec PKCE.
Veuillez noter
Si vous demandez les fields suivants, Contexte utilisateur OAuth 1.0a ou OAuth 2.0 Authorization Code est requis :
  • tweet.fields.non_public_metrics
  • tweet.fields.promoted_metrics
  • tweet.fields.organic_metrics
  • media.fields.non_public_metrics
  • media.fields.promoted_metrics
  • media.fields.organic_metrics

​
developer portal, Projects et Apps

Pour obtenir des identifiants pour X API v2, vous avez besoin de :
  1. D’un compte développeur approuvé.
  2. D’un Project au sein de ce compte développeur.
  3. D’une App développeur au sein de ce Project, où se trouvent les clés et jetons.

​
Limites de taux

Les requêtes vers la X API sont soumises à des limites de taux afin de gérer le volume. Des limites s’appliquent à la fois au niveau de l’App et de l’utilisateur :
  • Niveau App : limite le nombre de requêtes effectuées par période par une App.
  • Niveau utilisateur : limite la fréquence à laquelle un utilisateur authentifié peut effectuer des recherches de Post sur l’ensemble des Apps développeur.

​
fields et expansions

L’X API v2 permet de sélectionner des champs data spécifiques à l’aide de fields et expansions :
  • expansions : Permettent de récupérer des objets liés supplémentaires. Les expansions prises en charge incluent :
    • edit_history_tweet_ids
    • attachments.poll_ids
    • attachments.media_keys
    • author_id
    • entities.mentions.username
    • geo.place_id
    • in_reply_to_user_id
    • referenced_tweets.id
    • referenced_tweets.id.author_id
  • fields : Spécifient les champs data au sein des objets pour retourner des informations supplémentaires. L’Objet Post retourne par défaut id, text et edit_history_tweet_ids. D’autres options, comme tweet.created_at et tweet.entities, doivent être demandées explicitement.
Pour en savoir plus, consultez le guide sur les fields et expansions dans le X API v2 data dictionary.

​
Modifications de Posts

Les Posts éligibles peuvent être modifiés jusqu’à cinq fois dans les 30 minutes suivant leur publication. L’endpoint de consultation des Posts fournit toujours la version la plus récente du Post. Pour les cas d’utilisation quasi temps réel, tenez compte de cette fenêtre. Pour plus de détails, consultez Principes de base de la modification des Posts.

​
Cas particuliers

  • Métriques promues : La demande de métriques promues pour des Posts non promus renvoie une réponse vide.
  • Texte tronqué : Le texte du Post est tronqué pour les Retweets. Pour récupérer le texte complet, développez le Post référencé.
⌘I