Recherche de Retweets

Ce guide vous explique comment récupérer les utilisateurs qui ont retweeté une Publication spécifique.

PrérequisAvant de commencer, vous aurez besoin de :

D’un compte développeur avec une App approuvée
Du jeton Bearer de votre App (pour les données publiques) ou d’un User Access Token (pour les métriques privées)

Récupérer les utilisateurs qui ont retweeté une Publication

Trouver l’ID de la Publication

Récupérez l’ID de la Publication dont vous voulez lister les Retweets :

https://x.com/XDevelopers/status/1354143047324299264
                                └── Ceci est l’ID de la Publication

Effectuer la requête

cURL

curl "https://api.x.com/2/tweets/1354143047324299264/retweeted_by?\
user.fields=created_at,username,verified" \
  -H "Authorization: Bearer $BEARER_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Récupérer les utilisateurs qui ont retweeté une Publication avec pagination
for page in client.posts.get_retweeted_by(
    "1354143047324299264",
    user_fields=["created_at", "username", "verified"]
):
    for user in page.data:
        print(f"{user.username} - Inscription : {user.created_at}")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });

// Récupérer les utilisateurs qui ont retweeté une Publication avec pagination
const paginator = client.posts.getRetweetedBy("1354143047324299264", {
  userFields: ["created_at", "username", "verified"],
});

for await (const page of paginator) {
  page.data?.forEach((user) => {
    console.log(`${user.username} - Inscription : ${user.created_at}`);
  });
}

Examiner la réponse

{
  "data": [
    {
      "created_at": "2008-12-04T18:51:57.000Z",
      "id": "17874544",
      "username": "TwitterSupport",
      "name": "Twitter Support",
      "verified": true
    },
    {
      "created_at": "2007-02-20T14:35:54.000Z",
      "id": "783214",
      "username": "Twitter",
      "name": "Twitter",
      "verified": true
    }
  ],
  "meta": {
    "result_count": 2,
    "next_token": "7140dibdnow9c7btw3z2vwioavpvutgzrzm9icis4ndix"
  }
}

Inclure des données supplémentaires

Utilisez le paramètre expansions pour récupérer des données associées, comme les Publications épinglées :

cURL

curl "https://api.x.com/2/tweets/1354143047324299264/retweeted_by?\
user.fields=created_at&\
expansions=pinned_tweet_id&\
tweet.fields=created_at" \
  -H "Authorization: Bearer $BEARER_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Récupérer les utilisateurs qui retweetent avec le paramètre expansions
for page in client.posts.get_retweeted_by(
    "1354143047324299264",
    user_fields=["created_at"],
    expansions=["pinned_tweet_id"],
    tweet_fields=["created_at"]
):
    for user in page.data:
        print(f"{user.username}")
    # Les Publications épinglées se trouvent dans page.includes.tweets

import { Client } from "@xdevplatform/xdk";

const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });

// Récupérer les utilisateurs qui retweetent avec le paramètre expansions
const paginator = client.posts.getRetweetedBy("1354143047324299264", {
  userFields: ["created_at"],
  expansions: ["pinned_tweet_id"],
  tweetFields: ["created_at"],
});

for await (const page of paginator) {
  page.data?.forEach((user) => {
    console.log(user.username);
  });
  // Les Publications épinglées se trouvent dans page.includes?.tweets
}

Réponse avec extensions

{
  "data": [
    {
      "pinned_tweet_id": "1389270063807598594",
      "created_at": "2018-11-21T14:24:58.000Z",
      "id": "1065249714214457345",
      "username": "TwitterSpaces",
      "name": "Spaces"
    }
  ],
  "includes": {
    "tweets": [
      {
        "created_at": "2021-05-03T17:26:09.000Z",
        "id": "1389270063807598594",
        "text": "now, everyone with 600 or more followers can host a Space..."
      }
    ]
  }
}

Prochaines étapes

Gérer les Retweets

Retweeter et annuler des retweets

Citer des Publications

Obtenir des Publications citées

Référence de l’API

Documentation complète de l’endpoint

Vue d’ensemble

Publications

Utilisateurs

Messages privés

Mentions J’aime

Listes

Espaces

Communautés

Notes de la communauté

Tendances

Actualités

Médias

Activité sur X

Utilisation

Connexions de flux

Conformité

Enterprise v2

Flux des J’aime

GNIP 2.0

Recherche de Retweets

Récupérer les utilisateurs qui ont retweeté une Publication

Inclure des données supplémentaires

Réponse avec extensions

Prochaines étapes

Gérer les Retweets

Citer des Publications

Référence de l’API