API Bluesky gratuita: chaves, limites e exemplos

As leituras públicas não precisam da sua palavra-passe do Bluesky. Use o AppView para dados diretos ou as ferramentas gratuitas para uma resposta conjunta.

Por A equipa do Bluesky.bot

Publicado:
Atualizado:
Revisto:

Precisa de uma chave?

Para muitas leituras públicas de perfis, feeds e publicações, não: o Bluesky disponibiliza um AppView público em public.api.bsky.app. É um serviço do protocolo AT, não todas as suas API. Publicar exige autorização da conta e passa normalmente pelo respetivo PDS. A nossa API de ferramentas não publica, segue nem elimina nada.

Use o Bluesky diretamente quando basta um método XRPC. Uma verificação de identidade pode exigir DNS, HTTPS, o documento DID e o AppView. As nossas ferramentas reúnem estas observações e explicam divergências. Um token gratuito de criador aumenta as quotas; as ferramentas públicas anónimas não precisam dele.

O que responde cada ponto de acesso

A tabela é gerada a partir do registo de ferramentas executadas. O custo é um peso na quota, não dinheiro nem um número garantido de pedidos externos. A cache pode evitar um pedido; uma verificação de identidade pode precisar de vários.

Pontos de acesso das ferramentas
FerramentaPonto de acessoCache HTTPCusto na quota
Verificador de declarações de automatização

Consulte os sinais públicos de automatização de uma conta.

GET /api/v1/tools/bot-checker60 segundos3 unidade(s)
Localizador de DID

O DID por trás de qualquer handle do Bluesky.

GET /api/v1/tools/did-finder60 segundos1 unidade(s)
Localizador de handle (de DID para handle)

O handle por trás de um DID.

GET /api/v1/tools/handle-finder60 segundos1 unidade(s)
Whois do Bluesky

Tudo o que é público sobre um handle ou um DID.

GET /api/v1/tools/whois60 segundos3 unidade(s)
Idade de uma conta

Veja quando uma conta chegou ao Bluesky.

GET /api/v1/tools/account-age60 segundos1 unidade(s)
Conversor de AT URI

De uma ligação bsky.app para um URI at://, e de volta.

GET /api/v1/tools/at-uri-converter60 segundos1 unidade(s)
Descodificador de TID

Leia a data escondida numa chave de registo.

GET /api/v1/tools/tid-decoder1 ano1 unidade(s)
Contador de caracteres

Conte a sua publicação como o Bluesky a conta.

GET /api/v1/tools/character-counter1 ano1 unidade(s)
Gerador de facetas de texto rico

Menções, ligações e hashtags com as posições em bytes.

GET /api/v1/tools/facet-builderSem cacheConsoante o pedido
Verificador de handles de domínio próprio

Descubra porque é que o seu handle é inválido e como o corrigir.

GET /api/v1/tools/custom-handle-checkerSem cache2 unidade(s)
Verificador de disponibilidade de handles

O seu nome está livre no Bluesky?

GET /api/v1/tools/handle-availabilitySem cache1 unidade(s)
Histórico PLC

Cada mudança de handle, de servidor e de chave de uma conta.

GET /api/v1/tools/plc-history5 minutos2 unidade(s)
Analisador de starter packs

Quem está num starter pack, com números e bots.

GET /api/v1/tools/starter-pack-analyser5 minutosConsoante o pedido
Leitor de publicações e fios

Leia qualquer publicação ou fio público do Bluesky, sem conta.

GET /api/v1/tools/post-viewer60 segundos3 unidade(s)
Inspetor de feeds

Pré-visualize um feed personalizado e descubra porque não mostra nada.

GET /api/v1/tools/feed-inspectorSem cache3 unidade(s)
Inspetor de etiquetas

Saiba quem aplicou uma etiqueta e o que significa.

GET /api/v1/tools/label-inspector5 minutosConsoante o pedido
Exportação de seguidores

Guarde uma lista pública de seguidores ou seguidos em CSV.

GET /api/v1/tools/follower-export5 minutos2 unidade(s)
Explorador de repositórios

Consulte os dados públicos de uma conta no o seu servidor.

GET /api/v1/tools/repo-explorer5 minutos2 unidade(s)

Três exemplos executados

Estes exemplos foram executados com a nossa conta oficial. Cada resultado é uma captura datada, não uma resposta inventada. Os dados públicos podem mudar. O Python usa um User-Agent descritivo: o agente Python-urllib predefinido recebeu um erro HTTP 403 da rede de distribuição durante a verificação.

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 em

Entrada

curl --fail --silent --show-error 'https://bluesky.bot/api/v1/tools/did-finder?handle=bluesky.bot'

Saída 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 em

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()));

Saída 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 em

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)))

Saída 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": []
  }
}

Limites e utilização responsável

Anónimo: 60 unidades por 60 segundos e 2000 por 24 horas. Um token de criador válido multiplica ambos os limites por 10 se o proprietário tiver pelo menos um bot ativo.

Cada chamada consome o peso da ferramenta nas duas quotas. As consultas do servidor partilham também um orçamento externo; uma verificação complexa pode ser recusada antes de esgotar a sua quota.

HTTP 429 inclui Retry-After. Uma entrada inválida devolve 400, um resultado inexistente 404 e uma falha externa 502, no formato de erros API v1. As respostas GET públicas permitem leitura a partir de outras origens; um token recusado não se transforma silenciosamente em acesso anónimo.

Contamos a ferramenta e o canal, não a sua entrada. As consultas das ferramentas ficam fora dos registos de acesso. Não envie segredos, publicações privadas ou credenciais de terceiros.

O serviço é gratuito e disponibilizado sem SLA de disponibilidade. Reutilize resultados em cache, respeite os intervalos e contacte-nos para outras utilizações.

Quando escolher outro acesso

Para publicações em massa, eventos de rede em direto ou um consumidor permanente, use os serviços do protocolo AT ou o Jetstream diretamente. Esta API de consultas limitadas não substitui o fluxo completo. Para escrever, use um cliente autorizado pela conta. Para clientes de IA, consulte o servidor MCP. A referência API e a referência de ferramentas detalham parâmetros e erros.

Prefere o terminal? Compare os clientes Bluesky de linha de comandos, incluindo a versão publicada do bsbot e os seus limites atuais.

Perguntas

A API do Bluesky é gratuita?

O AppView público do Bluesky permite muitas leituras sem autenticação nem chave, dentro dos limites. A nossa API de ferramentas públicas também é gratuita.

Esta API pode publicar?

Não. A API de ferramentas lê informação pública e faz cálculos. As escritas autorizadas pertencem a um cliente separado.

Preciso de um token Bluesky.bot?

Não para ferramentas públicas. Os tokens de criadores elegíveis aumentam a quota sem remover os limites externos.

Onde estão os parâmetros e esquemas de erro?

Nas referências API e de ferramentas da documentação para programadores e no documento OpenAPI.

Fontes