Consulta de Listas fijadas

Recupera las Listas fijadas de un usuario

Esta guía te explica cómo obtener las Listas fijadas de un usuario.

Requisitos previos

Antes de comenzar, necesitarás:

• Una cuenta de desarrollador con una App aprobada
• Un token de acceso de usuario (OAuth 1.0a o OAuth 2.0 PKCE)

---

​

Obtener listas fijadas

1. Obtén tu ID de usuario

   Necesitas el ID de tu usuario autenticado. Puedes obtenerlo usando el endpoint de búsqueda de usuarios o a partir de tu Access Token (la parte numérica es tu ID de usuario).

2. Solicita las listas fijadas

   cURL

   shellscript

   curl "https://api.x.com/2/users/2244994945/pinned_lists?\
   list.fields=follower_count,member_count,owner_id&\
   expansions=owner_id&\
   user.fields=created_at,username" \
     -H "Authorization: Bearer $USER_ACCESS_TOKEN"
   
3. Revisa la respuesta

   {
     "data": [
       {
         "id": "1454155907651158017",
         "name": "Tech News",
         "follower_count": 150,
         "member_count": 25,
         "owner_id": "2244994945"
       }
     ],
     "includes": {
       "users": [
         {
           "id": "2244994945",
           "username": "XDevelopers",
           "name": "X Developers",
           "created_at": "2013-12-14T04:35:55.000Z"
         }
       ]
     },
     "meta": {
       "result_count": 1
     }
   }
   

---

​

Campos de Lista disponibles

Campo	Descripción
description	Descripción de la Lista
owner_id	ID de usuario del propietario
private	Si la Lista es privada
member_count	Número de miembros
follower_count	Número de seguidores
created_at	Fecha de creación de la Lista

---

​

Próximos pasos

Administrar Listas fijadas

Fijar y desfijar Listas

Búsqueda de Listas

Obtener detalles de la Lista

Referencia de la API

Documentación completa del endpoint