Quickstart

Este guia mostra como fazer sua primeira requisição de Post lookup usando a X API v2.

Pré-requisitosAntes de começar, você precisará de:

Uma conta de desenvolvedor com um App aprovado
O Bearer Token do seu App (encontrado no Developer Console em “Keys and tokens”)

Encontre um ID de Post

Cada Post tem um ID único. Você pode encontrá-lo na URL do Post:

https://x.com/XDevelopers/status/1228393702244134912
                                └── Este é o ID do Post

Faça uma requisição

cURL

curl "https://api.x.com/2/tweets/1228393702244134912" \
  -H "Authorization: Bearer $BEARER_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Obter um único Post por ID
response = client.posts.get("1228393702244134912")
print(response.data)

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

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

const response = await client.posts.get("1228393702244134912");
console.log(response.data);

Revise a resposta

A resposta padrão inclui id, text e edit_history_tweet_ids do Post:

{
  "data": {
    "id": "1228393702244134912",
    "text": "What did the developer write in their Valentine's card?\n\nwhile(true) {\n    I = Love(You);\n}",
    "edit_history_tweet_ids": ["1228393702244134912"]
  }
}

Solicite fields adicionais

Use query parameters para obter mais dados:

cURL

curl "https://api.x.com/2/tweets/1228393702244134912?\
tweet.fields=created_at,public_metrics,author_id&\
expansions=author_id&\
user.fields=username,verified" \
  -H "Authorization: Bearer $BEARER_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Obter um Post com fields e expansions adicionais
response = client.posts.get(
    "1228393702244134912",
    tweet_fields=["created_at", "public_metrics", "author_id"],
    expansions=["author_id"],
    user_fields=["username", "verified"]
)

print(response.data)
print(response.includes)  # Contém o objeto user do autor

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

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

const response = await client.posts.get("1228393702244134912", {
  tweetFields: ["created_at", "public_metrics", "author_id"],
  expansions: ["author_id"],
  userFields: ["username", "verified"],
});

console.log(response.data);
console.log(response.includes); // Contém o objeto user do autor

Resposta:

Exemplo de resposta

{
  "data": {
    "id": "1228393702244134912",
    "text": "What did the developer write in their Valentine's card?...",
    "created_at": "2020-02-14T19:00:55.000Z",
    "author_id": "2244994945",
    "public_metrics": {
      "retweet_count": 156,
      "reply_count": 23,
      "like_count": 892,
      "quote_count": 12
    },
    "edit_history_tweet_ids": ["1228393702244134912"]
  },
  "includes": {
    "users": [
      {
        "id": "2244994945",
        "username": "XDevelopers",
        "verified": true
      }
    ]
  }
}

Consultar múltiplos Posts

Recupere até 100 Posts em uma única requisição:

cURL

curl "https://api.x.com/2/tweets?\
ids=1228393702244134912,1227640996038684673,1199786642791452673&\
tweet.fields=created_at,author_id" \
  -H "Authorization: Bearer $BEARER_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Obter múltiplos Posts por IDs
response = client.posts.get_posts(
    ids=["1228393702244134912", "1227640996038684673", "1199786642791452673"],
    tweet_fields=["created_at", "author_id"]
)

for post in response.data:
    print(f"{post.id}: {post.text[:50]}...")

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

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

const response = await client.posts.getPosts({
  ids: ["1228393702244134912", "1227640996038684673", "1199786642791452673"],
  tweetFields: ["created_at", "author_id"],
});

response.data?.forEach((post) => {
  console.log(`${post.id}: ${post.text?.slice(0, 50)}...`);
});

Próximos passos

Guia de integração

Aprenda autenticação, rate limits e melhores práticas

Fields e expansions

Domine o sistema de fields e expansions

Referência da API

Veja todos os parâmetros disponíveis

Código de exemplo

Explore mais exemplos

Getting Started

Products

Fundamentals

Partners & Customers

Resources

Quickstart

Próximos passos

Guia de integração

Fields e expansions

Referência da API

Código de exemplo

​Próximos passos

Guia de integração

Fields e expansions

Referência da API

Código de exemplo

Próximos passos