Bluesky User Posts
Les publications d’un utilisateur Bluesky sont des contenus publics collectés pour un seul compte, à partir de son handle ou de son identifiant décentralisé. Chaque enregistrement normalisé peut conserver le texte, l’identité de l’auteur, les dates de source et de collecte, les médias publics, les hashtags, les mentions et les compteurs d’engagement disponibles.
Fonctionnalités de la Bluesky User Posts API
- Deux identifiants de compteEnvoyez exactement un identifiant : soit un handle Bluesky comme jay.bsky.team, soit un DID respectant la forme did:method:identifier.
- Collecte d’une page par compteUne seule requête est adressée au fournisseur pour le compte choisi, et les publications publiques exposées dans cette page source sont collectées, sans curseur source ni limite de résultats pilotés par l’appelant.
- Résultats stables au format publicationLisez l’identité, le texte, l’auteur, les horodatages, les métriques, les médias, les hashtags et les mentions normalisés d’une publication, sans dépendre de l’enveloppe de réponse d’un fournisseur.
Paramètres de la Bluesky User Posts API
| Paramètres | Obligatoire | Description |
|---|---|---|
username | Obligatoire (au moins un) | Handle Bluesky public de 1 à 253 caractères, composé de lettres, de chiffres, de points ou de traits d’union. Un @ initial n’est pas accepté ; omettez ce champ si vous fournissez user_id à la place. |
user_id | Obligatoire (au moins un) | Identifiant décentralisé Bluesky commençant par did:, suivi d’une méthode en minuscules et d’un identifiant non vide composé de lettres, de chiffres, de points, de tirets bas, de deux-points, de signes de pourcentage ou de traits d’union pris en charge. |
Comment utiliser la Bluesky User Posts API
Envoyez un handle ou un DID Bluesky, suivez la tâche asynchrone, puis lisez les enregistrements PostItem sauvegardés une fois la tâche terminée.
- Choisissez soit un handle Bluesky public sans @ initial, soit le DID du compte.
- Envoyez l’identifiant choisi en POST à /v1/bluesky/user-posts et conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou signale un échec.
- Lisez data.results.items ; n’utilisez le next_cursor de la réponse de la tâche que si le jeu de résultats sauvegardé comporte une autre page.
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 the task succeedsCas d’usage de la Bluesky User Posts API
- Instantanés du contenu d’un compte : Capturez à un instant donné une page de publications publiques pour un handle ou un DID connu, en gardant les ID de publication, les URL sources, les dates de publication et de collecte.
- Étude des habitudes de publication : Examinez le texte normalisé, la paternité, les hashtags, les mentions et les médias disponibles pour étudier les thèmes et les formats d’un compte public choisi.
- Comparaison de l’engagement visible : Comparez les J’aime, commentaires, partages et vues disponibles entre les publications collectées, en traitant un compteur absent comme indisponible plutôt que comme zéro.
Conseils d’expert pour la Bluesky User Posts API
- Envoyez les handles sans @ et vérifiez qu’ils ne contiennent que des lettres, des chiffres, des points et des traits d’union avant de créer une tâche.
- Utilisez le DID complet lorsque l’identité du compte doit rester stable malgré les changements de handle ; n’envoyez pas un ID d’utilisateur quelconque.
- N’ajoutez ni results_limit ni curseur source à la charge utile POST : la collecte côté fournisseur porte sur une seule page et ces champs sont rejetés.
- Considérez les détails de l’auteur, les médias, les hashtags, les mentions et les compteurs individuels comme facultatifs, et dédoublonnez les instantanés répétés grâce à l’id de la publication.
API associées
En complément de la Bluesky User Posts API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Bluesky.
- Bluesky Profile API — Récupérez un profil Bluesky public à partir d’un nom d’utilisateur validé, avec identité, biographie, visuels, site web, champs de statut, nombres visibles et contexte de collecte normalisés.
- Bluesky Post API — Transformez l’URL d’un post Bluesky public connu (bsky.app) en texte, auteur, médias, horodatage, tags, mentions et engagement visible normalisés.