v1 para v2

​

Consulta de Posts da List: Standard v1.1 comparado com X API v2

• Semelhanças
  • Métodos de autenticação
  • Rate limits
• Diferenças
  • URLs dos endpoints
  • Requisitos de App e Project
  • Limites de objetos de dados por requisição
  • Formatos dos dados de resposta
  • Parâmetros da requisição

​

Semelhanças

​

Diferenças

• Endpoints do standard v1.1:
  • GET https://api.x.com/1.1/lists/statuses.json (Consultar Tweets de uma List específica)
• Endpoint da X API v2:
  • GET https://api.x.com/2/lists/:id/tweets (Consultar Tweets de uma List específica)

• attachments
• author_id
• context_annotations
• created_at
• geo
• lang

• No nível raiz do JSON, os endpoints standard retornam objetos Post em um array statuses, enquanto a X API v2 retorna um array data.
• Em vez de se referir a “statuses” Retweeted e Quoted, o JSON da X API v2 refere-se a Retweeted e Quoted Tweets. Muitos fields legados e obsoletos, como contributors e user.translator_type, estão sendo removidos.
• Em vez de usar tanto favorites (no objeto Post) quanto favourites (no objeto user), a X API v2 usa o termo like.
• A X está adotando a convenção de que valores JSON sem valor (por exemplo, null) não são incluídos no payload. Atributos de Post e user só são incluídos quando têm valores não nulos.

​

Exemplos de código

​

Obter Posts de uma List (v2)

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")

# Obter Posts de uma List
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" });

// Obter Posts de uma List
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)}...`);
  });
}