Reposts of Me

Este guia mostra como recuperar seus Posts que foram Retweetados por outros.

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

Uma conta de desenvolvedor com um App aprovado
User Access Token (OAuth 1.0a ou OAuth 2.0 PKCE)

Por que usar Reposts of Me?

O endpoint Reposts of Me ajuda você a:

Acompanhar engajamento — Veja quais dos seus Posts estão sendo compartilhados
Entender o alcance — Aprenda qual conteúdo ressoa com o seu público
Informar a estratégia — Ajuste sua estratégia de conteúdo com base nos padrões de compartilhamento

Obtenha seus Posts Retweetados

cURL

curl "https://api.x.com/2/users/reposts_of_me?\
tweet.fields=created_at,public_metrics&\
max_results=10" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# Obter seus Posts que foram Retweetados
for page in client.posts.get_reposts_of_me(
    tweet_fields=["created_at", "public_metrics"],
    max_results=10
):
    for post in page.data:
        print(f"{post.text[:50]}... - Retweets: {post.public_metrics.retweet_count}")

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

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

// Obter seus Posts que foram Retweetados
const paginator = client.posts.getRepostsOfMe({
  tweetFields: ["created_at", "public_metrics"],
  maxResults: 10,
});

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

Resposta

Exemplo de resposta

{
  "data": [
    {
      "id": "1848781937210802364",
      "text": "ever wanted to discover trends.. before they're trends?...",
      "created_at": "2024-01-15T10:30:00.000Z",
      "public_metrics": {
        "retweet_count": 42,
        "reply_count": 5,
        "like_count": 156,
        "quote_count": 8
      },
      "edit_history_tweet_ids": ["1848781937210802364"]
    },
    {
      "id": "1847990559081648620",
      "text": "posting is just journaling with an audience",
      "created_at": "2024-01-14T15:20:00.000Z",
      "public_metrics": {
        "retweet_count": 28,
        "reply_count": 12,
        "like_count": 89,
        "quote_count": 3
      },
      "edit_history_tweet_ids": ["1847990559081648620"]
    }
  ],
  "meta": {
    "result_count": 2,
    "next_token": "7140dibdnow9c7btw481s8m561gat797rboud5r80xvzm"
  }
}

Filtre por intervalo de tempo

Obtenha Posts Retweetados de um período específico:

cURL

curl "https://api.x.com/2/users/reposts_of_me?\
start_time=2024-01-01T00%3A00%3A00Z&\
end_time=2024-01-31T23%3A59%3A59Z&\
tweet.fields=created_at,public_metrics" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# Obter Posts Retweetados de um intervalo de tempo
for page in client.posts.get_reposts_of_me(
    start_time="2024-01-01T00:00:00Z",
    end_time="2024-01-31T23:59:59Z",
    tweet_fields=["created_at", "public_metrics"]
):
    for post in page.data:
        print(f"{post.created_at}: {post.text[:50]}...")

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

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

// Obter Posts Retweetados de um intervalo de tempo
const paginator = client.posts.getRepostsOfMe({
  startTime: "2024-01-01T00:00:00Z",
  endTime: "2024-01-31T23:59:59Z",
  tweetFields: ["created_at", "public_metrics"],
});

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

Parâmetros comuns

Parâmetro	Descrição	Padrão
`max_results`	Resultados por página (1-100)	10
`start_time`	Timestamp do Post mais antigo (ISO 8601)	—
`end_time`	Timestamp do Post mais recente (ISO 8601)	—
`pagination_token`	Token para a próxima página	—
`tweet.fields`	Fields adicionais de Post	`id`, `text`

Próximos passos

Consulta de Retweets

Veja quem Retweetou um Post

Gerenciar Retweets

Retweete e desfaça Retweets

Referência da API

Documentação completa do endpoint

Getting Started

Products

Fundamentals

Partners & Customers

Resources

Reposts of Me

Por que usar Reposts of Me?

Obtenha seus Posts Retweetados

Resposta

Filtre por intervalo de tempo

Parâmetros comuns

Próximos passos

Consulta de Retweets

Gerenciar Retweets

Referência da API

​Por que usar Reposts of Me?

​Obtenha seus Posts Retweetados

​Resposta

​Filtre por intervalo de tempo

​Parâmetros comuns

​Próximos passos

Consulta de Retweets

Gerenciar Retweets

Referência da API

Por que usar Reposts of Me?

Obtenha seus Posts Retweetados

Resposta

Filtre por intervalo de tempo

Parâmetros comuns

Próximos passos