Démarrage rapide de la timeline d’accueil

Obtenir la timeline d’accueil d’un utilisateur par ordre chronologique inverse

Ce guide vous explique comment effectuer votre première requête vers l’endpoint de la timeline d’accueil en ordre antéchronologique.

Prérequis

Avant de commencer, vous aurez besoin de :

• Un compte développeur avec une App approuvée
• Des jetons d’accès utilisateur (cet endpoint nécessite une authentification utilisateur)

---

​

Étape 1 : Récupérer l’ID de l’utilisateur

Vous avez besoin de l’ID de l’utilisateur du compte dont vous souhaitez récupérer le fil d’accueil. Trouvez-le à l’aide du point de terminaison de recherche par nom d’utilisateur :

cURL

shellscript

curl "https://api.x.com/2/users/by/username/XDevelopers" \
  -H "Authorization: Bearer $BEARER_TOKEN"

La réponse contient l’ID de l’utilisateur :

{
  "data": {
    "id": "2244994945",
    "name": "X Developers",
    "username": "XDevelopers"
  }
}

---

​

Étape 2 : Récupérer le fil d’accueil

Effectuez une requête GET avec l’ID de l’utilisateur et le User Access Token :

cURL

shellscript

curl "https://api.x.com/2/users/2244994945/timelines/reverse_chronological" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

---

​

Étape 3 : Examiner la réponse

{
  "data": [
    {
      "id": "1524796546306478083",
      "text": "Today marks the launch of Devs in the Details...",
      "edit_history_tweet_ids": ["1524796546306478083"]
    },
    {
      "id": "1524468552404668416",
      "text": "Join us tomorrow for a discussion about bots...",
      "edit_history_tweet_ids": ["1524468552404668416"]
    }
  ],
  "meta": {
    "result_count": 2,
    "newest_id": "1524796546306478083",
    "oldest_id": "1524468552404668416",
    "next_token": "7140dibdnow9c7btw421dyz6jism75z99gyxd8egarsc4"
  }
}

---

​

Étape 4 : Ajouter des champs et des expansions

Demandez des données supplémentaires avec des paramètres de requête :

cURL

shellscript

curl "https://api.x.com/2/users/2244994945/timelines/reverse_chronological?\
tweet.fields=created_at,public_metrics,author_id&\
expansions=author_id&\
user.fields=username,verified&\
max_results=10" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

---

​

Étape 5 : parcourir les résultats paginés

Les SDK gèrent la pagination automatiquement. Avec cURL, utilisez le next_token de la réponse pour obtenir davantage de résultats :

curl "https://api.x.com/2/users/2244994945/timelines/reverse_chronological?\
max_results=10&\
pagination_token=7140dibdnow9c7btw421dyz6jism75z99gyxd8egarsc4" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

---

​

Paramètres courants

Paramètre	Description	Valeur par défaut
max_results	Résultats par page (1-100)	10
start_time	Horodatage de la Publication la plus ancienne (ISO 8601)	—
end_time	Horodatage de la Publication la plus récente (ISO 8601)	—
since_id	Renvoie les Publications après cet ID	—
until_id	Renvoie les Publications avant cet ID	—
exclude	Exclut les retweets, les replies ou les deux	—

---

​

Prochaines étapes

Mentions d’utilisateur

Récupérer les Publications qui mentionnent un utilisateur

Guide d’intégration

Concepts clés et meilleures pratiques

Référence de l’API

Documentation complète de l’endpoint

Guide de pagination

Parcourir de grands ensembles de résultats