Retour aux API
Données publiques Bluesky

Bluesky Public Data API

Récupérez des profils Bluesky publics, résolvez des URL de publications connues ou collectez une page de publications d’un compte, avec identité, contenu, médias, horodatages et champs d’engagement visibles normalisés.

API Bluesky disponibles

Utilisez Profiles pour les données de compte, Posts pour une publication publique connue, ou User Posts pour une page de publications d’un handle ou d’un DID.

Quelles données Bluesky pouvez-vous récupérer ?

SocQ renvoie des enregistrements publics normalisés de profils et de publications, avec le contexte de source et de date de collecte.

Détails des profils publics

Récupérez l’identité du compte, la biographie, les images de profil, le site web, les indicateurs de compte, les nombres visibles et la date de collecte, lorsqu’ils sont disponibles.

Contenu d’une publication connue

Résolvez une URL bsky.app publique en identité de publication, texte, détails de l’auteur, médias, horodatages, hashtags et mentions.

Publications de comptes sélectionnés

Collectez une page source de publications publiques à partir d’un handle sans @ ou d’un DID Bluesky valide.

Engagement visible

Conservez les nombres disponibles de likes, de commentaires, de reposts, de partages et de vues comme observations à un instant donné.

SocQ vs une intégration Bluesky directe

SocQ propose un workflow de collecte asynchrone et normalisé ; avec une intégration directe, le transport, les objets sources, le stockage et la projection des résultats restent à la charge de votre application.

FonctionnalitéSocQIntégration directe
Usage principalCollecter des profils publics, des publications connues et une page de publications d’un compteConstruire des workflows natifs de lecture ou d’écriture côté fournisseur
AuthentificationClé API SocQIdentifiants selon la méthode et le service natifs
Entrée de départNom d’utilisateur, URL de publication publique, handle ou DID selon l’endpointIdentifiants natifs ou paramètres propres à chaque méthode
Format de réponseEnregistrements SocQ normalisésObjets natifs du fournisseur que votre application doit mapper

Fonctionnement de l’API Bluesky

Profiles, Posts et User Posts suivent le même workflow : tâche asynchrone, puis résultats sauvegardés paginés.

  1. 1. Envoyer un identifiant pris en charge

    Envoyez un nom d’utilisateur, une URL de publication, un handle ou un DID à l’API correspondante et conservez le task_id renvoyé.

  2. 2. Suivre la tâche

    Interrogez /v1/tasks/{task_id} jusqu’à la réussite ou l’échec du traitement.

  3. 3. Récupérer les résultats

    Lisez data.results.items et n’utilisez next_cursor que tant qu’il reste des résultats sauvegardés.

Collecter les publications d’un handle Bluesky

Authentifiez-vous avec votre clé API SocQ et envoyez un handle public à User Posts. Profiles et Posts suivent le même flux de tâche.

curl -X POST "https://api.socq.ai/v1/bluesky/user-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"jay.bsky.team"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items after success

Cas d’usage courants de l’API Bluesky

Étude de profils

Enrichissez des noms d’utilisateur connus avec l’identité publique, la biographie, les images, le site web, les indicateurs visibles et la date de collecte.

Analyse de publications connues

Résolvez des URL de publications sélectionnées en champs normalisés de contenu, d’auteur, de médias, d’horodatage, de référence, d’engagement et de source.

Instantanés de comptes publics

Capturez une page de publications pour un handle ou un DID connu et conservez les horodatages de source et de collecte.

Comparaison de l’engagement

Comparez les compteurs visibles d’une collecte à l’autre, en les traitant comme des instantanés à un moment donné.

Limites et politique sur les données publiques

Les résultats Bluesky représentent les champs publics disponibles pendant la collecte. Ces API n’accèdent à aucun contenu privé et ne publient, ne modifient, ne suppriment ni ne gèrent de comptes ou de publications.

  • Profiles exige un nom d’utilisateur validé et n’accepte pas les URL de profil.
  • Posts accepte une seule référence non vide dont le nom d’hôte analysé est bsky.app ou un sous-domaine de bsky.app, y compris les références absolues avec n’importe quel schéma et les références relatives au protocole ; il ne collecte ni flux de compte ni arbre de réponses.
  • User Posts exige username ou user_id ; le handle ne doit pas comporter de @, et user_id doit être un DID.
  • User Posts n’accepte ni results_limit ni curseur de source et ne collecte qu’une seule page du fournisseur.
  • Le curseur et la limite des résultats de tâche paginent des enregistrements déjà sauvegardés par SocQ ; ils ne collectent pas une autre page de la source.
  • Les champs facultatifs d’identité, de contenu, de médias, d’horodatage, de référence et d’engagement peuvent être vides lorsqu’ils sont indisponibles.

Questions fréquentes sur l’API Bluesky

Qu’est-ce que l’API Bluesky ?

Les API Bluesky récupèrent des profils publics, résolvent des publications connues et collectent une page de publications publiques d’un compte, par handle ou DID.

Quelle API Bluesky dois-je utiliser ?

Utilisez Profiles pour un enregistrement de compte à partir d’un nom d’utilisateur, Posts pour une URL bsky.app de publication connue, et User Posts pour une page de publications d’un handle ou d’un DID.

User Posts suit-il un curseur de source ?

Non. Il envoie une seule requête au fournisseur et collecte une page source ; next_cursor ne fait avancer que dans les enregistrements déjà stockés par SocQ.

Chaque champ et chaque indicateur sont-ils toujours présents ?

Non. La structure normalisée est stable, mais les valeurs d’identité, de contenu, de médias, d’horodatage, de référence et d’indicateurs qui dépendent de la source peuvent valoir null.

Quel est le tarif de la collecte Bluesky ?

Chaque tâche Profiles, Posts ou User Posts réussie coûte un montant fixe de 0,19 crédit SocQ.

Réunissez dans un même workflow les profils publics, les contenus et les données d’engagement de différentes plateformes pour suivre des marques, des créateurs et des sujets, et mener plus efficacement une veille et des analyses multiplateformes.