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.

Endpoints de herramientas
HerramientaEndpointCaché HTTPCoste 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-checker60 segundos3 unidad(es)
Buscador de DID

El DID detrás de cualquier handle de Bluesky.

GET /api/v1/tools/did-finder60 segundos1 unidad(es)
Buscador de handle (de DID a handle)

El handle detrás de un DID.

GET /api/v1/tools/handle-finder60 segundos1 unidad(es)
Whois de Bluesky

Todo lo público sobre un handle o un DID.

GET /api/v1/tools/whois60 segundos3 unidad(es)
Edad de una cuenta

Mira cuándo se unió una cuenta a Bluesky.

GET /api/v1/tools/account-age60 segundos1 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-converter60 segundos1 unidad(es)
Decodificador de TID

Lee la fecha oculta en una clave de registro.

GET /api/v1/tools/tid-decoder1 año1 unidad(es)
Contador de caracteres

Cuenta tu post como lo cuenta Bluesky.

GET /api/v1/tools/character-counter1 año1 unidad(es)
Generador de facetas de texto enriquecido

Menciones, enlaces y hashtags con sus posiciones en bytes.

GET /api/v1/tools/facet-builderSin 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-checkerSin caché2 unidad(es)
Verificador de disponibilidad de handles

¿Tu nombre está libre en Bluesky?

GET /api/v1/tools/handle-availabilitySin caché1 unidad(es)
Historial PLC

Cada cambio de handle, de servidor y de clave de una cuenta.

GET /api/v1/tools/plc-history5 minutos2 unidad(es)
Analizador de starter packs

Quién está en un starter pack, con cifras y bots.

GET /api/v1/tools/starter-pack-analyser5 minutosSegú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-viewer60 segundos3 unidad(es)
Inspector de feeds

Previsualiza un feed personalizado y descubre por qué no muestra nada.

GET /api/v1/tools/feed-inspectorSin caché3 unidad(es)
Inspector de etiquetas

Descubre quién aplicó una etiqueta y qué significa.

GET /api/v1/tools/label-inspector5 minutosSegún la solicitud
Exportación de seguidores

Guarda una lista pública de seguidores o seguidos en CSV.

GET /api/v1/tools/follower-export5 minutos2 unidad(es)
Explorador de repositorios

Consulta los datos públicos de una cuenta en su servidor.

GET /api/v1/tools/repo-explorer5 minutos2 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
curl --fail --silent --show-error 'https://bluesky.bot/api/v1/tools/did-finder?handle=bluesky.bot'
JavaScript (Node.js 24)
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()));
Python 3
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)))
Capturado el

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": []
  }
}
Capturado el

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": []
  }
}
Capturado el

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.

Fuentes