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.
| Funktion | SocQ | Direkte Integration |
|---|---|---|
| Hauptzweck | Erfassung öffentlicher Profile, bekannter Beiträge und einer Seite mit Kontobeiträgen | Aufbau nativer Lese- oder Schreib-Workflows des Anbieters |
| Authentifizierung | SocQ-API-Schlüssel | Zugangsdaten hängen von der nativen Methode und dem Dienst ab |
| Ausgangseingabe | Benutzername, öffentliche Beitrags-URL, Handle oder DID je nach Endpunkt | Native Kennungen oder methodenspezifische Parameter |
| Antwortformat | Normalisierte SocQ-Datensätze | Native 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. 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. Aufgabe verfolgen
Fragen Sie /v1/tasks/{task_id} ab, bis die Verarbeitung erfolgreich ist oder fehlschlägt.
3. Ergebnisse abrufen
Lesen Sie data.results.items und nutzen Sie next_cursor nur, solange weitere gespeicherte Ergebnisse vorhanden sind.
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 successTypische 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.
Daten verschiedener Plattformen kombinieren und umfassendere Geschäftseinblicke gewinnen
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.
Snapchat API
Ein bekanntes öffentliches Snapchat-Spotlight als normalisierten Datensatz abrufen – mit verfügbaren Feldern zu Creator, Bildunterschrift, Medien, Audio, Zeitstempel, Dauer und Engagement.
Twitch API
Wandeln Sie einen bekannten öffentlichen Twitch-Benutzernamen in ein normalisiertes Profil um, erfassen Sie dessen öffentlichen Videobestand oder laden Sie einen einzelnen Clip samt herunterladbarem Video für Creator-Recherche, Kataloganreicherung, Vergleiche und die Beobachtung per Momentaufnahme.
Rednote API
Rufen Sie öffentliche Profile und Notes ab, suchen Sie nach Notes oder Nutzern, erfassen Sie Kommentare und verschachtelte Antworten und holen Sie eine Seite mit Empfehlungen der Startseite.
Kwai API
Rufen Sie öffentliche Kwai-Profile, eine Seite mit Kontobeiträgen oder einen bekannten Beitrag ab – mit normalisierten Angaben zu Identität, Inhalt, Medien, Zeitstempeln und sichtbarem Engagement.
Truth Social API
Rufen Sie öffentliche Kontodetails ab, erfassen Sie eine Quellseite mit Kontobeiträgen oder wandeln Sie die URL eines bekannten Beitrags in normalisierte Datensätze um.
Google Ad Library API
Finden Sie öffentliche Werbetreibende, erfassen Sie die Creatives eines Unternehmens oder rufen Sie ein bekanntes Creative aus dem Transparency Center per URL ab – für Recherche und Prüfung.


