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.

Points d’accès des outils
OutilPoint d’accèsCache HTTPCoû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-checker60 secondes3 unité(s)
Trouver un DID

Le DID derrière n’importe quel handle Bluesky.

GET /api/v1/tools/did-finder60 secondes1 unité(s)
Trouver un handle (DID vers handle)

Le handle derrière un DID.

GET /api/v1/tools/handle-finder60 secondes1 unité(s)
Whois Bluesky

Tout ce qui est public sur un handle ou un DID.

GET /api/v1/tools/whois60 secondes3 unité(s)
Âge d’un compte

Voyez quand un compte a rejoint Bluesky.

GET /api/v1/tools/account-age60 secondes1 unité(s)
Convertisseur d’AT URI

D’un lien bsky.app à une URI at://, et retour.

GET /api/v1/tools/at-uri-converter60 secondes1 unité(s)
Décodeur de TID

Lisez la date cachée dans une clé d’enregistrement.

GET /api/v1/tools/tid-decoder1 an1 unité(s)
Compteur de caractères

Comptez votre post comme Bluesky le compte.

GET /api/v1/tools/character-counter1 an1 unité(s)
Générateur de facettes de texte enrichi

Mentions, liens et hashtags avec leurs positions en octets.

GET /api/v1/tools/facet-builderSans cacheSelon 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-checkerSans cache2 unité(s)
Vérificateur de disponibilité de handle

Votre nom est-il libre sur Bluesky ?

GET /api/v1/tools/handle-availabilitySans cache1 unité(s)
Historique PLC

Chaque changement de handle, de serveur et de clé d’un compte.

GET /api/v1/tools/plc-history5 minutes2 unité(s)
Analyseur de starter packs

Qui est dans un starter pack, avec les chiffres et les bots.

GET /api/v1/tools/starter-pack-analyser5 minutesSelon 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-viewer60 secondes3 unité(s)
Inspecteur de flux

Prévisualisez un flux personnalisé et découvrez pourquoi il n’affiche rien.

GET /api/v1/tools/feed-inspectorSans cache3 unité(s)
Inspecteur de labels

Identifiez l’auteur d’un label et sa signification.

GET /api/v1/tools/label-inspector5 minutesSelon la requête
Export des abonnés

Sauvegardez une liste publique d’abonnés ou d’abonnements en CSV.

GET /api/v1/tools/follower-export5 minutes2 unité(s)
Explorateur de dépôt

Parcourez les données publiques d’un compte sur son serveur.

GET /api/v1/tools/repo-explorer5 minutes2 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
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)))
Enregistré le

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": []
  }
}
Enregistré le

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": []
  }
}
Enregistré le

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.

Sources