API Bluesky gratuite : clés, limites et exemples testés
Les lectures publiques ne demandent pas votre mot de passe Bluesky. Utilisez AppView pour les données directes, ou nos outils gratuits pour une réponse regroupée.
Par L’équipe Bluesky.bot
- Publié:
- Modifié:
- Revu:
Faut-il une clé ?
Pour beaucoup de lectures publiques de profils, de fils et de publications, non : Bluesky exploite un AppView public à public.api.bsky.app. Ce service ne représente pas toutes les API du protocole AT. Écrire une publication exige une autorisation du compte et passe normalement par son PDS. Notre API d’outils ne publie rien, ne suit personne et ne supprime rien.
Appelez directement Bluesky lorsqu’une seule méthode XRPC suffit. Une vérification d’identité peut, elle, demander le DNS, HTTPS, le document DID et la réponse d’AppView. Nos outils regroupent ces observations et expliquent leurs désaccords. Un jeton créateur gratuit augmente les quotas ; les outils publics anonymes n’en demandent aucun.
Ce que répond chaque point d’accès
Le tableau vient du registre des outils exécutés. Le coût est un poids dans le quota, pas un prix ni un nombre garanti de requêtes externes. Le cache peut éviter une requête ; une vérification d’identité peut en demander plusieurs.
| Outil | Point d’accès | Cache HTTP | Coût dans le quota |
|---|---|---|---|
| Vérificateur de déclarations d’automatisation Voir les signaux d’automatisation publiés par un compte. | GET /api/v1/tools/bot-checker | 60 secondes | 3 unité(s) |
| Trouver un DID Le DID derrière n’importe quel handle Bluesky. | GET /api/v1/tools/did-finder | 60 secondes | 1 unité(s) |
| Trouver un handle (DID vers handle) Le handle derrière un DID. | GET /api/v1/tools/handle-finder | 60 secondes | 1 unité(s) |
| Whois Bluesky Tout ce qui est public sur un handle ou un DID. | GET /api/v1/tools/whois | 60 secondes | 3 unité(s) |
| Âge d’un compte Voyez quand un compte a rejoint Bluesky. | GET /api/v1/tools/account-age | 60 secondes | 1 unité(s) |
| Convertisseur d’AT URI D’un lien bsky.app à une URI at://, et retour. | GET /api/v1/tools/at-uri-converter | 60 secondes | 1 unité(s) |
| Décodeur de TID Lisez la date cachée dans une clé d’enregistrement. | GET /api/v1/tools/tid-decoder | 1 an | 1 unité(s) |
| Compteur de caractères Comptez votre post comme Bluesky le compte. | GET /api/v1/tools/character-counter | 1 an | 1 unité(s) |
| Générateur de facettes de texte enrichi Mentions, liens et hashtags avec leurs positions en octets. | GET /api/v1/tools/facet-builder | Sans cache | Selon la requête |
| Vérificateur de handle de domaine Découvrez pourquoi votre handle est invalide, et comment le corriger. | GET /api/v1/tools/custom-handle-checker | Sans cache | 2 unité(s) |
| Vérificateur de disponibilité de handle Votre nom est-il libre sur Bluesky ? | GET /api/v1/tools/handle-availability | Sans cache | 1 unité(s) |
| Historique PLC Chaque changement de handle, de serveur et de clé d’un compte. | GET /api/v1/tools/plc-history | 5 minutes | 2 unité(s) |
| Analyseur de starter packs Qui est dans un starter pack, avec les chiffres et les bots. | GET /api/v1/tools/starter-pack-analyser | 5 minutes | Selon la requête |
| Lecteur de posts et de fils Lisez n’importe quel post ou fil Bluesky public, sans compte. | GET /api/v1/tools/post-viewer | 60 secondes | 3 unité(s) |
| Inspecteur de flux Prévisualisez un flux personnalisé et découvrez pourquoi il n’affiche rien. | GET /api/v1/tools/feed-inspector | Sans cache | 3 unité(s) |
| Inspecteur de labels Identifiez l’auteur d’un label et sa signification. | GET /api/v1/tools/label-inspector | 5 minutes | Selon la requête |
| Export des abonnés Sauvegardez une liste publique d’abonnés ou d’abonnements en CSV. | GET /api/v1/tools/follower-export | 5 minutes | 2 unité(s) |
| Explorateur de dépôt Parcourez les données publiques d’un compte sur son serveur. | GET /api/v1/tools/repo-explorer | 5 minutes | 2 unité(s) |
Trois exemples réellement exécutés
Ces extraits ont été exécutés sur notre compte officiel. Chaque résultat porte sa date de capture ; les données publiques peuvent changer. Python utilise un User-Agent descriptif : l’agent Python-urllib par défaut a reçu une erreur HTTP 403 du réseau de diffusion pendant cette vérification.
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)))Entrée
curl --fail --silent --show-error 'https://bluesky.bot/api/v1/tools/did-finder?handle=bluesky.bot'
Sortie enregistrée
{
"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": []
}
}Entrée
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()));Sortie enregistrée
{
"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": []
}
}Entrée
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)))Sortie enregistrée
{
"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 et usage raisonnable
Anonyme : 60 unités de quota par 60 secondes et 2000 par 24 heures. Un jeton créateur valide multiplie ces deux limites par 10 si son propriétaire possède au moins un bot actif.
Un appel consomme le poids de l’outil dans les deux quotas. Les recherches serveur partagent aussi un budget externe ; une vérification complexe peut être refusée avant l’épuisement de votre quota.
Une réponse HTTP 429 contient Retry-After. Une saisie invalide donne 400, un résultat absent 404 et une panne externe 502, au format d’erreur API v1. Les réponses GET publiques permettent les lectures depuis d’autres sites ; un jeton refusé ne devient pas silencieusement un accès anonyme.
Nous comptons l’outil et le canal, pas votre saisie. Les paramètres de recherche des outils sont exclus des journaux d’accès. N’envoyez ni secret, ni publication privée, ni identifiants d’une autre personne.
Le service est gratuit et fourni au mieux, sans garantie contractuelle de disponibilité. Réutilisez les résultats mis en cache, respectez les délais et contactez-nous pour un autre usage.
Quand choisir un autre accès
Pour des publications en masse, des événements réseau en direct ou un consommateur permanent, utilisez directement les services du protocole AT ou Jetstream. Cette API de recherches bornées ne remplace pas un flux complet. Pour écrire, utilisez un client autorisé par le compte. Pour un client d’IA, découvrez le serveur MCP. La référence API et la référence des outils détaillent les paramètres et les erreurs.
Vous préférez le terminal ? Comparez les clients Bluesky en ligne de commande, avec la version publiée de bsbot et ses limites actuelles.
Questions
L’API Bluesky est-elle gratuite ?
L’AppView public de Bluesky permet de nombreuses lectures sans authentification ni clé, dans ses limites. Notre API d’outils publics est aussi gratuite.
Cette API peut-elle publier ?
Non. L’API d’outils lit des informations publiques et effectue des calculs. Les écritures autorisées par un compte passent par un client distinct.
Faut-il un jeton Bluesky.bot ?
Pas pour les outils publics. Les jetons créateurs admissibles augmentent le quota sans supprimer les limites externes.
Où trouver paramètres et schémas d’erreur ?
Consultez les références API et outils de la documentation développeur et le document OpenAPI.