API gratuita de Bluesky: claves, límites y ejemplos
Las lecturas públicas no necesitan tu contraseña de Bluesky. Usa AppView para datos directos o nuestras herramientas gratuitas para una respuesta combinada.
Por El equipo de Bluesky.bot
- Publicado:
- Actualizado:
- Revisado:
¿Hace falta una clave?
Para muchas lecturas públicas de perfiles, feeds y publicaciones, no: Bluesky ofrece un AppView público en public.api.bsky.app. Es un servicio del protocolo AT, no todas sus API. Publicar necesita autorización de la cuenta y normalmente pasa por su PDS. Nuestra API de herramientas no publica, sigue ni elimina nada.
Llama a Bluesky directamente cuando basta un método XRPC. Una comprobación de identidad puede necesitar DNS, HTTPS, el documento DID y AppView. Nuestras herramientas reúnen esas observaciones y explican las diferencias. Un token gratuito de creador aumenta las cuotas; las herramientas públicas anónimas no lo necesitan.
Qué responde cada endpoint
La tabla se genera desde el registro de herramientas ejecutadas. El coste es un peso en la cuota, no dinero ni un número garantizado de solicitudes externas. La caché puede evitar una solicitud; una comprobación de identidad puede necesitar varias.
| Herramienta | Endpoint | Caché HTTP | Coste en la cuota |
|---|---|---|---|
| Comprobador de declaraciones de automatización Consulta las señales de automatización públicas de una cuenta. | GET /api/v1/tools/bot-checker | 60 segundos | 3 unidad(es) |
| Buscador de DID El DID detrás de cualquier handle de Bluesky. | GET /api/v1/tools/did-finder | 60 segundos | 1 unidad(es) |
| Buscador de handle (de DID a handle) El handle detrás de un DID. | GET /api/v1/tools/handle-finder | 60 segundos | 1 unidad(es) |
| Whois de Bluesky Todo lo público sobre un handle o un DID. | GET /api/v1/tools/whois | 60 segundos | 3 unidad(es) |
| Edad de una cuenta Mira cuándo se unió una cuenta a Bluesky. | GET /api/v1/tools/account-age | 60 segundos | 1 unidad(es) |
| Conversor de AT URI De un enlace de bsky.app a una URI at://, y al revés. | GET /api/v1/tools/at-uri-converter | 60 segundos | 1 unidad(es) |
| Decodificador de TID Lee la fecha oculta en una clave de registro. | GET /api/v1/tools/tid-decoder | 1 año | 1 unidad(es) |
| Contador de caracteres Cuenta tu post como lo cuenta Bluesky. | GET /api/v1/tools/character-counter | 1 año | 1 unidad(es) |
| Generador de facetas de texto enriquecido Menciones, enlaces y hashtags con sus posiciones en bytes. | GET /api/v1/tools/facet-builder | Sin caché | Según la solicitud |
| Verificador de handles con dominio propio Descubre por qué tu handle no es válido y cómo arreglarlo. | GET /api/v1/tools/custom-handle-checker | Sin caché | 2 unidad(es) |
| Verificador de disponibilidad de handles ¿Tu nombre está libre en Bluesky? | GET /api/v1/tools/handle-availability | Sin caché | 1 unidad(es) |
| Historial PLC Cada cambio de handle, de servidor y de clave de una cuenta. | GET /api/v1/tools/plc-history | 5 minutos | 2 unidad(es) |
| Analizador de starter packs Quién está en un starter pack, con cifras y bots. | GET /api/v1/tools/starter-pack-analyser | 5 minutos | Según la solicitud |
| Visor de publicaciones e hilos Lee cualquier publicación o hilo público de Bluesky, sin cuenta. | GET /api/v1/tools/post-viewer | 60 segundos | 3 unidad(es) |
| Inspector de feeds Previsualiza un feed personalizado y descubre por qué no muestra nada. | GET /api/v1/tools/feed-inspector | Sin caché | 3 unidad(es) |
| Inspector de etiquetas Descubre quién aplicó una etiqueta y qué significa. | GET /api/v1/tools/label-inspector | 5 minutos | Según la solicitud |
| Exportación de seguidores Guarda una lista pública de seguidores o seguidos en CSV. | GET /api/v1/tools/follower-export | 5 minutos | 2 unidad(es) |
| Explorador de repositorios Consulta los datos públicos de una cuenta en su servidor. | GET /api/v1/tools/repo-explorer | 5 minutos | 2 unidad(es) |
Tres ejemplos ejecutados
Estos ejemplos se ejecutaron con nuestra cuenta oficial. Cada resultado es una captura fechada, no una respuesta preparada. Los datos públicos pueden cambiar. Python incluye un User-Agent descriptivo: el agente Python-urllib predeterminado recibió un HTTP 403 de la red de distribución durante esta comprobación.
curl --fail --silent --show-error 'https://bluesky.bot/api/v1/tools/did-finder?handle=bluesky.bot'const response = await fetch(
"https://bluesky.bot/api/v1/tools/did-finder?handle=bluesky.bot",
);
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(JSON.stringify(await response.json()));import json
from urllib.request import Request, urlopen
request = Request('https://bluesky.bot/api/v1/tools/did-finder?handle=bluesky.bot', headers={'User-Agent': 'Bluesky.bot-docs/1.0 (+https://bluesky.bot/tools/api)'})
with urlopen(request, timeout=10) as response:
print(json.dumps(json.load(response)))Entrada
curl --fail --silent --show-error 'https://bluesky.bot/api/v1/tools/did-finder?handle=bluesky.bot'
Salida capturada
{
"tool": "did-finder",
"url": "https://bluesky.bot/tools/did-finder",
"result": {
"status": "found",
"handle": "bluesky.bot",
"unicodeHandle": null,
"dns": {
"status": "found",
"did": "did:plc:ulmk4vmvoobkemd3w2tkwhu5"
},
"https": {
"status": "none"
},
"appview": {
"status": "found",
"did": "did:plc:ulmk4vmvoobkemd3w2tkwhu5"
},
"did": "did:plc:ulmk4vmvoobkemd3w2tkwhu5",
"method": "dns",
"verified": true,
"claimedHandle": null,
"warnings": []
}
}Entrada
const response = await fetch('https://bluesky.bot/api/v1/tools/did-finder?handle=bluesky.bot');
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(JSON.stringify(await response.json()));Salida capturada
{
"tool": "did-finder",
"url": "https://bluesky.bot/tools/did-finder",
"result": {
"status": "found",
"handle": "bluesky.bot",
"unicodeHandle": null,
"dns": {
"status": "found",
"did": "did:plc:ulmk4vmvoobkemd3w2tkwhu5"
},
"https": {
"status": "none"
},
"appview": {
"status": "found",
"did": "did:plc:ulmk4vmvoobkemd3w2tkwhu5"
},
"did": "did:plc:ulmk4vmvoobkemd3w2tkwhu5",
"method": "dns",
"verified": true,
"claimedHandle": null,
"warnings": []
}
}Entrada
import json
from urllib.request import Request, urlopen
request = Request('https://bluesky.bot/api/v1/tools/did-finder?handle=bluesky.bot', headers={'User-Agent': 'Bluesky.bot-docs/1.0 (+https://bluesky.bot/tools/api)'})
with urlopen(request, timeout=10) as response:
print(json.dumps(json.load(response)))Salida capturada
{
"tool": "did-finder",
"url": "https://bluesky.bot/tools/did-finder",
"result": {
"status": "found",
"handle": "bluesky.bot",
"unicodeHandle": null,
"dns": {
"status": "found",
"did": "did:plc:ulmk4vmvoobkemd3w2tkwhu5"
},
"https": {
"status": "none"
},
"appview": {
"status": "found",
"did": "did:plc:ulmk4vmvoobkemd3w2tkwhu5"
},
"did": "did:plc:ulmk4vmvoobkemd3w2tkwhu5",
"method": "dns",
"verified": true,
"claimedHandle": null,
"warnings": []
}
}Límites y uso razonable
Anónimo: 60 unidades por 60 segundos y 2000 por 24 horas. Un token de creador válido multiplica ambos límites por 10 si su propietario tiene al menos un bot activo.
Cada llamada consume el peso de la herramienta en ambas cuotas. Las consultas del servidor también comparten un presupuesto externo; una comprobación compleja puede rechazarse antes de agotar tu cuota.
HTTP 429 incluye Retry-After. Una entrada inválida devuelve 400, un resultado ausente 404 y un fallo externo 502, con el formato de errores API v1. Las respuestas GET públicas permiten lectura desde otros orígenes; un token rechazado no se convierte silenciosamente en acceso anónimo.
Contamos herramienta y canal, no tu entrada. Las consultas de herramientas se excluyen de los registros de acceso. No envíes secretos, publicaciones privadas ni credenciales ajenas.
El servicio es gratuito y se ofrece sin SLA de disponibilidad. Reutiliza resultados en caché, respeta los retrasos y contacta con nosotros para otros usos.
Cuándo usar otro acceso
Para publicaciones masivas, eventos de red en directo o un consumidor permanente, usa los servicios del protocolo AT o Jetstream directamente. Esta API de consultas limitadas no sustituye el flujo completo. Para escribir, usa un cliente autorizado por la cuenta. Para clientes de IA, consulta el servidor MCP. La referencia API y la referencia de herramientas detallan parámetros y errores.
¿Prefieres el terminal? Compara los clientes de Bluesky por línea de comandos, con la versión publicada de bsbot y sus límites actuales.
Preguntas
¿Es gratuita la API de Bluesky?
El AppView público de Bluesky permite muchas lecturas sin autenticación ni clave, dentro de sus límites. Nuestra API de herramientas públicas también es gratuita.
¿Puede publicar esta API?
No. La API de herramientas lee información pública y hace cálculos. Las escrituras autorizadas pertenecen a un cliente separado.
¿Necesito un token de Bluesky.bot?
No para herramientas públicas. Los tokens de creadores aptos aumentan la cuota sin quitar los límites externos.
¿Dónde están los parámetros y esquemas de error?
En las referencias API y de herramientas de la documentación para desarrolladores y en el documento OpenAPI.