Bluesky Profile
Les profils Bluesky sont des fiches de compte publiques avec un identifiant durable, un handle, un nom affiché, une biographie, des visuels de profil, un site web et les nombres visibles d’abonnés, d’abonnements et de publications. Ces champs d’identité et ces signaux de compte servent à enrichir des profils, à comparer des comptes publics et à observer leur évolution dans le temps.
Fonctionnalités de la Bluesky Profile API
- Recherche directe par nom d’utilisateurTransformez un nom d’utilisateur de 1 à 253 lettres, chiffres, points ou traits d’union en fiche de profil publique.
- Identité de profil normaliséeRenvoie l’ID du profil, l’URL source, le nom d’utilisateur, le nom affiché, la biographie et le site web lié, disponibles, dans une structure de compte homogène.
- Visuels de profil et champs de statutConserve l’avatar, la couverture et les valeurs de vérification et de confidentialité disponibles comme champs nullables, sans inventer de valeur lorsque la source les omet.
- Instantané des nombres de compte visiblesRegroupe les nombres d’abonnés, d’abonnements et de publications avec collected_at, pour que chaque instantané public d’un compte porte une heure d’observation.
Paramètres de la Bluesky Profile API
| Paramètres | Obligatoire | Description |
|---|---|---|
username | Obligatoire | Nom d’utilisateur Bluesky public obligatoire, de 1 à 253 lettres, chiffres, points ou traits d’union. N’incluez ni @ initial, ni tiret bas, ni DID, ni URL de profil, ni second nom d’utilisateur. |
Comment utiliser la Bluesky Profile API
Envoyez un nom d’utilisateur validé, suivez la tâche asynchrone, puis lisez le profil normalisé dans la réponse de résultat standard.
- Préparez un nom d’utilisateur Bluesky composé de lettres, de chiffres, de points ou de traits d’union, par exemple jay.bsky.team, sans le @ initial.
- Envoyez username à /v1/bluesky/profile et conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou renvoie un échec.
- Lisez data.results.items. Cette recherche ne stocke normalement qu’un profil, donc has_more vaut false ; si la réponse de résultat générique signale d’autres données, poursuivez avec next_cursor.
curl -X POST "https://api.socq.ai/v1/bluesky/profile" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"jay.bsky.team"}'
# Poll GET /v1/tasks/{task_id}
# Read the profile from data.results.itemsCas d’usage de la Bluesky Profile API
- Enrichissement de profils connus : Ajoutez un handle public, un nom affiché, une biographie, des images de profil, un site web et une URL source à un enregistrement qui contient déjà un nom d’utilisateur Bluesky.
- Comparaison de l’empreinte des comptes : Comparez les nombres d’abonnés, d’abonnements et de publications disponibles pour des noms d’utilisateur envoyés séparément, grâce aux mêmes clés de métriques normalisées.
- Suivi de la présentation d’un profil : Stockez identité, biographie, visuels, site web et collected_at au fil de tâches répétées pour repérer les changements entre instantanés publics.
Conseils d’expert pour la Bluesky Profile API
- Retirez le @ initial et vérifiez que le nom d’utilisateur restant ne contient que des lettres, des chiffres, des points et des traits d’union avant l’envoi ; rejetez les valeurs DID, car cet endpoint n’accepte pas user_id.
- Utilisez l’id renvoyé comme clé de dédoublonnage de préférence, puis repliez-vous sur url ou username lorsque id est vide.
- Acceptez que biographie, avatar, couverture, site web, indicateurs de statut, localisation et métriques individuelles soient null, afin que les fiches publiques partielles restent exploitables.
- N’ajoutez ni results_limit ni tableau username : envoyez chaque nom d’utilisateur dans sa propre tâche à tarif fixe et considérez le résultat normal comme un profil unique.
API associées
En complément de la Bluesky Profile API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Bluesky.
- 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.
- Bluesky User Posts API — Collectez une page de posts Bluesky publics par handle ou DID avec contenu, auteur, médias, horodatages et engagement visible normalisés.