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.
| Ferramenta | Ponto de acesso | Cache HTTP | Custo 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-checker | 60 segundos | 3 unidade(s) |
| Localizador de DID O DID por trás de qualquer handle do Bluesky. | GET /api/v1/tools/did-finder | 60 segundos | 1 unidade(s) |
| Localizador de handle (de DID para handle) O handle por trás de um DID. | GET /api/v1/tools/handle-finder | 60 segundos | 1 unidade(s) |
| Whois do Bluesky Tudo o que é público sobre um handle ou um DID. | GET /api/v1/tools/whois | 60 segundos | 3 unidade(s) |
| Idade de uma conta Veja quando uma conta chegou ao Bluesky. | GET /api/v1/tools/account-age | 60 segundos | 1 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-converter | 60 segundos | 1 unidade(s) |
| Descodificador de TID Leia a data escondida numa chave de registo. | GET /api/v1/tools/tid-decoder | 1 ano | 1 unidade(s) |
| Contador de caracteres Conte a sua publicação como o Bluesky a conta. | GET /api/v1/tools/character-counter | 1 ano | 1 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-builder | Sem cache | Consoante 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-checker | Sem cache | 2 unidade(s) |
| Verificador de disponibilidade de handles O seu nome está livre no Bluesky? | GET /api/v1/tools/handle-availability | Sem cache | 1 unidade(s) |
| Histórico PLC Cada mudança de handle, de servidor e de chave de uma conta. | GET /api/v1/tools/plc-history | 5 minutos | 2 unidade(s) |
| Analisador de starter packs Quem está num starter pack, com números e bots. | GET /api/v1/tools/starter-pack-analyser | 5 minutos | Consoante 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-viewer | 60 segundos | 3 unidade(s) |
| Inspetor de feeds Pré-visualize um feed personalizado e descubra porque não mostra nada. | GET /api/v1/tools/feed-inspector | Sem cache | 3 unidade(s) |
| Inspetor de etiquetas Saiba quem aplicou uma etiqueta e o que significa. | GET /api/v1/tools/label-inspector | 5 minutos | Consoante o pedido |
| Exportação de seguidores Guarde uma lista pública de seguidores ou seguidos em CSV. | GET /api/v1/tools/follower-export | 5 minutos | 2 unidade(s) |
| Explorador de repositórios Consulte os dados públicos de uma conta no o seu servidor. | GET /api/v1/tools/repo-explorer | 5 minutos | 2 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 --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'
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": []
}
}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": []
}
}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.