Zurück zu den APIs
Öffentliche Bluesky-Daten

Bluesky Public Data API

Rufen Sie öffentliche Bluesky-Profile ab, lösen Sie URLs bekannter Beiträge auf oder erfassen Sie eine Seite mit Kontobeiträgen – mit normalisierter Identität, Inhalt, Medien, Zeitstempeln und sichtbaren Interaktionsfeldern.

Verfügbare Bluesky-APIs

Verwenden Sie Profiles für Kontodaten, Posts für einen bekannten öffentlichen Beitrag oder User Posts für eine Seite mit Beiträgen eines Handles oder einer DID.

Welche Bluesky-Daten können Sie abrufen?

SocQ liefert normalisierte öffentliche Profil- und Beitragsdatensätze mit Quell- und Erfassungskontext.

Öffentliche Profildetails

Ruft verfügbare Kontoidentität, Biografie, Profilbilder, Website, Kontomerkmale, sichtbare Zahlen und Erfassungszeit ab.

Inhalt bekannter Beiträge

Löst eine öffentliche bsky.app-URL in Beitragsidentität, Text, Autorenangaben, Medien, Zeitstempel, Hashtags und Erwähnungen auf.

Beiträge ausgewählter Konten

Erfasst eine Quellseite mit öffentlichen Beiträgen anhand eines Handles ohne @ oder einer gültigen Bluesky-DID.

Sichtbare Interaktion

Behält verfügbare Zahlen zu Likes, Kommentaren, Reposts, Shares und Aufrufen als Beobachtungen zu einem bestimmten Zeitpunkt bei.

SocQ vs direkte Bluesky-Integration

SocQ bietet einen asynchronen, normalisierten Erfassungs-Workflow; bei einer direkten Integration bleiben Transport, Quellobjekte, Speicherung und Ergebnisprojektion Ihrer Anwendung überlassen.

FunktionSocQDirekte Integration
HauptzweckErfassung öffentlicher Profile, bekannter Beiträge und einer Seite mit KontobeiträgenAufbau nativer Lese- oder Schreib-Workflows des Anbieters
AuthentifizierungSocQ-API-SchlüsselZugangsdaten hängen von der nativen Methode und dem Dienst ab
AusgangseingabeBenutzername, öffentliche Beitrags-URL, Handle oder DID je nach EndpunktNative Kennungen oder methodenspezifische Parameter
AntwortformatNormalisierte SocQ-DatensätzeNative Objekte des Anbieters, die Ihre Anwendung abbilden muss

So funktioniert die Bluesky-API

Profiles, Posts und User Posts nutzen denselben asynchronen Aufgaben-Workflow mit paginierten gespeicherten Ergebnissen.

  1. 1. Unterstützte Kennung senden

    Senden Sie einen Benutzernamen, eine Beitrags-URL, ein Handle oder eine DID an die passende API und speichern Sie die zurückgegebene task_id.

  2. 2. Aufgabe verfolgen

    Fragen Sie /v1/tasks/{task_id} ab, bis die Verarbeitung erfolgreich ist oder fehlschlägt.

  3. 3. Ergebnisse abrufen

    Lesen Sie data.results.items und nutzen Sie next_cursor nur, solange weitere gespeicherte Ergebnisse vorhanden sind.

Beiträge per Bluesky-Handle erfassen

Authentifizieren Sie sich mit Ihrem SocQ-API-Schlüssel und senden Sie ein öffentliches Handle an User Posts. Profiles und Posts nutzen denselben Aufgabenablauf.

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 success

Typische Anwendungsfälle der Bluesky-API

Profilrecherche

Reichern Sie bekannte Benutzernamen mit öffentlicher Identität, Biografie, Bildern, Website, sichtbaren Kennzahlen und Erfassungszeit an.

Analyse bekannter Beiträge

Lösen Sie ausgewählte Beitrags-URLs in normalisierte Felder zu Inhalt, Autor, Medien, Zeitstempel, Referenz, Interaktion und Quelle auf.

Öffentliche Konto-Momentaufnahmen

Erfassen Sie eine Seite mit Beiträgen zu einem bekannten Handle oder einer DID und behalten Sie Quell- und Erfassungszeitstempel.

Vergleich der Interaktion

Vergleichen Sie sichtbare Zähler über wiederholte Erfassungen hinweg und behandeln Sie sie als Momentaufnahmen zu einem bestimmten Zeitpunkt.

Grenzen und Richtlinie für öffentliche Daten

Bluesky-Ergebnisse stellen öffentliche Felder dar, die während der Erfassung verfügbar waren. Diese APIs greifen nicht auf private Inhalte zu und veröffentlichen, bearbeiten oder löschen keine Konten und Beiträge und verwalten sie nicht.

  • Profiles erfordert einen validierten Benutzernamen und akzeptiert keine Profil-URLs.
  • Posts akzeptiert eine nicht leere Referenz, deren geparster Hostname bsky.app oder eine Subdomain von bsky.app ist, einschließlich absoluter Referenzen mit beliebigem Schema und protokollrelativer Referenzen; es erfasst weder einen Konto-Feed noch einen Antwortbaum.
  • User Posts erfordert username oder user_id; das Handle darf kein @ enthalten, und user_id muss eine DID sein.
  • User Posts akzeptiert weder results_limit noch einen Quell-Cursor und erfasst nur eine Seite des Anbieters.
  • Cursor und Limit der Aufgabenergebnisse paginieren Datensätze, die SocQ bereits gespeichert hat; sie erfassen keine weitere Quellseite.
  • Optionale Felder zu Identität, Inhalt, Medien, Zeitstempel, Referenz und Interaktion können leer sein, wenn sie nicht verfügbar sind.

Häufige Fragen zur Bluesky-API

Was ist die Bluesky-API?

Die Bluesky-APIs rufen öffentliche Profile ab, lösen bekannte Beiträge auf und erfassen eine Seite öffentlicher Kontobeiträge per Handle oder DID.

Welche Bluesky-API sollte ich verwenden?

Verwenden Sie Profiles für einen Kontodatensatz anhand des Benutzernamens, Posts für eine bekannte bsky.app-Beitrags-URL und User Posts für eine Seite mit Beiträgen eines Handles oder einer DID.

Folgt User Posts einem Quell-Cursor?

Nein. Es sendet eine einzelne Anfrage an den Anbieter und erfasst eine Quellseite; next_cursor schaltet nur durch Ergebnisdatensätze weiter, die SocQ bereits gespeichert hat.

Sind alle Felder und Kennzahlen immer vorhanden?

Nein. Die normalisierte Form ist stabil, aber quellabhängige Werte zu Identität, Inhalt, Medien, Zeitstempel, Referenz und Kennzahlen können null sein.

Wie wird die Bluesky-Erfassung abgerechnet?

Jede erfolgreiche Aufgabe für Profiles, Posts oder User Posts kostet pauschal 0,19 SocQ-Credits.

Führen Sie öffentliche Profile, Inhalte und Interaktionsdaten verschiedener Plattformen in einem Workflow zusammen, um Marken, Creator und Themen zu verfolgen und plattformübergreifend effizienter zu überwachen und zu analysieren.