Démarrage rapide de la timeline d’accueil

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

PrérequisAvant 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

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

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

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

const response = await client.users.getByUsername("XDevelopers");
console.log(`User ID: ${response.data?.id}`);

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

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

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# Récupérer le fil d’accueil avec pagination
for page in client.posts.get_home_timeline("2244994945"):
    for post in page.data:
        print(post.text)

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

const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });

// Récupérer le fil d’accueil avec pagination
const paginator = client.posts.getHomeTimeline("2244994945");

for await (const page of paginator) {
  page.data?.forEach((post) => {
    console.log(post.text);
  });
}

É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

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"

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# Récupérez le fil d’accueil avec champs et expansions
for page in client.posts.get_home_timeline(
    "2244994945",
    tweet_fields=["created_at", "public_metrics", "author_id"],
    expansions=["author_id"],
    user_fields=["username", "verified"],
    max_results=10
):
    for post in page.data:
        print(f"{post.text[:50]}... - Likes: {post.public_metrics.like_count}")

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

const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });

// Récupérez le fil d’accueil avec champs et expansions
const paginator = client.posts.getHomeTimeline("2244994945", {
  tweetFields: ["created_at", "public_metrics", "author_id"],
  expansions: ["author_id"],
  userFields: ["username", "verified"],
  maxResults: 10,
});

for await (const page of paginator) {
  page.data?.forEach((post) => {
    console.log(`${post.text?.slice(0, 50)}... - Likes: ${post.public_metrics?.like_count}`);
  });
}

É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

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

Démarrage rapide de la timeline d’accueil

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

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

Étape 3 : Examiner la réponse

Étape 4 : Ajouter des champs et des expansions

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

Paramètres courants

Prochaines étapes

Mentions d’utilisateur

Guide d’intégration

Référence de l’API

Guide de pagination