Passer au contenu principal
Ce guide vous explique comment récupérer vos Publications qui ont été retweetées par d’autres utilisateurs.
PrérequisAvant de commencer, vous aurez besoin de :
  • d’un compte développeur avec une App approuvée
  • d’un jeton d’accès utilisateur (OAuth 1.0a ou OAuth 2.0 PKCE)

Pourquoi utiliser Retweets of Me ?

L’endpoint Retweets of Me vous aide à :
  • Suivre l’engagement — voir quelles de vos Publications sont partagées
  • Comprendre la résonance — découvrir quels contenus trouvent un écho auprès de votre audience
  • Orienter votre stratégie — ajuster votre stratégie de contenu en fonction des tendances de partage

Récupérer vos Publications retweetées

cURL
curl "https://api.x.com/2/users/reposts_of_me?\
tweet.fields=created_at,public_metrics&\
max_results=10" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

Réponse

{
  "data": [
    {
      "id": "1848781937210802364",
      "text": "ever wanted to discover trends.. before they're trends?...",
      "created_at": "2024-01-15T10:30:00.000Z",
      "public_metrics": {
        "retweet_count": 42,
        "reply_count": 5,
        "like_count": 156,
        "quote_count": 8
      },
      "edit_history_tweet_ids": ["1848781937210802364"]
    },
    {
      "id": "1847990559081648620",
      "text": "posting is just journaling with an audience",
      "created_at": "2024-01-14T15:20:00.000Z",
      "public_metrics": {
        "retweet_count": 28,
        "reply_count": 12,
        "like_count": 89,
        "quote_count": 3
      },
      "edit_history_tweet_ids": ["1847990559081648620"]
    }
  ],
  "meta": {
    "result_count": 2,
    "next_token": "7140dibdnow9c7btw481s8m561gat797rboud5r80xvzm"
  }
}

Filtrer par plage temporelle

Obtenez les Publications retweetées sur une période spécifique :
cURL
curl "https://api.x.com/2/users/reposts_of_me?\
start_time=2024-01-01T00%3A00%3A00Z&\
end_time=2024-01-31T23%3A59%3A59Z&\
tweet.fields=created_at,public_metrics" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

Paramètres communs

ParamètreDescriptionValeur par défaut
max_resultsRésultats par page (1-100)10
start_timeHorodatage de la Publication la plus ancienne (ISO 8601)
end_timeHorodatage de la Publication la plus récente (ISO 8601)
pagination_tokenJeton pour la page suivante
tweet.fieldsChamps supplémentaires pour la Publicationid, text

Prochaines étapes

Recherche de Retweets

Voir qui a Retweeté une Publication

Gérer les Retweets

Retweeter et annuler des Retweets

Référence de l’API

Documentation complète du point de terminaison