bluesky/
profile

Récupérez un profil Bluesky public à partir d’un nom d’utilisateur validé et obtenez identité normalisée, biographie, images de profil, site web et nombres de compte visibles en une seule tâche asynchrone.

Bluesky Profile API

Nom d’utilisateur validé en entrée
Identité et visuels du profil
Nombres de compte visibles
0,19 crédit par requête
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

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ètresObligatoireDescription
usernameObligatoireNom 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.

  1. 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.
  2. Envoyez username à /v1/bluesky/profile et conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou renvoie un échec.
  4. 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.items

Cas 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.

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.

Explorer d’autres plateformes

Combinez les données Bluesky avec les données publiques d’autres plateformes sociales prises en charge.

Bluesky Profile API — FAQ

Bluesky Profile API est une interface programmatique qui récupère un profil Bluesky public à partir d’un nom d’utilisateur validé. Elle renvoie l’identité normalisée, la biographie, les images de profil, le site web, des champs de statut facultatifs, les nombres de compte visibles et l’heure de collecte.

Envoyez de 1 à 253 lettres, chiffres, points ou traits d’union, sans @ initial. Les tirets bas, deux-points, URL de profil, DID, valeurs vides et champs de requête supplémentaires sont rejetés.

La fiche de compte standard comprend les champs d’identité et de source, le nom d’utilisateur, le nom affiché, la biographie, l’avatar, la couverture, le site web, les valeurs de vérification et de confidentialité, la localisation facultative, les nombres d’abonnés, d’abonnements et de publications, ainsi que l’heure de collecte. Les champs facultatifs restent à null lorsqu’ils sont indisponibles.

Non. Chaque tâche accepte un seul nom d’utilisateur et renvoie normalement au plus un profil, sans results_limit ni curseur d’entrée contrôlé par l’appelant ; les résultats de la tâche utilisent tout de même l’enveloppe standard next_cursor et has_more.

Chaque tâche réussie coûte 0,19 crédit SocQ, tarif fixe. Le prélèvement ne varie pas avec le nombre de résultats, car la requête effectue une seule recherche de profil.