Consulta de marcadores

Esta guía te explica cómo recuperar tus Publicaciones que has guardado en Marcadores usando la X API.

Requisitos previosAntes de empezar, necesitarás:

Una cuenta de desarrollador con una App aprobada
Un token de acceso de usuario con el alcance bookmark.read (OAuth 2.0 PKCE)

Obtén tus marcadores

Obtén tu ID de usuario

Necesitas el ID del usuario autenticado. Puedes obtenerlo usando el endpoint /2/users/me o el endpoint de búsqueda de usuarios.

Solicita tus marcadores

cURL

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

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# Obtener publicaciones guardadas en marcadores con paginación
for page in client.bookmarks.get(
    "2244994945",
    tweet_fields=["created_at", "public_metrics", "author_id"],
    max_results=10
):
    for post in page.data:
        print(f"{post.text[:50]}... - Likes: {post.public_metrics.like_count}")

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

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

// Obtener publicaciones guardadas en marcadores con paginación
const paginator = client.bookmarks.get("2244994945", {
  tweetFields: ["created_at", "public_metrics", "author_id"],
  maxResults: 10,
});

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

Revisa la respuesta

{
  "data": [
    {
      "id": "1501258597237342208",
      "text": "¿Has creado un proyecto usando la X API que quieras compartir con la comunidad? ¡Nos encantaría saber de ti!",
      "created_at": "2024-01-15T10:30:00.000Z",
      "author_id": "2244994945",
      "public_metrics": {
        "retweet_count": 15,
        "reply_count": 8,
        "like_count": 89,
        "quote_count": 3
      }
    },
    {
      "id": "1501258542258348032",
      "text": "Esta es solo una de las formas en que la innovación de los desarrolladores contribuye a hacer de X un lugar mejor...",
      "created_at": "2024-01-15T09:15:00.000Z",
      "author_id": "2244994945",
      "public_metrics": {
        "retweet_count": 22,
        "reply_count": 5,
        "like_count": 156,
        "quote_count": 7
      }
    }
  ],
  "meta": {
    "result_count": 2,
    "next_token": "7140dibdnow9c7btw4539n0vybdnx19ylpayqf16fjt4l"
  }
}

Incluir información del autor

Usa el parámetro expansions para obtener datos sobre los autores de las publicaciones:

cURL

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

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# Obtener marcadores con información del autor
for page in client.bookmarks.get(
    "2244994945",
    tweet_fields=["created_at", "author_id"],
    expansions=["author_id"],
    user_fields=["username", "verified"]
):
    for post in page.data:
        print(f"{post.text[:50]}...")
    # La información del autor está en page.includes.users

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

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

// Obtener marcadores con información del autor
const paginator = client.bookmarks.get("2244994945", {
  tweetFields: ["created_at", "author_id"],
  expansions: ["author_id"],
  userFields: ["username", "verified"],
});

for await (const page of paginator) {
  page.data?.forEach((post) => {
    console.log(`${post.text?.slice(0, 50)}...`);
  });
  // La información del autor está en page.includes?.users
}

Permisos requeridos

Cuando uses OAuth 2.0 PKCE, tu token de acceso debe incluir los siguientes permisos (scopes):

Scope	Descripción
`bookmark.read`	Leer marcadores
`tweet.read`	Leer datos de Publicaciones
`users.read`	Leer datos de usuario (para expansions)

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

Consulta de marcadores

Obtén tus marcadores

Incluir información del autor

Permisos requeridos

Próximos pasos

Gestionar marcadores

Referencia de la API