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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
url | Erforderlich | Erforderlicher, 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.
- Bereiten Sie eine öffentliche bsky.app-URL vor, die auf den Bluesky-Beitrag verweist, den Sie untersuchen möchten.
- Senden Sie die URL als url an /v1/bluesky/post und speichern Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich abgeschlossen ist oder einen Fehler meldet.
- 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 trueAnwendungsfä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.
Verwandte APIs
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.