La API de X (Twitter) para menciones, respuestas y DMs

Menciones, respuestas y DMs en X a través de una sola API.

Empieza gratis Ver la documentación

Nivel gratuito, sin tarjeta
API key al instante
Servidor MCP incluido

En X (Twitter)

Post

Ledge Skate & Shoe

@ledgeskate

Llegaron las nuevas bajas blancas. En tienda el sábado, todas las tallas.

14:006 oct. 2026

Maya R.@maya_r2 h

¿Vienen en negro?

Ledge Skate & Shoe@ledgeskate1 min

Sí, negras con suela de goma, tallas del 36 al 46.

Jin K.@jin_k5 h

Patiné con las mías todo el finde, el agarre es increíble.

POST/v1/inbox/comments/{postId}200 OK

Capacidades: Lo que puedes construir en X (Twitter)

Cada capacidad es un endpoint, el mismo que llamas en todas las demás plataformas.Las pantallas muestran dónde llega cada llamada.

Mensajes directos
Lee conversaciones de DM y envía mensajes a través de la misma bandeja de entrada unificada que usas para la mensajería de Instagram y Facebook.
- GET/v1/inbox/conversations
- POST/v1/inbox/conversations/{id}/messages
Tomás B.
Tomás B.
@tom_b
Viernes
Pedí las de lona altas, talla 44.
Gracias Tomás, sale hoy.
Hoy
Esto llegó a mi puerta, pero no es mi pedido.
❤️
Tomás B.Esto llegó a mi puerta, pero no es mi pedido.
Perdón Tomás, hubo una confusión. El tuyo está en tu recepción.
9:14 a. m.Visto
Ya lo encontréSigue sin aparecer
Publicación
Tweets de texto con hasta 4 imágenes, o un video, o un GIF animado, subidos por ti mediante la subida de medios por partes de X.
- POST/v1/posts
Post
Ledge Skate & Shoe
@ledgeskate
Llegaron las nuevas bajas blancas. En tienda el sábado, todas las tallas.
14:006 oct. 20263,4 mil visualizaciones
Comentarios
Lee las respuestas en tus tweets, responde, y oculta o elimina tus propias respuestas. Dar like a una respuesta no está disponible; X eliminó las escrituras de like y unlike de los niveles de API de autoservicio.
- GET/v1/inbox/comments/{postId}
- POST/v1/inbox/comments/{postId}
- leer
- responder
- ocultar
- eliminar
Menciones
Obtén los tweets que mencionan tu cuenta autenticada a través de un endpoint dedicado, limitado a esa cuenta.
- GET/v1/accounts/{id}/mentions
- tweets que te mencionan

En todas las plataformas

Listo para agentes
Cada capacidad de X (Twitter) es una herramienta tipada del servidor MCP de SocialAPI.ai.
- social_api_list_post_comments
- social_api_send_dm
- social_api_validate_post
Una sola API key
La key que llama a X (Twitter) llama a las 13 plataformas.
Authorization: Bearer sapi_key_…
Errores predecibles
Los mismos códigos de estado en todas partes, sin importar la plataforma detrás.
- 401token expirado
- 429límite de tasa
- 501no disponible en esta plataforma

Llama a la API de X (Twitter)

Lista las menciones de tu cuenta de X

Obtén cada tweet que menciona tu cuenta a través del mismo endpoint GET /v1/accounts/{id}/mentions usado para menciones de Instagram y Facebook.

curl "https://api.social-api.ai/v1/accounts/<x-account-id>/mentions?limit=10" \
  -H "Authorization: Bearer <your-api-key>" | jq

# Response
{
  "data": [
    {
      "id": "sapi_mnt_GXRM4BNTW7KFYSD3HAEV6QJZ2CLP9U",
      "type": "mention",
      "author": { "username": "someuser", "name": "Some User" },
      "content": { "text": "@yourhandle just tried your API, love it" },
      "received_at": "2026-03-20T18:00:00Z"
    }
  ],
  "next_cursor": "..."
}

import requests

resp = requests.get(
    "https://api.social-api.ai/v1/accounts/<x-account-id>/mentions",
    headers={"Authorization": "Bearer <your-api-key>"},
    params={"limit": 10},
)
for mention in resp.json()["data"]:
    print(mention["author"]["username"], mention["content"]["text"])

const res = await fetch(
  "https://api.social-api.ai/v1/accounts/<x-account-id>/mentions?limit=10",
  { headers: { Authorization: "Bearer <your-api-key>" } }
);
const { data } = await res.json();
for (const mention of data) {
  console.log(mention.author.username, mention.content.text);
}

Comparación: La API oficial vs una sola API key

Aspecto	La X API v2 (sin procesar)	Con SocialAPI.ai
Rate limits	La X API v2 (sin procesar)Buckets por app que debes rastrear tú mismo en cada nivel de endpoint.	Con SocialAPI.aiEl bucket de tu propia app, nunca compartido con otros clientes. La limitación de la plataforma aparece como un 429 claro que no afecta tu cuota de SocialAPI.ai.
Forma de los datos	La X API v2 (sin procesar)Objetos tweet con expansions, arrays de includes y tokens de paginación que debes ensamblar.	Con SocialAPI.aiUn esquema normalizado para menciones, respuestas y DMs, idéntico al de todas las demás plataformas.
Configuración de OAuth	La X API v2 (sin procesar)OAuth 2.0 con PKCE, renovación de tokens y gestión de scopes en tu propio código.	Con SocialAPI.aiPega el Client ID y Secret de tu app una vez; la conexión de cuenta y la renovación de tokens quedan resueltas.
Multiplataforma	La X API v2 (sin procesar)Una integración exclusiva de X que mantienes por separado de Meta, Google y el resto.	Con SocialAPI.aiLos mismos endpoints /v1/inbox y /v1/posts cubren X y las otras 12 plataformas, hasta donde cada una lo permite.

En detalle: Cómo funciona la API de X (Twitter) en SocialAPI.ai

Obtén cada tweet que te menciona, gestiona las respuestas bajo tus publicaciones, y lee y envía DMs a través de la misma API unificada que ya usas para todas las demás plataformas. Traes tu propia app de desarrollador de X (una configuración de diez minutos), lo que significa tu propio rate-limit bucket en lugar de uno compartido.

Seguimiento de menciones

Obtén cada tweet que menciona tu cuenta autenticada a través de un endpoint dedicado, limitado a esa cuenta y no a todo tu workspace. Consúltalo con un cron para construir monitoreo de marca, una cola de soporte o un flujo de triaje automatizado, de la misma forma que lo harías con menciones de Instagram o Facebook.

Gestión de respuestas e hilos

Lee las respuestas bajo tus tweets, publica una respuesta y oculta o elimina tus propias respuestas a través de los mismos endpoints de comentarios usados en todas las demás plataformas. Dar like a una respuesta no está disponible: X eliminó las escrituras de like y unlike de sus niveles de API de autoservicio y las reservó para Enterprise.

Mensajes directos

Lista conversaciones de DM, lee el historial de mensajes y envía respuestas a través del endpoint de bandeja de entrada unificado, la misma forma de solicitud y respuesta que ya usas para la mensajería de Instagram y Facebook. Una integración de X no necesita su propia ruta de código.

Tu propio rate-limit bucket

X limita el acceso a la API por app de desarrollador, así que cada cliente que pasara por una sola app compartida competiría por la misma cuota. Trae tu propia app de desarrollador de X, unos diez minutos de configuración, y tus llamadas usan un bucket que solo tú consumes.

Un esquema, igual que en todas las plataformas

Las menciones, respuestas y DMs de X regresan en el mismo esquema normalizado usado por Instagram, Facebook, LinkedIn y todas las demás plataformas conectadas. Construye tu lógica de bandeja de entrada una sola vez y funciona sin importar si el evento vino de X o de cualquier otro lado.

Bueno saberlo

Las encuestas y los quote tweets todavía no están disponibles a través del conector. Una publicación lleva hasta 4 imágenes, o exactamente un video, o exactamente un GIF animado, nunca una mezcla; los tweets de continuación de un hilo siguen siendo solo de texto. Las cuentas conectadas antes del 2026-07-27 deben reconectarse una vez para otorgar el scope media.write.
X no expone un endpoint de edición público a las apps de autoservicio; la edición está reservada para Enterprise. UpdatePost devuelve 501 para cuentas de X, así que elimina y vuelve a crear cuando necesites cambiar un tweet.
Dar o quitar like a una respuesta no está disponible. X eliminó las escrituras de like y unlike de todos los niveles de API de autoservicio.
X es BYOK: traes tu propia app de desarrollador de X porque X limita las tasas por app. Una app compartida de SocialAPI.ai pondría a todos los clientes en la misma cuota.

Precios simples y honestos.

Leer comentarios, DMs y menciones es gratis e ilimitado en todos los planes. Los planes de pago comienzan en $29/mes con posts e interacciones ilimitados. El nivel gratuito no requiere tarjeta de crédito.

Empieza gratis Precios de la API de redes sociales

Preguntas frecuentes

Lo que preguntan los desarrolladores antes de lanzar con X (Twitter).

¿X (Twitter) tiene una API gratuita?

El nivel gratuito de la propia API de X es de solo escritura: te permite publicar pero no leer tweets, respuestas, menciones o DMs, así que una app de desarrollador de X gratuita no puede sostener por sí sola una integración de lectura intensiva. X ahora cobra el acceso de pago según el uso en lugar de una suscripción mensual fija, así que el costo depende del volumen de llamadas. Los planes de SocialAPI.ai comienzan gratis e incluyen X, pero tu app de desarrollador de X igual necesita un nivel de pago para leer menciones y respuestas.

¿Cómo obtengo las menciones desde la X API?

Llama a GET /v1/accounts/{account_id}/mentions con tu API key de SocialAPI.ai y el ID de tu cuenta de X conectada. Devuelve los tweets que mencionan esa cuenta, del más reciente al más antiguo, en el mismo formato usado para menciones de Instagram y Facebook.

¿Puedo enviar DMs a través de la X API?

Sí. Lista conversaciones y envía mensajes a través de los mismos endpoints /v1/inbox/conversations usados para DMs de Instagram y Facebook. Tu app de desarrollador de X necesita los scopes dm.read y dm.write habilitados.

¿Por qué necesito mi propia app de desarrollador de X?

X limita las tasas por app de desarrollador, así que cada cliente de SocialAPI.ai que compartiera una app competiría por la misma cuota. Traer tu propia app, unos diez minutos de registro y conexión, te da un rate-limit bucket independiente, alineado con el nivel de acceso de X que tengas.

¿Puedo publicar tweets con imágenes o video?

Sí. Adjunta hasta 4 imágenes, o un video, o un GIF animado, y SocialAPI.ai los sube mediante la subida de medios por partes de X antes de publicar. Si una subida falla, falla toda la publicación, así que un tweet nunca sale sin los medios que pediste. Las cuentas conectadas antes del 2026-07-27 deben reconectarse una vez para otorgar el scope media.write.

¿Pueden los agentes de IA leer mis menciones de X?

Sí. El servidor MCP integrado expone las lecturas de la bandeja de entrada, incluyendo menciones, como tools, así que Claude y otros agentes compatibles con MCP pueden obtener tus menciones de X y redactar respuestas dentro de tu flujo de aprobación existente.

Todas las demás plataformas, una sola API: Todas las demás plataformas, una sola API

La misma key, las mismas estructuras, el mismo webhook.

¿Listo para unificar tus interacciones sociales?

Nivel gratuito disponible. Sin tarjeta de crédito. Incluye el servidor MCP.

Empieza gratis Ver la documentación

La API de X (Twitter) para menciones, respuestas y DMs

Capacidades: Lo que puedes construir en X (Twitter)

Mensajes directos

Publicación

Comentarios

Menciones

Listo para agentes

Una sola API key

Errores predecibles

Llama a la API de X (Twitter)

Lista las menciones de tu cuenta de X

Comparación: La API oficial vs una sola API key

En detalle: Cómo funciona la API de X (Twitter) en SocialAPI.ai

Seguimiento de menciones

Gestión de respuestas e hilos

Mensajes directos

Tu propio rate-limit bucket

Un esquema, igual que en todas las plataformas

Precios simples y honestos.

Preguntas frecuentes

¿X (Twitter) tiene una API gratuita?

¿Cómo obtengo las menciones desde la X API?

¿Puedo enviar DMs a través de la X API?

¿Por qué necesito mi propia app de desarrollador de X?

¿Puedo publicar tweets con imágenes o video?

¿Pueden los agentes de IA leer mis menciones de X?

Todas las demás plataformas, una sola API: Todas las demás plataformas, una sola API

¿Listo para unificar tus interacciones sociales?