bluesky/
post

Einen öffentlichen Bluesky-Beitrag aus einer bekannten bsky.app-URL erfassen – mit Text, Identität des Autors, Medien, Zeitstempeln, Hashtags, Erwähnungen und sichtbarer Interaktion.

Bluesky Post API

URL eines einzelnen Beitrags
Autorenkontext
Momentaufnahme der Interaktion
0,19 Credits pro Anfrage
Bereit
Bereit

Geben Sie Parameter ein und senden Sie eine Anfrage. Aufgabenstatus und normalisierte Ergebnisse erscheinen hier.

README

Von SocQ · Aktualisiert am

Bluesky Post

Bluesky-Beiträge sind öffentliche Veröffentlichungen mit Text, Identität des Autors, Medien, Zeitstempeln, Hashtags, Erwähnungen und sichtbaren Interaktionszahlen. Diese Datensätze unterstützen URL-Anreicherung, Quellenprüfung, Inhaltsrecherche und den Vergleich von Interaktionen mit Zeitstempel.

Funktionen der Bluesky Post API

  • Abfrage eines bekannten BeitragsLöst eine öffentliche bsky.app-URL in den normalisierten Datensatz genau dieses ausgewählten Beitrags auf, statt den Feed eines Kontos zu erweitern.
  • Inhalt und AutorenkontextLiefert den verfügbaren Beitragstext, die Quell-URL, die Identität des Autors, angehängte Medien, Hashtags, Erwähnungen und die Veröffentlichungszeit gemeinsam.
  • Sichtbare Momentaufnahme der InteraktionBehält die verfügbaren Zahlen zu Likes, Kommentaren, Reposts und Aufrufen zusammen mit der Erfassungszeit für eine Beobachtung zu einem bestimmten Zeitpunkt bei.

Parameter der Bluesky Post API

ParameterErforderlichBeschreibung
urlErforderlichErforderlicher, nicht leerer Verweis auf einen Beitrag, dessen geparster Hostname bsky.app oder eine Subdomain von bsky.app ist. Die Validierung der Übermittlung akzeptiert absolute Verweise mit beliebigem Schema sowie protokollrelative Verweise.

So verwenden Sie die Bluesky Post API

Senden Sie die URL eines bekannten öffentlichen Bluesky-Beitrags, verfolgen Sie die asynchrone Aufgabe und lesen Sie das normalisierte Ergebnis über die Standard-Ergebnishülle.

  1. Bereiten Sie eine öffentliche bsky.app-URL vor, die auf den Bluesky-Beitrag verweist, den Sie untersuchen möchten.
  2. Senden Sie die URL als url an /v1/bluesky/post und speichern Sie die zurückgegebene task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich abgeschlossen ist oder einen Fehler meldet.
  4. Lesen Sie data.results.items; folgen Sie next_cursor nur, wenn die Ergebnishülle has_more mit true meldet.
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

Anwendungsfälle der Bluesky Post API

  • Anreicherung einer bekannten Beitrags-URL: Wandeln Sie einen ausgewählten bsky.app-Link in strukturierte Felder zu Text, Autor, Medien, Zeitstempel, Tags, Erwähnungen, Kennzahlen und Quelle um.
  • Prüfung von Inhalt und Urheberschaft: Nutzen Sie Beitragstext, Identität des Autors, Medien und die öffentliche Quell-URL, um einen ausgewählten Beitrag mit nachvollziehbarer Zuordnung zu untersuchen.
  • Vergleich von Interaktionsbeobachtungen: Kombinieren Sie die sichtbaren Interaktionszahlen mit collected_at, um getrennt erfasste Momentaufnahmen zu vergleichen, ohne sie als Live-Stream zu behandeln.

Profi-Tipps zur Bluesky Post API

  • Stellen Sie sicher, dass der geparste Hostname bsky.app oder eine Subdomain von bsky.app ist. Die Validierung der Übermittlung schränkt das URL-Schema nicht ein und akzeptiert auch protokollrelative Verweise.
  • Verwenden Sie pro Aufgabe eine Beitrags-URL und lassen Sie results_limit weg, denn die Eingabe bezeichnet einen ausgewählten Beitrag und keine Feed-Seite.
  • Behandeln Sie Beitragstext, Angaben zum Autor, Medien, Hashtags, Erwähnungen, Veröffentlichungszeit und einzelne Kennzahlen als nullable Felder.
  • Speichern Sie collected_at zusammen mit den sichtbaren Interaktionszahlen, damit spätere Vergleiche festhalten, wann jede Beobachtung gemacht wurde.

Ergänzend zur Bluesky Post API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Bluesky-Daten benötigen.

  • Bluesky Profile API — Ein öffentliches Bluesky-Profil zu einem geprüften Benutzernamen abrufen – mit normalisierter Identität, Bio, Bildmaterial, Website, Statusfeldern, sichtbaren Kontozahlen und Erfassungskontext.
  • Bluesky User Posts API — Eine Seite öffentlicher Bluesky-Beiträge per Handle oder DID erfassen – mit normalisierten Inhalten, Autor, Medien, Zeitstempeln und sichtbaren Interaktionen.

Weitere Plattformen entdecken

Kombinieren Sie Bluesky-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

Bluesky Post API — FAQ

Bluesky Post API ist eine Schnittstelle, die einen öffentlichen Bluesky-Beitrag aus einer bekannten Beitrags-URL abruft. Sie liefert normalisierten Text, Identität des Autors, Medien, Zeitstempel, Hashtags, Erwähnungen und sichtbare Interaktionszahlen.

Senden Sie einen nicht leeren Verweis, dessen geparster Hostname bsky.app oder eine Subdomain von bsky.app ist. Das Backend akzeptiert absolute Verweise mit beliebigem Schema und protokollrelative Verweise; die Anfrage akzeptiert nur das Feld url.

Das Beitragsschema umfasst Identitäts- und Quellfelder, Text, Veröffentlichungs- und Erfassungszeit, Angaben zum Autor, Medien, Hashtags, Erwähnungen sowie die verfügbaren Zahlen zu Likes, Kommentaren, Reposts und Aufrufen. Nullable Felder bleiben leer, wenn die öffentliche Quelle keinen verwertbaren Wert bereitstellt.

Nein. Das Ergebnis bildet den ausgewählten Beitrag ab und kann eine sichtbare comments_count anzeigen, doch das Beitragsschema liefert keine eigenen Antwortdatensätze und keinen Antwortbaum.

Nein. Die Anfrage löst genau eine url auf und akzeptiert kein results_limit; lesen Sie den zurückgegebenen Eintrag über die Standard-Ergebnishülle der Aufgabe.

Jede erfolgreiche Bluesky-Post-Aufgabe kostet pauschal 0,19 SocQ-Credits. Die Gebühr hängt nicht von einer angeforderten oder zurückgegebenen Ergebnisanzahl ab.