Consulta de marcadores

Recupera tus Publicaciones marcadas

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

Requisitos previos

Antes 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

1. 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.

2. Solicita tus marcadores

   cURL

   shellscript

   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"
   
3. 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

shellscript

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"

---

​

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)

---

​

Próximos pasos

Gestionar marcadores

Añadir y eliminar marcadores

Referencia de la API

Documentación completa del endpoint