Administrar marcadores

Añade y elimina marcadores con la X API

Esta guía te explica cómo agregar y eliminar marcadores con la X API.

Requisitos previos

Antes de comenzar, necesitarás:

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

---

​

Añadir un marcador

1. Obtén tu id de usuario

   Necesitas el id de tu usuario autenticado. Puedes encontrarlo usando el endpoint /2/users/me o el endpoint de consulta de usuarios.

2. Obtén el id de la Publicación

   Encuentra el id de la Publicación en la URL cuando estés viendo una Publicación:

   https://x.com/XDevelopers/status/1460323737035677698
                                   └── Este es el id de la Publicación
   
3. Añade el marcador

   cURL

   shellscript

   curl -X POST "https://api.x.com/2/users/2244994945/bookmarks" \
     -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"tweet_id": "1460323737035677698"}'
   
4. Revisa la respuesta

   {
     "data": {
       "bookmarked": true
     }
   }
   

---

​

Eliminar un marcador

Elimina una Publicación de tus marcadores:

cURL

shellscript

curl -X DELETE "https://api.x.com/2/users/2244994945/bookmarks/1460323737035677698" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

Respuesta:

{
  "data": {
    "bookmarked": false
  }
}

---

​

Ámbitos requeridos

Cuando uses OAuth 2.0 PKCE, tu token de acceso debe tener estos ámbitos:

Ámbito	Descripción
bookmark.write	Agregar y eliminar marcadores
tweet.read	Leer datos de Publicaciones
users.read	Leer datos de usuario

​

Próximos pasos

Búsqueda de marcadores

Obtén las Publicaciones que has guardado como marcadores

Referencia de la API

Documentación completa del endpoint