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é | SocQ | Intégration directe |
|---|---|---|
| Usage principal | Collecter des profils publics, des publications connues et une page de publications d’un compte | Construire des workflows natifs de lecture ou d’écriture côté fournisseur |
| Authentification | Clé API SocQ | Identifiants selon la méthode et le service natifs |
| Entrée de départ | Nom d’utilisateur, URL de publication publique, handle ou DID selon l’endpoint | Identifiants natifs ou paramètres propres à chaque méthode |
| Format de réponse | Enregistrements SocQ normalisés | Objets 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. 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. Suivre la tâche
Interrogez /v1/tasks/{task_id} jusqu’à la réussite ou l’échec du traitement.
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.
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 successCas 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.
Combinez les données de plusieurs plateformes pour des analyses métier plus complètes
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.
Snapchat API
Récupérez un Spotlight Snapchat public connu sous forme d’enregistrement normalisé, avec les champs disponibles de créateur, de légende, de média, d’audio, de date, de durée et d’engagement.
Twitch API
Transformez un nom d’utilisateur Twitch public connu en profil normalisé, collectez son inventaire de vidéos publiques ou récupérez un clip avec sa vidéo téléchargeable pour l’étude des créateurs, l’enrichissement de catalogues, la comparaison et le suivi par instantanés.
Rednote API
Récupérez des profils et des notes publics, recherchez des notes ou des utilisateurs, collectez les commentaires et leurs réponses imbriquées, et capturez une page de recommandations de la page d’accueil.
Kwai API
Récupérez des profils Kwai publics, une page de publications d’un compte ou une publication connue, avec identité, contenu, médias, horodatages et engagement visible normalisés.
Truth Social API
Récupérez les détails d’un compte public, collectez une page source de publications d’un compte ou transformez l’URL d’une publication connue en enregistrements normalisés.
Google Ad Library API
Découvrez des annonceurs publics, collectez les créations d’une entreprise ou récupérez par URL une création connue du Transparency Center, pour la recherche et la vérification.


