Cronología de menciones del usuario

Esta guía te muestra cómo recuperar Publicaciones que mencionan a un usuario específico.

Requisitos previosAntes de comenzar, necesitarás:

Una cuenta de desarrollador con una App aprobada
El Bearer Token de tu App (para datos públicos) o el User Access Token (para métricas privadas)

Obtener menciones de un usuario

Obtener el ID de usuario

Obtén el ID de usuario usando el endpoint de búsqueda de usuarios. Por ejemplo, @XDevelopers tiene el ID de usuario 2244994945.

Solicitar la cronología de menciones

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

# Obtener la cronología de menciones con paginación
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" });

// Obtener la cronología de menciones con paginación
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)}...`);
  });
}

Revisa la respuesta

{
  "data": [
    {
      "id": "1301573587187331074",
      "text": "Hey @XDevelopers, ¡me encanta la nueva 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 menciones

Excluir respuestas

Obtén solo las Publicaciones originales que mencionen al usuario:

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

# Obtén menciones excluyendo respuestas
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" });

// Obtén menciones excluyendo respuestas
const paginator = client.posts.getUserMentions("2244994945", {
  exclude: ["replies"],
  maxResults: 10,
});

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

Obtener menciones en un rango de tiempo

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

# Obtener menciones en un rango de tiempo
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" });

// Obtener menciones en un rango de tiempo
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 comunes

Parámetro	Descripción	Valor predeterminado
`max_results`	Resultados por página (1-100)	10
`start_time`	Marca de tiempo de la Publicación más antigua (ISO 8601)	—
`end_time`	Marca de tiempo de la Publicación más reciente (ISO 8601)	—
`since_id`	Devuelve Publicaciones posteriores a este ID	—
`until_id`	Devuelve Publicaciones anteriores a este ID	—
`exclude`	Excluye `retweets`, `replies` o ambos	—
`pagination_token`	Token para la página siguiente	—

Próximos pasos

Cronología de inicio

Obtén la cronología de inicio del usuario

Guía de integración

Conceptos clave y prácticas recomendadas

Referencia de la API

Documentación completa del endpoint

Guía de paginación

Navega por grandes conjuntos de resultados

Descripción general

Publicaciones

Usuarios

Mensajes directos

Me gusta

Listas

Spaces

Comunidades

Notas de la comunidad

Tendencias

Noticias

Contenido multimedia

Actividad en X

Uso

Conexiones de streaming

Cumplimiento

Enterprise v2

Flujos de Me gusta

GNIP 2.0

Cronología de menciones del usuario

Obtener menciones de un usuario

Filtrar menciones

Excluir respuestas

Obtener menciones en un rango de tiempo

Parámetros comunes

Próximos pasos

Cronología de inicio

Guía de integración

Referencia de la API

Guía de paginación