v1 vers v2

Consultation des publications d’une Liste : standard v1.1 comparé à X API v2

Si vous utilisez le endpoint standard v1.1 GET lists/statuses, l’objectif de ce guide est de vous aider à comprendre les similitudes et les différences entre les endpoints standard v1.1 et X API v2.

Similitudes
- Méthodes d’authentification
- Limites de taux
Différences
- URLs des endpoints
- Exigences relatives à l’App et au projet
- Nombre maximal d’objets de données par requête
- Formats des données de réponse
- Paramètres de requête

Similarités

Authentification Les deux versions de l’endpoint prennent en charge OAuth 1.0a User Context. Par conséquent, si vous utilisiez auparavant l’un des endpoints standard v1.1 de recherche de Publications dans une Liste, vous pouvez continuer à utiliser la même méthode d’authentification si vous migrez vers la version X API v2. Selon la bibliothèque/package d’authentification de votre choix, l’authentification App only est probablement la façon la plus simple de commencer et peut être configurée avec un simple en-tête de requête. Pour savoir comment générer un Access Token App only, consultez ce guide App only. Limites de taux


Standard v1.1	X API v2
/1.1/lists/statuses.json 900 requêtes par fenêtre de 15 minutes avec OAuth 1.0a User Context 900 requêtes par fenêtre de 15 minutes avec App only	/2/lists/:id/tweets 900 requêtes par fenêtre de 15 minutes avec OAuth 1.0a User Context 900 requêtes par fenêtre de 15 minutes avec OAuth 2.0 Authorization Code with PKCE 900 requêtes par fenêtre de 15 minutes avec App only

Différences

URLs d’endpoint

Endpoints standard v1.1 :
- GET https://api.x.com/1.1/lists/statuses.json (Recherche de Tweets à partir d’une Liste spécifiée)
Endpoint X API v2 :
- GET https://api.x.com/2/lists/:id/tweets (Recherche de Tweets à partir d’une Liste spécifiée)

Exigences pour les App et les Projets Les endpoints X API v2 exigent que vous utilisiez des informations d’identification issues d’une App développeur associée à un Project lors de l’authentification de vos requêtes. Tous les endpoints X API v1.1 peuvent utiliser des informations d’identification provenant d’App ou d’App associées à un projet. Limites d’objets de données par requête L’endpoint standard v1.1 /lists/statuses vous permet de récupérer jusqu’à 5000 Publications par requête. Les nouveaux endpoints v2 vous permettent de récupérer jusqu’à 100 Publications par requête. Par défaut, 100 objets user sont renvoyés. Pour modifier le nombre de résultats, vous devez passer un paramètre de requête max_results= avec une valeur comprise entre 1 et 100 ; vous pouvez ensuite transmettre le next_token renvoyé dans le corps de la réponse au paramètre de requête pagination_token dans votre requête suivante. Format des données de réponse L’une des plus grandes différences entre les versions d’endpoint standard v1.1 et X API v2 est la manière dont vous sélectionnez les champs renvoyés dans votre charge utile. Pour les endpoints standard, vous recevez de nombreux champs de réponse par défaut, avec ensuite la possibilité d’utiliser des paramètres pour identifier les champs supplémentaires ou les ensembles de champs qui doivent être renvoyés dans la charge utile. La version X API v2 ne fournit par défaut que les champs id et text de la Publication. Pour demander des champs ou des objets supplémentaires, vous devrez utiliser les paramètres fields et expansions. Tous les champs de Publication que vous demandez à partir de cet endpoint seront renvoyés dans l’objet principal de Publication. Tous les champs d’objets étendus seront renvoyés dans un objet includes au sein de votre réponse. Vous pouvez ensuite faire correspondre tout objet étendu à l’objet principal de Publication en faisant correspondre les ID de l’objet principal et des objets étendus. Voici des exemples de champs de Publication et d’expansions possibles :

attachments
author_id
context_annotations
created_at
geo
lang


Endpoint	Expansion
/2/lists/:id/tweets	author_id

Nous vous encourageons à en apprendre davantage sur ces nouveaux paramètres dans leurs guides respectifs, ou en lisant notre guide sur comment utiliser les fields et expansions. Nous avons également élaboré un guide de migration de format de données qui peut vous aider à faire correspondre les champs standard v1.1 aux nouveaux champs v2. Ce guide vous fournira également le paramètre d’expansion et de field spécifique que vous devrez transmettre avec votre requête v2 pour renvoyer des champs spécifiques. En plus des changements relatifs à la manière de demander certains champs, X API v2 introduit également de nouveaux modèles JSON pour les objets renvoyés par les API, y compris les objets Post et user.

Au niveau racine JSON, les endpoints standard renvoient les objets de Publication dans un tableau statuses, tandis que X API v2 renvoie un tableau data.
Au lieu de faire référence aux « statuses » Retweeted et Quoted, le JSON X API v2 fait référence aux Tweets Retweeted et Quoted. De nombreux champs hérités et obsolètes, tels que contributors et user.translator_type, sont supprimés.
Au lieu d’utiliser à la fois favorites (dans l’objet de Publication) et favourites (dans l’objet user), X API v2 utilise le terme like.
X adopte la convention selon laquelle les valeurs JSON sans valeur (par exemple, null) ne sont pas écrites dans la charge utile. Les attributs de Publication et de user ne sont inclus que s’ils ont des valeurs non nulles.

Paramètres de requête Les paramètres de requête standard v1.1 suivants ont des équivalents dans X API v2 :


Standard v1.1	X API v2
list_id	id
slug	Aucun équivalent
owner_screen_name	Aucun équivalent
owner_id	Demandé avec le paramètre expansions avec la valeur author_id
since_id	Aucun équivalent
max_id	Aucun équivalent
include_entities	Demandé avec le paramètre tweet.fields avec la valeur entities
include_rts	Aucun équivalent
count	max_results

Exemples de code

Récupérer des Publications d’une Liste (v2)

cURL

curl "https://api.x.com/2/lists/84839422/tweets?tweet.fields=created_at,public_metrics&max_results=100" \
  -H "Authorization: Bearer $BEARER_TOKEN"

import requests

bearer_token = "YOUR_BEARER_TOKEN"
url = "https://api.x.com/2/lists/84839422/tweets"

params = {
    "tweet.fields": "created_at,public_metrics",
    "max_results": 100
}
headers = {"Authorization": f"Bearer {bearer_token}"}

response = requests.get(url, headers=headers, params=params)
print(response.json())

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Récupérer des Publications d'une Liste
for page in client.lists.get_tweets(
    "84839422",
    tweet_fields=["created_at", "public_metrics"],
    max_results=100
):
    for post in page.data:
        print(f"{post.created_at}: {post.text[:50]}...")

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

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

// Récupérer des Publications d'une Liste
const paginator = client.lists.getTweets("84839422", {
  tweetFields: ["created_at", "public_metrics"],
  maxResults: 100,
});

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

Getting Started

Fundamentals

Partners & Customers

Resources

v1 vers v2

Consultation des publications d’une Liste : standard v1.1 comparé à X API v2

Similarités

Différences

Exemples de code

Récupérer des Publications d’une Liste (v2)

​Consultation des publications d’une Liste : standard v1.1 comparé à X API v2

​Similarités

​Différences

​Exemples de code

​Récupérer des Publications d’une Liste (v2)

Consultation des publications d’une Liste : standard v1.1 comparé à X API v2

Similarités

Différences

Exemples de code

Récupérer des Publications d’une Liste (v2)