bluesky/
post

Collectez une publication Bluesky publique à partir d’une URL bsky.app connue et obtenez texte, identité de l’auteur, médias, horodatages, hashtags, mentions et engagement visible.

Bluesky Post API

URL d’une seule publication
Contexte de l’auteur
Instantané d’engagement
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 Post

Les publications Bluesky sont des contenus publics réunissant texte, identité de l’auteur, médias, horodatages, hashtags, mentions et compteurs d’engagement visibles. Ces enregistrements servent à enrichir des URL, à vérifier une source, à mener des recherches sur les contenus et à comparer l’engagement à des dates précises.

Fonctionnalités de la Bluesky Post API

  • Recherche d’une publication connueTransformez une URL publique bsky.app en enregistrement normalisé de la publication choisie, sans développer le fil d’un compte.
  • Contenu et contexte de l’auteurObtenez ensemble le texte disponible de la publication, l’URL source, l’identité de l’auteur, les médias joints, les hashtags, les mentions et la date de publication.
  • Instantané de l’engagement visibleConservez les nombres de mentions J’aime, de commentaires, de reposts et de vues disponibles avec l’heure de collecte, pour une observation à un instant donné.

Paramètres de la Bluesky Post API

ParamètresObligatoireDescription
urlObligatoireRéférence de publication obligatoire et non vide dont le nom d’hôte analysé est bsky.app ou un sous-domaine de bsky.app. Le validateur accepte les références absolues avec n’importe quel schéma, ainsi que les références relatives au protocole.

Comment utiliser la Bluesky Post API

Envoyez l’URL d’une publication Bluesky publique connue, suivez la tâche asynchrone, puis lisez le résultat normalisé dans l’enveloppe de résultat standard.

  1. Préparez une URL bsky.app publique qui mène à la publication Bluesky que vous souhaitez examiner.
  2. Envoyez l’URL sous le nom url à /v1/bluesky/post 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 ; ne suivez next_cursor que si l’enveloppe de résultat indique has_more à true.
curl -X POST "https://api.socq.ai/v1/bluesky/post" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://bsky.app/profile/jay.bsky.team/post/3micofpyeys2g"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor only while has_more is true

Cas d’usage de la Bluesky Post API

  • Enrichir l’URL d’une publication connue : Convertissez un lien bsky.app choisi en champs structurés de texte, d’auteur, de médias, d’horodatage, de tags, de mentions, de métriques et de source.
  • Vérifier le contenu et l’attribution : Appuyez-vous sur le texte de la publication, l’identité de l’auteur, les médias et l’URL source publique pour examiner une publication choisie avec une attribution traçable.
  • Comparer des observations d’engagement : Associez les compteurs d’engagement visibles à collected_at pour comparer des instantanés collectés séparément, sans les assimiler à un flux en direct.

Conseils d’expert pour la Bluesky Post API

  • Vérifiez que le nom d’hôte analysé est bsky.app ou un sous-domaine de bsky.app. Le validateur ne restreint pas le schéma de l’URL et accepte aussi les références relatives au protocole.
  • Utilisez une seule URL de publication par tâche et omettez results_limit, car l’entrée désigne une publication précise et non une page de fil.
  • Considérez le texte de la publication, les détails de l’auteur, les médias, les hashtags, les mentions, la date de publication et chaque métrique comme des champs nullables.
  • Stockez collected_at avec les compteurs d’engagement visibles, afin que les comparaisons ultérieures gardent la trace du moment de chaque observation.

En complément de la Bluesky Post 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 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 Post API — FAQ

Bluesky Post API est une interface programmatique qui récupère une publication Bluesky publique à partir d’une URL de publication connue. Elle renvoie le texte, l’identité de l’auteur, les médias, les horodatages, les hashtags, les mentions et les compteurs d’engagement visibles sous forme normalisée.

Envoyez une référence non vide dont le nom d’hôte analysé est bsky.app ou un sous-domaine de bsky.app. Le backend accepte les références absolues avec n’importe quel schéma ainsi que les références relatives au protocole ; la requête n’accepte que le champ url.

Le schéma de publication comprend les champs d’identité et de source, le texte, les dates de publication et de collecte, les détails de l’auteur, les médias, les hashtags, les mentions et les nombres de J’aime, de commentaires, de reposts et de vues disponibles. Les champs nullables restent vides lorsque la source publique n’expose aucune valeur exploitable.

Non. Le résultat représente la publication choisie et peut exposer un comments_count visible, mais le schéma de publication ne renvoie ni enregistrements de réponses distincts ni arbre de réponses.

Non. La requête résout une seule url et n’accepte pas results_limit ; lisez l’élément renvoyé via l’enveloppe de résultat standard de la tâche.

Chaque tâche Bluesky Post réussie coûte 0,19 crédit SocQ, tarif fixe. Le prélèvement ne dépend pas du nombre de résultats demandé ou renvoyé.