Timeline de menções do usuário

Este guia mostra como recuperar Posts que mencionam um usuário específico.

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

Uma conta de desenvolvedor com um App aprovado
O Bearer Token do seu App (para dados públicos) ou User Access Token (para métricas privadas)

Obter menções do usuário

Obtenha o ID do usuário

Encontre o ID do usuário usando o endpoint de user lookup. Por exemplo, @XDevelopers tem o ID de usuário 2244994945.

Solicite a timeline de menções

cURL

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

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Obter timeline de menções com paginação
for page in client.posts.get_user_mentions(
    "2244994945",
    tweet_fields=["created_at", "public_metrics", "author_id"],
    expansions=["author_id"],
    user_fields=["username", "verified"],
    max_results=10
):
    for post in page.data:
        print(f"@{post.author_id}: {post.text[:50]}...")

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

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

// Obter timeline de menções com paginação
const paginator = client.posts.getUserMentions("2244994945", {
  tweetFields: ["created_at", "public_metrics", "author_id"],
  expansions: ["author_id"],
  userFields: ["username", "verified"],
  maxResults: 10,
});

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

Revise a resposta

{
  "data": [
    {
      "id": "1301573587187331074",
      "text": "Hey @XDevelopers, love the new API!",
      "author_id": "1234567890",
      "created_at": "2024-01-15T10:30:00.000Z",
      "public_metrics": {
        "retweet_count": 5,
        "reply_count": 2,
        "like_count": 42,
        "quote_count": 1
      }
    }
  ],
  "includes": {
    "users": [
      {
        "id": "1234567890",
        "username": "developer",
        "name": "Dev Person",
        "verified": false
      }
    ]
  },
  "meta": {
    "newest_id": "1301573587187331074",
    "oldest_id": "1301573587187331074",
    "result_count": 1,
    "next_token": "t3buvdr5pujq9g7bggsnf3ep2ha28"
  }
}

Filtrar menções

Excluir replies

Obtenha apenas Posts originais que mencionam o usuário:

cURL

curl "https://api.x.com/2/users/2244994945/mentions?\
exclude=replies&\
max_results=10" \
  -H "Authorization: Bearer $BEARER_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Obter menções excluindo replies
for page in client.posts.get_user_mentions(
    "2244994945",
    exclude=["replies"],
    max_results=10
):
    for post in page.data:
        print(post.text)

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

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

// Obter menções excluindo replies
const paginator = client.posts.getUserMentions("2244994945", {
  exclude: ["replies"],
  maxResults: 10,
});

for await (const page of paginator) {
  page.data?.forEach((post) => {
    console.log(post.text);
  });
}

Obter menções em um intervalo de tempo

cURL

curl "https://api.x.com/2/users/2244994945/mentions?\
start_time=2024-01-01T00%3A00%3A00Z&\
end_time=2024-01-31T23%3A59%3A59Z" \
  -H "Authorization: Bearer $BEARER_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Obter menções em um intervalo de tempo
for page in client.posts.get_user_mentions(
    "2244994945",
    start_time="2024-01-01T00:00:00Z",
    end_time="2024-01-31T23:59:59Z"
):
    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 menções em um intervalo de tempo
const paginator = client.posts.getUserMentions("2244994945", {
  startTime: "2024-01-01T00:00:00Z",
  endTime: "2024-01-31T23:59:59Z",
});

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)	—
`since_id`	Retornar Posts após este ID	—
`until_id`	Retornar Posts antes deste ID	—
`exclude`	Excluir `retweets`, `replies` ou ambos	—
`pagination_token`	Token para a próxima página	—

Próximos passos

Home timeline

Obtenha a home timeline do usuário

Guia de integração

Conceitos-chave e melhores práticas

Referência da API

Documentação completa do endpoint

Guia de paginação

Navegue por grandes conjuntos de resultados

Getting Started

Products

Fundamentals

Partners & Customers

Resources

Timeline de menções do usuário

Obter menções do usuário

Filtrar menções

Excluir replies

Obter menções em um intervalo de tempo

Parâmetros comuns

Próximos passos

Home timeline

Guia de integração

Referência da API

Guia de paginação

​Obter menções do usuário

​Filtrar menções

​Excluir replies

​Obter menções em um intervalo de tempo

​Parâmetros comuns

​Próximos passos

Home timeline

Guia de integração

Referência da API

Guia de paginação

Obter menções do usuário

Filtrar menções

Excluir replies

Obter menções em um intervalo de tempo

Parâmetros comuns

Próximos passos