La API de Bluesky para publicaciones, respuestas, menciones y DMs

Publicaciones, respuestas, menciones y DMs en Bluesky con una sola API.

Empieza gratis Ver la documentación

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

En Bluesky

Ledge Skate & Shoe @ledge.skate6 oct

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

POST/v1/posts201 Created

Capacidades: Lo que puedes construir en Bluesky

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

Comentarios
Lee las respuestas bajo tus publicaciones de Bluesky y responde a través de los mismos endpoints de comentarios usados en todas las demás plataformas.
- GET/v1/inbox/comments/{postId}
- POST/v1/inbox/comments/{postId}
Publicar
Ledge Skate & Shoe
@ledge.skate
Llegaron las nuevas bajas blancas. En tienda el sábado, todas las tallas.
14:006 oct. 2026
Maya R. @maya.bsky.social2 h
¿Vienen en negro?
Ledge Skate & Shoe @ledge.skate1 min
Sí, negras con suela de goma, tallas del 36 al 46.
Jin K. @jink.bsky.social5 h
Patiné con las mías todo el finde, el agarre es increíble.
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
Lena S.
@lena.bsky.social
miércoles a las 18:42
¿Pueden ir principiantes al jam?
Claro, llevamos tablas prestadas.
Hoy a las 9:12
¿El jam del sábado sigue si llueve?
❤️
Lena S.¿El jam del sábado sigue si llueve?
Lo pasamos adentro, 2 p. m. en la bodega.
Leído
VoyNo puedo
Menciones
Obtén las publicaciones que mencionan tu handle conectado a través del mismo endpoint de menciones usado para Instagram y X.
- GET/v1/accounts/{id}/mentions
- publicaciones que mencionan tu handle
Publicación
Publica con la misma llamada POST /v1/posts que en todas las demás plataformas. GET /v1/posts/validate te dice qué acepta una publicación de Bluesky antes de enviarla.
- POST/v1/posts
- GET/v1/posts/validate
- publicar
- revisar restricciones antes
Webhooks
Las nuevas interacciones de Bluesky llegan a tu único webhook endpoint configurado, en el mismo envelope que todas las demás plataformas.
Eventos de webhook
- comment.received
- dm.received
- mention.received

En todas las plataformas

Listo para agentes
Cada capacidad de Bluesky es una herramienta tipada del servidor MCP de SocialAPI.ai.
- social_api_validate_post
- social_api_list_post_comments
- social_api_send_dm
Una sola API key
La key que llama a Bluesky 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 Bluesky

Publica en Bluesky

El mismo endpoint POST /v1/posts que ya usas para todas las demás plataformas. Agrega una cuenta de Bluesky al array de targets y nada más cambia en tu código de publicación.

curl -X POST https://api.social-api.ai/v1/posts \
  -H "Authorization: Bearer <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "targets": [{ "account_id": "<bluesky-account-id>" }],
    "text": "Shipped Bluesky support today. Same API, one more platform.",
    "publish_now": true
  }' | jq

# Response
{
  "id": "<post-id>",
  "status": "published",
  "targets": [
    {
      "platform": "bluesky",
      "account_id": "<bluesky-account-id>",
      "status": "published",
      "platform_post_id": "at://...",
      "published_at": "2026-09-14T18:00:00Z"
    }
  ]
}

import requests

resp = requests.post(
    "https://api.social-api.ai/v1/posts",
    headers={"Authorization": "Bearer <your-api-key>"},
    json={
        "targets": [{"account_id": "<bluesky-account-id>"}],
        "text": "Shipped Bluesky support today. Same API, one more platform.",
        "publish_now": True,
    },
)
print(resp.json())  # { "id": "...", "status": "published", ... }

const res = await fetch("https://api.social-api.ai/v1/posts", {
  method: "POST",
  headers: {
    Authorization: "Bearer <your-api-key>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    targets: [{ account_id: "<bluesky-account-id>" }],
    text: "Shipped Bluesky support today. Same API, one more platform.",
    publish_now: true,
  }),
});
console.log(await res.json());

En detalle: Cómo funciona la API de Bluesky en SocialAPI.ai

Publica en Bluesky, lee las respuestas bajo tus publicaciones, rastrea las menciones de tu handle, y lee y envía DMs a través de la misma API unificada que ya usas para todas las demás plataformas. Conecta una cuenta una sola vez con su handle y una app password, y cada interacción regresa en el mismo esquema, en el mismo webhook endpoint y con los mismos códigos de error.

Publicación con el endpoint que ya llamas

Las publicaciones de Bluesky salen por la misma solicitud POST /v1/posts que las de Instagram, LinkedIn o Threads. Agrega una cuenta de Bluesky al array de targets y el resto de tu código de publicación queda intacto. Pregúntale a GET /v1/posts/validate qué acepta una publicación de Bluesky en vez de fijar los límites de la plataforma dentro de tu app.

Respuestas bajo tus publicaciones

Lee las respuestas en tus publicaciones de Bluesky y responde a través de los mismos endpoints de comentarios usados en todas las demás plataformas conectadas. Una respuesta de Bluesky llega con la misma forma que un comentario de Instagram, así que tus colas de moderación y soporte no necesitan una rama específica para Bluesky.

Menciones de tu handle

Obtén las publicaciones que mencionan tu handle conectado a través del mismo endpoint de menciones usado para Instagram y X. Consúltalo con un cron, o deja que las menciones lleguen a tu webhook, y construye monitoreo de marca o una cola de soporte una sola vez para todas las plataformas a la vez.

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. Bluesky no necesita su propia ruta de código.

Un esquema, un webhook, un solo conjunto de códigos de error

Las publicaciones, respuestas, menciones y DMs de Bluesky regresan en el mismo esquema unificado de interacciones que todas las demás plataformas, llegan al mismo webhook endpoint con el mismo envelope, y fallan con los mismos códigos HTTP: 401 para un token expirado, 429 cuando la plataforma te limita, 501 para algo que una plataforma no admite. Bluesky es un destino nuevo para código que ya escribiste.

Bueno saberlo

Bluesky está construido sobre el AT Protocol, y sus límites por publicación son de la plataforma, no de SocialAPI.ai. Léelos desde GET /v1/posts/validate en lugar de fijarlos en tu código, así tu app sigue a la plataforma cuando cambien.
Las cuentas se conectan con un handle y una app password en lugar de OAuth, que es lo que ofrece el protocolo AT. Revocar la app password en los ajustes de Bluesky aparece como un 401 y la cuenta debe reconectarse antes de que las llamadas vuelvan a funcionar.
La limitación de la plataforma aparece como un 429 y no consume tu cuota de SocialAPI.ai. Reintenta con backoff en lugar de tratarlo como una escritura fallida.
Todo lo que Bluesky no admite devuelve un 501 en vez de fallar en silencio, así que una llamada no soportada queda visible en tus logs y no parece un no-op silencioso.

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

¿Bluesky tiene una API?

Sí. Bluesky está construido sobre el AT Protocol y SocialAPI.ai lo expone a través de la misma API REST que todas las demás plataformas: publica, lee y escribe respuestas, obtén las menciones de tu handle, y lee y envía DMs con una sola API key.

¿Puedo publicar en Bluesky a través de la API?

Sí. Envía una solicitud POST /v1/posts con una cuenta de Bluesky en el array de targets, igual que lo harías para Instagram o LinkedIn. Llama primero a GET /v1/posts/validate si quieres revisar qué acepta una publicación de Bluesky antes de publicarla.

¿Puedo leer y responder comentarios en mis publicaciones de Bluesky?

Sí. Las respuestas bajo tus publicaciones de Bluesky se leen y se contestan con los mismos endpoints de comentarios usados en todas las demás plataformas, y cada una regresa en el mismo esquema normalizado que un comentario de Instagram o Facebook.

¿Puedo enviar DMs de Bluesky a través de la 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. No hay una integración de mensajería de Bluesky aparte que construir.

¿Cómo conecto una cuenta de Bluesky?

Con el handle, por ejemplo @tunombre.bsky.social, y una app password generada en los ajustes de Bluesky. No hay flujo OAuth: el protocolo AT no lo ofrece. La app password se cifra en reposo, se limita a lo que le concedas y puedes revocarla desde Bluesky en cualquier momento.

¿Pueden los agentes de IA publicar en Bluesky?

Sí. El servidor MCP integrado expone la publicación y las lecturas de la bandeja de entrada como tools, así que Claude y otros agentes compatibles con MCP pueden redactar publicaciones y respuestas de Bluesky 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 Bluesky para publicaciones, respuestas, menciones y DMs

Capacidades: Lo que puedes construir en Bluesky

Comentarios

Mensajes directos

Menciones

Publicación

Webhooks

Listo para agentes

Una sola API key

Errores predecibles

Llama a la API de Bluesky

Publica en Bluesky

En detalle: Cómo funciona la API de Bluesky en SocialAPI.ai

Publicación con el endpoint que ya llamas

Respuestas bajo tus publicaciones

Menciones de tu handle

Mensajes directos

Un esquema, un webhook, un solo conjunto de códigos de error

Precios simples y honestos.

Preguntas frecuentes

¿Bluesky tiene una API?

¿Puedo publicar en Bluesky a través de la API?

¿Puedo leer y responder comentarios en mis publicaciones de Bluesky?

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

¿Cómo conecto una cuenta de Bluesky?

¿Pueden los agentes de IA publicar en Bluesky?

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

¿Listo para unificar tus interacciones sociales?