Vue d’ensemble

Comparaison des endpoints de timelines de X API

Les endpoints de timeline chronologique inversée, de timeline des Publications d’un utilisateur et de timeline des mentions d’un utilisateur de la v2 remplacent respectivement les endpoints v1.1 statuses/home_timeine, v1.1 statuses/user_timeline et v1.1 statuses/mentions_timeline. Si vous avez du code, des applications ou des outils qui utilisent une ancienne version de cet endpoint et que vous envisagez de migrer vers le nouvel endpoint X API v2, ce guide est fait pour vous. Pour un guide de migration plus détaillé, consultez Migration Standard v1.1 vers X API v2.

Cette page contient trois tableaux de comparaison :

• Timeline d’accueil en ordre chronologique inversé
• Timeline des Publications d’un utilisateur
• Timeline des mentions d’un utilisateur

Fil d’accueil en ordre antéchronologique

Les tableaux suivants comparent les endpoints standard du fil d’accueil en v1.1 et dans X API v2 :

Description	Standard v1.1	X API v2
Documentation	Référence de l’API	Référence de l’API
Méthodes HTTP prises en charge	GET	GET
Domaine d’hébergement	https://api.x.com	https://api.x.com
Chemins des endpoints	/1.1/statuses/home_timeline.json	/2/users/:id/timelines/reverse_chronological
Paramètres requis	user_id or screen_name	ID utilisateur, défini comme paramètre de chemin :id
Authentification	Contexte utilisateur OAuth 1.0a	Contexte utilisateur OAuth 1.0a Flux de code d’autorisation OAuth 2.0 avec PKCE
Limites de taux des requêtes	15 requêtes par fenêtre de 15 minutes avec un contexte utilisateur OAuth 1.0a Plafond de requêtes : 100 000 sur 24 heures.	180 requêtes par fenêtre de 15 minutes
Nombre de Publications renvoyées par réponse par défaut	15	100
Nombre maximal de Publications par réponse	800	Cet endpoint renvoie chaque Publication créée sur une timeline au cours des 7 derniers jours, ainsi que les 800 plus récentes, quelle que soit leur date de création.
Fournit l’historique des modifications de la Publication	✔	✔
Publications historiques disponibles	Les 800 Publications les plus récentes, y compris les Retweets	Les 3 200 Publications les plus récentes, y compris les Retweets
Options de navigation de la timeline	since_id (exclu) utilisé pour l’interrogation périodique des mises à jour max_id (inclus)	start_time end_time since_id (exclusif) utilisé pour l’interrogation des mises à jour until_id (exclusif)
Paramètres optionnels pour affiner les résultats	count exclude_replies include_rts trim_user tweet_mode since_id max_id	max_results exclude(retweets,replies) tweet.fields user.fields place.fields media.fields poll.fields expansions start_time end_time since_id until_id
Prend en charge la demande et la réception d’annotations	N/A	Si des annotations sont incluses dans tweet.fields, les résultats seront annotés avec des données d’annotation déduites à partir du texte de la Publication, telles que « Music Genre » et « Folk Music » ou « Musician » et « Dolly Parton ».
Permet de demander et de recevoir des métriques spécifiques à une Publication	N/A	Si des annotations sont incluses dans tweet.fields, les résultats seront annotés avec des public_metrics par Publication, y compris retweet_count, reply_count, quote_count et like_count, ainsi qu’avec des non_public_metrics, notamment impression_count, user_profile_clicks et url_link_clicks. Des métriques supplémentaires pour les médias, comme view_count et les métriques de lecture vidéo. Des organic_metrics et promoted_metrics supplémentaires sont disponibles avec User Context pour les Publications sponsorisées.
Prend en charge la demande et la réception de conversation_id	N/A	Renvoie un champ conversation_id dont la valeur correspond à la première Publication publiée dans un fil de réponses afin de vous aider à suivre les conversations.
Format JSON de la Publication	Format de données standard v1.1	Format X API v2 (déterminé par les paramètres de requête fields et expansions, non rétrocompatible avec les formats v1.1) Pour en savoir plus sur la migration du format Standard v1.1 vers le format X API v2, consultez notre guide de migration des formats de données.
Ordre des résultats	Inversement chronologique	Inversement chronologique
Pagination des résultats	N/A ; vous devez utiliser la navigation par ID de Publication	Les résultats peuvent être parcourus vers l’avant ou vers l’arrière à l’aide d’un pagination_token
Nécessite l’utilisation d’identifiants d’une App développeur associée à un Project		✔

Timeline des Publications d’un utilisateur

Les tableaux suivants comparent les endpoints de la timeline des Publications d’un utilisateur pour la version standard v1.1 et pour X API v2 :

Description	Standard v1.1	X API v2
Documentation	Référence de l’API	Référence de l’API
Méthodes HTTP prises en charge	GET	GET
Domaine d’hébergement	https://api.x.com	https://api.x.com
Chemins d’endpoint	/1.1/statuses/user_timeline.json	/2/users/:id/tweets
Paramètres obligatoires	user_id ou screen_name	ID d’utilisateur défini en tant que paramètre de chemin :id
Authentification	Contexte utilisateur OAuth 1.0a OAuth 2.0 App uniquement	Contexte utilisateur OAuth 1.0a OAuth 2.0 App uniquement OAuth 2.0 Authorization Code avec PKCE
Limites de taux des requêtes	900 requêtes par fenêtre de 15 minutes avec le contexte utilisateur OAuth 1.0a 1500 requêtes par fenêtre de 15 minutes avec OAuth 2.0 App uniquement Plafond de requêtes : 100 000 sur une période de 24 heures.	900 requêtes par fenêtre de 15 minutes avec le contexte utilisateur OAuth 1.0a 1500 requêtes par fenêtre de 15 minutes avec OAuth 2.0 App uniquement
Nombre de Publications par réponse par défaut	15	10
Nombre maximal de Publications par réponse	200	100
Publications historiques disponibles	Les 3 200 Publications les plus récentes, y compris les retweets	Les 3 200 Publications les plus récentes, y compris les retweets
Options de navigation dans la timeline	since_id (exclusif) utilisé pour le polling des mises à jour max_id (inclusif)	start_time end_time since_id (exclusif) utilisé pour le polling des mises à jour until_id (exclusif)
Paramètres facultatifs pour affiner les résultats	count exclude_replies include_rts trim_user tweet_mode since_id max_id	max_results exclude(retweets,replies) tweet.fields user.fields place.fields media.fields poll.fields expansions start_time end_time since_id until_id
Prend en charge la demande et la réception d’annotations	N/A	Renvoie des résultats de Publications avec des données d’annotation déduites à partir du texte de la Publication, telles que « Music Genre » et « Folk Music » ou « Musician » et « Dolly Parton »
Prend en charge la demande et la réception de métriques spécifiques à la Publication	N/A	Renvoie des résultats de Publications avec les public_metrics disponibles par Publication, y compris retweet_count, reply_count, quote_count et like_count. Disponible avec le contexte utilisateur OAuth 1.0a : des non_public_metrics supplémentaires, y compris impression_count, user_profile_clicks, url_link_clicks. Des métriques de média supplémentaires telles que view_count et les métriques de lecture vidéo. Des organic_metrics et promoted_metrics supplémentaires disponibles avec le contexte utilisateur OAuth 1.0a pour les Publications sponsorisées.
Prend en charge la demande et la réception de conversation_id	N/A	Renvoie un champ conversation_id dont la valeur représente la première Publication publiée dans un fil de réponses, pour vous aider à suivre les conversations.
Format JSON de la Publication	Format de données Standard v1.1	Format X API v2 (déterminé par les paramètres de requête fields et expansions, non rétrocompatible avec les formats v1.1) Pour en savoir plus sur la façon de migrer du format Standard v1.1 vers le format X API v2, consultez notre guide de migration des formats de données.
Ordre des résultats	Antéchronologique	Antéchronologique
Pagination des résultats	N/A, la navigation doit se faire par ID de Publication	Les résultats peuvent être parcourus vers l’avant ou vers l’arrière à l’aide d’un pagination_token
Nécessite l’utilisation d’identifiants provenant d’une App développeur associée à un Project		✔
Fournit l’historique des modifications de la Publication	✔	✔

Chronologie des mentions d’utilisateur

Les tableaux suivants comparent les endpoints de chronologie des mentions d’utilisateur Standard v1.1 et X API v2

Description	Standard v1.1	X API v2
Documentation	Référence de l’API	Référence de l’API
Méthodes HTTP prises en charge	GET	GET
Domaine de l’hôte	https://api.x.com	https://api.x.com
Chemins d’endpoint	/1.1/statuses/mentions_timeline.json	/2/users/:id/mentions
Paramètres obligatoires	aucun paramètre obligatoire	id d’utilisateur défini comme paramètre de chemin :id
Authentification	OAuth 1.0a User Context	OAuth 1.0a User Context OAuth 2.0 App-Only OAuth 2.0 Authorization Code with PKCE
Limites de taux de requêtes par défaut	75 requêtes par période de 15 min avec OAuth 1.0a User Context Plafond de 100 000 requêtes sur une période de 24 heures.	180 requêtes par fenêtre de 15 minutes avec OAuth 1.0a User Context 450 requêtes par fenêtre de 15 minutes avec OAuth 2.0 App-Only
Nombre de Publications par réponse par défaut	15	10
Nombre maximal de Publications par réponse	200	100
Publications historiques disponibles	Les 800 Publications les plus récentes	Les 800 Publications les plus récentes
Options de navigation dans la chronologie	since_id (exclusif) utilisé pour l’interrogation des mises à jour max_id (inclusif)	start_time end_time since_id (exclusif) utilisé pour l’interrogation des mises à jour until_id (exclusif)
Paramètres facultatifs pour affiner les résultats	count trim_user include_entities tweet_mode since_id max_id	max_results tweet.fields user.fields place.fields media.fields poll.fields expansions start_time end_time since_id until_id
Prend en charge la demande et la réception d’annotations	N/A	Renvoie des résultats de Publications avec des données d’annotation déduites à partir du texte de la Publication, telles que « Genre musical » et « Musique folk » ou « Musicien » et « Dolly Parton »
Prend en charge la demande et la réception de métriques spécifiques à une Publication	N/A	Renvoie des résultats de Publication avec les public_metrics disponibles par Publication, y compris retweet_count, reply_count, quote_count et like_count. Disponible avec OAuth 1.0a User Context : Des non_public_metrics supplémentaires, notamment impression_count, user_profile_clicks, url_link_clicks. Des métriques média supplémentaires telles que view_count et les métriques de lecture vidéo. Des organic_metrics et promoted_metrics supplémentaires sont disponibles avec OAuth 1.0a User Context pour les Publications promues
Prend en charge la demande et la réception de conversation_id	N/A	Renvoie un champ conversation_id dont la valeur représente la première Publication publiée dans un fil de réponses afin de vous aider à suivre les conversations.
Format JSON de la Publication	Format de données Standard v1.1	Format X API v2 (déterminé par les paramètres de requête fields et expansions, non compatible avec les formats v1.1) Pour en savoir plus sur la migration du format Standard v1.1 vers le format X API v2, veuillez consulter notre guide de migration des formats de données.
Ordre des résultats	Antéchronologique	Antéchronologique
Paramètres de requête pour la pagination	N/A, navigation par ID de Publication obligatoire	Les résultats peuvent être consultés en avançant ou en reculant à l’aide de pagination_token
Nécessite l’utilisation d’identifiants issus d’une App de développeur associée à un Project		✔
Fournit l’historique des modifications de la Publication	✔	✔

Autres ressources de migration

Recherche de Publications : Standard v1.1 vers X API v2

Hub de migration de X API