bluesky/
user-posts

Eine Seite öffentlicher Bluesky-Beiträge per Handle oder DID erfassen – mit normalisiertem Text, Identität des Autors, Zeitstempeln, Interaktionskennzahlen und verfügbaren Medien.

Bluesky User Posts API

Eingabe per Handle oder DID
Eine Quellseite
Normalisierte Beitragsdatensätze
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 User Posts

Bluesky User Posts sind öffentliche Beiträge, die von einem einzelnen Konto über dessen Handle oder dezentralen Identifier erfasst werden. Jeder normalisierte Datensatz kann Beitragstext, Identität des Autors, Zeiten der Quelle und der Erfassung, öffentliche Medien, Hashtags, Erwähnungen und verfügbare Interaktionszähler enthalten.

Funktionen der Bluesky User Posts API

  • Zwei KontokennungenÜbergeben Sie genau eine Kennung: entweder einen Bluesky-Handle wie jay.bsky.team oder eine DID in der Form did:method:identifier.
  • Erfassung einer KontoseiteSendet eine Anbieteranfrage für das ausgewählte Konto und erfasst die öffentlichen Beiträge, die diese Quellseite bereitstellt, ohne vom Aufrufer steuerbaren Quell-Cursor oder Ergebnislimit.
  • Stabile Ergebnisse in BeitragsformLesen Sie normalisierte Beitragsidentität, Text, Autor, Zeitstempel, Kennzahlen, Medien, Hashtags und Erwähnungen, statt sich auf eine Antworthülle des Anbieters zu verlassen.

Parameter der Bluesky User Posts API

ParameterErforderlichBeschreibung
usernameErforderlich (mindestens eines)Ein öffentlicher Bluesky-Handle mit 1 bis 253 Zeichen aus Buchstaben, Ziffern, Punkten oder Bindestrichen. Ein führendes @ wird nicht akzeptiert; lassen Sie dieses Feld weg, wenn stattdessen user_id angegeben wird.
user_idErforderlich (mindestens eines)Ein dezentraler Bluesky-Identifier, der mit did: beginnt, gefolgt von einer Methode in Kleinbuchstaben und einer nicht leeren Kennung aus unterstützten Buchstaben, Ziffern, Punkten, Unterstrichen, Doppelpunkten, Prozentzeichen oder Bindestrichen.

So verwenden Sie die Bluesky User Posts API

Senden Sie einen Bluesky-Handle oder eine DID, verfolgen Sie die asynchrone Aufgabe und lesen Sie nach dem Abschluss die gespeicherten Datensätze vom Typ PostItem.

  1. Wählen Sie entweder einen öffentlichen Bluesky-Handle ohne führendes @ oder die DID des Kontos.
  2. Senden Sie die gewählte Kennung per POST an /v1/bluesky/user-posts 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; verwenden Sie das next_cursor der Aufgabenantwort nur, wenn die gespeicherte Ergebnismenge eine weitere Seite hat.
curl -X POST "https://api.socq.ai/v1/bluesky/user-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"jay.bsky.team"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items after the task succeeds

Anwendungsfälle der Bluesky User Posts API

  • Momentaufnahmen von Kontoinhalten: Erfassen Sie für einen bekannten Handle oder eine DID eine Seite öffentlicher Beiträge zu einem bestimmten Zeitpunkt und behalten Sie Beitrags-IDs, Quell-URLs, Veröffentlichungszeiten und Erfassungszeiten bei.
  • Recherche zu Veröffentlichungsmustern: Werten Sie normalisierten Text, Urheberschaft, Hashtags, Erwähnungen und verfügbare Medien aus, um Themen und Formate eines ausgewählten öffentlichen Kontos zu untersuchen.
  • Vergleich sichtbarer Interaktionen: Vergleichen Sie die verfügbaren Likes, Kommentare, Shares und Aufrufe über die erfassten Beiträge hinweg und behandeln Sie fehlende Zähler als nicht verfügbar statt als null.

Profi-Tipps zur Bluesky User Posts API

  • Senden Sie Handles ohne @ und prüfen Sie sie vor dem Anlegen einer Aufgabe auf Buchstaben, Ziffern, Punkte und Bindestriche.
  • Verwenden Sie die vollständige DID, wenn die Kontoidentität auch bei Handle-Änderungen stabil bleiben muss; senden Sie keine beliebige Benutzer-ID.
  • Fügen Sie der POST-Nutzlast weder results_limit noch einen Quell-Cursor hinzu: Die Erfassung beim Anbieter umfasst eine Seite, und diese Felder werden abgelehnt.
  • Behandeln Sie Angaben zum Autor, Medien, Hashtags, Erwähnungen und einzelne Zähler als optional und deduplizieren Sie wiederholte Momentaufnahmen anhand der id des Beitrags.

Ergänzend zur Bluesky User Posts 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 Post API — Eine bekannte öffentliche bsky.app-Beitrags-URL in normalisierten Text, Autor, Medien, Zeitstempel, Tags, Erwähnungen und sichtbare Interaktionen auflösen.

Weitere Plattformen entdecken

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

Bluesky User Posts API — FAQ

Bluesky User Posts API ist eine Schnittstelle, die eine Seite öffentlicher Beiträge eines Kontos anhand von Bluesky-Handle oder DID abruft und normalisierten Beitragstext, Autor, Medien, Zeitstempel und sichtbare Interaktionsdaten liefert.

Senden Sie genau eines von beiden. username ist der öffentliche Handle ohne @, user_id muss eine gültige DID sein. Werden beide Felder angegeben, erhalten Sie einen Validierungsfehler.

Nein. Die Spezifikation der Übermittlung akzeptiert nur username und user_id, und die Ausführung beim Anbieter erfasst eine Quellseite, ohne einem Cursor des Anbieters zu folgen.

Der Aufgaben-Endpunkt paginiert die von SocQ bereits gespeicherten Datensätze und akzeptiert ein Leselimit von 1 bis 500. Dieser Cursor für gespeicherte Ergebnisse löst keine weitere Seite beim Bluesky-Anbieter aus.

Das Schema PostItem umfasst Identität, Plattform- und Ressourcenbezeichnungen, URL, Veröffentlichungs- und Erfassungszeit, Text, Autor, Kennzahlen, Medien, Hashtags und Erwähnungen. Von der Quelle abhängige Felder können null sein.

Eine erfolgreiche Aufgabe kostet pauschal 0,19 SocQ-Credits. Die Gebühr ändert sich nicht mit der Anzahl der aus der Quellseite gespeicherten Beiträge.