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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
username | Erforderlich (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_id | Erforderlich (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.
- Wählen Sie entweder einen öffentlichen Bluesky-Handle ohne führendes @ oder die DID des Kontos.
- Senden Sie die gewählte Kennung per POST an /v1/bluesky/user-posts 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; 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 succeedsAnwendungsfä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.
Verwandte APIs
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.