Referencia de la API REST de TwexAPI
TwexAPI expone una API REST estándar en https://api.twexapi.io para búsqueda en X/Twitter, perfiles, exportación de seguidores, publicación de tweets, DMs, artículos de X e integración con agentes de IA.
Capacidades principales:
- Búsqueda avanzada (Search) — Búsqueda por palabras clave, hashtags, cashtags y operadores booleanos
- Tweets y engagement (Tweets) — Obtención de hilos completos, detalles de tweets, respuestas, usuarios que dieron me gusta o retuitearon
- Usuarios y gráfico social (Users) — Consulta de perfiles, obtención masiva, exportación de seguidores y seguidos mediante paginación por cursor
- Acciones de escritura (Tweet Actions) — Publicación automatizada, respuestas, creación de hilos, me gusta, retweets, marcadores
- Mensajes directos (DM) — Envío de DMs, comprobación de permisos, conversaciones e historial de chat
- Tendencias globales (Trending) — Tweets destacados por país y temas de tendencia
- Artículos de X (Articles) — Extracción de artículos de X en formato Markdown (ideal para RAG y LLMs), borradores y publicación
Todos los endpoints devuelven una estructura uniforme (code: 200, msg: "success", data). Consulte la Guía de manejo de errores.
Autenticación (Authentication)
Incluya su clave de API en la cabecera de cada solicitud:
Authorization: Bearer YOUR_API_KEYLas acciones de escritura requieren una cookie de Twitter o auth_token. Consulte la Guía de autenticación.
Version 1.0.0
Base URL
https://api.twexapi.ioCookie Endpoints
- GETObtener cookie mediante auth_token
/twitter/{auth_token}/cookie - GETObtener info de usuario mediante auth_token
/twitter/{auth_token}/user_info
Search Endpoints
- POSTBúsqueda avanzada paginada por cursor
/twitter/advanced_search/page - POSTBúsqueda de cashtags financieros
/twitter/cashtags - POSTBúsqueda de hashtags populares
/twitter/hashtags
Tweet Actions Endpoints
- POSTDar me gusta a un tweet
/twitter/tweets/{tweet_id}/like - DELETEQuitar me gusta de un tweet
/twitter/tweets/{tweet_id}/like - POSTRetuitear un tweet
/twitter/tweets/{tweet_id}/retweet - DELETEDelete Retweet
/twitter/tweets/{tweet_id}/retweet - POSTCreate a Tweet Thread
/v3/twitter/tweets/create-thread - POSTCreate a Tweet or Reply
/twitter/tweets/create - POSTCreate a Quote Tweet
/twitter/tweets/quote - POSTBookmark a Tweet
/twitter/tweets/{tweet_id}/bookmark - DELETEEliminar de marcadores
/twitter/tweets/{tweet_id}/bookmark - POSTEliminar uno o más tweets
/twitter/tweets/delete-batch
Users Endpoints
- POSTObtención masiva de perfiles de usuario
/twitter/users - POSTBloquear a un usuario
/twitter/user/block - DELETEDesbloquear usuario
/twitter/user/block - POSTDetalles de usuario por ID numérico
/twitter/users/by_ids - POSTVerificar estado de cuenta
/x/account/verify - POSTVerificación masiva de estado de cuentas
/twitter/users/status - GETBuscar usuarios en Twitter
/twitter/search-user/{keyword}/{target_count} - POSTFollow User
/twitter/user/follow - DELETEDejar de seguir a un usuario
/twitter/user/follow
Followers & Following Endpoints
- GETObtener seguidores por cantidad
/twitter/followers/{screen_name}/{count} - GETGet Followers Task Status
/twitter/followers/task/{task_id}/status - GETConsume Next Page of Followers Task
/twitter/followers/task/{task_id}/next - POSTObtener seguidores paginados
/twitter/followers/page - POSTObtener seguidos paginados
/twitter/following/page - GETObtener seguidos por cantidad
/twitter/following/{screen_name}/{count} - GETGet Following Task Status
/twitter/following/task/{task_id}/status - GETConsume Next Page of Following Task
/twitter/following/task/{task_id}/next - POSTGet Following (v3)
/v3/twitter/users/following - POSTGet Followers (v3)
/v3/twitter/users/followers - POSTObtener seguidores verificados
/v3/twitter/users/verified-followers
Tweet Replies Endpoints
- POSTObtener respuestas paginadas
/twitter/tweets/{tweet_id}/replies/page - GETObtener respuestas por ID de tweet (Legacy)
/twitter/tweets/{tweet_id}/replies/{count}
DM Endpoints
- POSTVerificar permisos de DM
/v2/dm/status - POSTEnviar mensaje directo (XChat v3)
/v3/twitter/send-dm - POSTObtener historial de DM (XChat v3)
/v3/twitter/dm-history - POSTObtener archivos multimedia de DM
/v3/twitter/dm-media - POSTObtener conversaciones de DM
/v3/twitter/conversations
Article Endpoints
- POSTObtención masiva de artículos de X
/x/article - GETExtraer artículo de X como Markdown
/x/article/{tweet_id}/markdown - POSTCrear borrador de artículo
/x/articles/draft - PUT[Step 2/5] Upload and set article cover image (optional)
/x/articles/{article_id}/cover - PUT[Step 3/5] Set article title
/x/articles/{article_id}/title - PUT[Step 4/5] Set article content from Markdown
/x/articles/{article_id}/content - POST[Step 5/5] Publish an article draft
/x/articles/{article_id}/publish - POST[Quick] One-step article publish
/x/articles/publish
Tweets Endpoints
- POSTObtener detalles del tweet (v2)
/v2/tweet/detail - POSTGet Tweet Thread by ID
/twitter/tweets/thread_by_id - POSTObtención masiva de tweets por ID
/twitter/tweets/lookup - GETObtener tweets similares
/twitter/tweets/{tweet_id}/similar
Grok Endpoints
- POSTPreguntar a Grok AI
/v3/twitter/grok/ask - POSTObtener historial de Grok
/v3/twitter/grok/history - POSTObtener conversación con Grok
/v3/twitter/grok/conversation
Tweet Engagement Endpoints
- POSTObtener retweeters paginados
/twitter/tweets/retweeters/page - POSTObtener usuarios que dieron me gusta
/twitter/tweets-favoriters - POSTGet Quote Tweets by Page
/twitter/tweets/quotes/page
Lists Endpoints
- POSTCrear lista de Twitter
/twitter/list/create - POSTObtener tweets de lista paginados
/twitter/list/tweets/page - GETObtener suscriptores de lista
/twitter/list/{list_id}/subscribers/{target_count} - POSTObtener miembros de lista paginados
/twitter/list/members/page - POSTBuscar listas de Twitter
/twitter/list/search
Communities Endpoints
- POSTObtener miembros de comunidad paginados
/twitter/community/members/page - POSTObtener tweets de comunidad paginados
/twitter/community/tweets/page - POSTBuscar comunidades de Twitter
/twitter/community/search - GETGet Community
/twitter/community/{community_id} - POSTBuscar tweets dentro de comunidad
/twitter/community/search-tweets
Twitter Profile Actions Endpoints
Trending Endpoints
- GETListar países con tendencias
/twitter/global-trending/countries - GETListar temas de tendencia
/twitter/global-trending/topics - GETListar etiquetas de contenido en tendencia
/twitter/global-trending/contents - GETObtener tweets de tendencia global
/twitter/global-trending/tweets - GETGet Trending Topics
/twitter/{country}/trending