bluesky/
profile

Ein öffentliches Bluesky-Profil anhand eines validierten Benutzernamens abrufen – mit normalisierter Identität, Biografie, Profilbildern, Website und sichtbaren Kontozahlen in einer asynchronen Aufgabe.

Bluesky Profile API

Eingabe eines validierten Benutzernamens
Profilidentität und Bilder
Sichtbare Kontozahlen
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 Profile

Bluesky-Profile sind öffentliche Kontodatensätze mit einer dauerhaften Kennung, Handle, Anzeigename, Biografie, Profilbildern, Website sowie den sichtbaren Zahlen zu Followern, Gefolgten und Beiträgen. Diese Identitätsfelder und Kontosignale unterstützen Profilanreicherung, den Vergleich öffentlicher Konten und die Beobachtung im Zeitverlauf.

Funktionen der Bluesky Profile API

  • Direkte Abfrage per BenutzernameLöst einen Benutzernamen aus 1 bis 253 Buchstaben, Ziffern, Punkten oder Bindestrichen in einen öffentlichen Profildatensatz auf.
  • Normalisierte ProfilidentitätLiefert die verfügbare Profil-ID, Quell-URL, Benutzernamen, Anzeigenamen, Biografie und verlinkte Website in einer einheitlichen Kontostruktur.
  • Profilbilder und StatusfelderBehält verfügbare Werte für Avatar, Titelbild, Verifizierung und Datenschutz als nullable Felder bei, ohne Werte zu erfinden, wenn die Quelle sie weglässt.
  • Momentaufnahme der sichtbaren KontozahlenFasst die verfügbaren Zahlen zu Followern, Gefolgten und Beiträgen mit collected_at zusammen, sodass jede öffentliche Kontoaufnahme eine Beobachtungszeit hat.

Parameter der Bluesky Profile API

ParameterErforderlichBeschreibung
usernameErforderlichErforderlicher öffentlicher Bluesky-Benutzername aus 1 bis 253 Buchstaben, Ziffern, Punkten oder Bindestrichen. Verwenden Sie weder ein führendes @ noch Unterstriche, eine DID, eine Profil-URL oder einen zweiten Benutzernamen.

So verwenden Sie die Bluesky Profile API

Senden Sie einen validierten Benutzernamen, verfolgen Sie die asynchrone Aufgabe und lesen Sie das normalisierte Profil aus der Standardantwort.

  1. Bereiten Sie einen Bluesky-Benutzernamen aus Buchstaben, Ziffern, Punkten oder Bindestrichen vor, zum Beispiel jay.bsky.team, und lassen Sie das führende @ weg.
  2. Senden Sie username an /v1/bluesky/profile 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. Diese Abfrage speichert normalerweise ein Profil, daher ist has_more false; meldet die allgemeine Ergebnisantwort weitere Daten, fahren Sie mit next_cursor fort.
curl -X POST "https://api.socq.ai/v1/bluesky/profile" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"jay.bsky.team"}'

# Poll GET /v1/tasks/{task_id}
# Read the profile from data.results.items

Anwendungsfälle der Bluesky Profile API

  • Anreicherung bekannter Profile: Ergänzen Sie einen Datensatz, der bereits einen Bluesky-Benutzernamen enthält, um öffentlichen Handle, Anzeigenamen, Biografie, Profilbilder, Website und Quell-URL.
  • Vergleich des Konto-Fußabdrucks: Vergleichen Sie die verfügbaren Zahlen zu Followern, Gefolgten und Beiträgen über getrennt übermittelte Benutzernamen hinweg anhand derselben normalisierten Kennzahlenschlüssel.
  • Beobachtung der Profildarstellung: Speichern Sie Identität, Biografie, Bilder, Website und collected_at über wiederholte Aufgaben hinweg, um Änderungen zwischen öffentlichen Momentaufnahmen zu erkennen.

Profi-Tipps zur Bluesky Profile API

  • Entfernen Sie ein führendes @ und prüfen Sie den verbleibenden Benutzernamen vor dem Senden auf Buchstaben, Ziffern, Punkte und Bindestriche; lehnen Sie DID-Werte ab, denn dieser Endpunkt akzeptiert kein user_id.
  • Verwenden Sie die zurückgegebene id als bevorzugten Schlüssel zur Deduplizierung und greifen Sie auf url oder username zurück, wenn id leer ist.
  • Lassen Sie bei Biografie, Avatar, Titelbild, Website, Statusmerkmalen, Standort und einzelnen Kennzahlen den Wert null zu, damit auch unvollständige öffentliche Datensätze nutzbar bleiben.
  • Fügen Sie weder results_limit noch ein Array username hinzu: Senden Sie jeden Benutzernamen als eigene Aufgabe zum Festpreis und behandeln Sie das normale Ergebnis als einzelnes Profil.

Ergänzend zur Bluesky Profile API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Bluesky-Daten benötigen.

  • Bluesky Post API — Eine bekannte öffentliche bsky.app-Beitrags-URL in normalisierten Text, Autor, Medien, Zeitstempel, Tags, Erwähnungen und sichtbare Interaktionen auflösen.
  • Bluesky User Posts API — Eine Seite öffentlicher Bluesky-Beiträge per Handle oder DID erfassen – mit normalisierten Inhalten, Autor, Medien, Zeitstempeln und sichtbaren Interaktionen.

Weitere Plattformen entdecken

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

Bluesky Profile API — FAQ

Bluesky Profile API ist eine Schnittstelle, die ein öffentliches Bluesky-Profil anhand eines validierten Benutzernamens abruft. Sie liefert normalisierte Identität, Biografie, Profilbilder, Website, optionale Statusfelder, sichtbare Kontozahlen und die Erfassungszeit.

Senden Sie 1 bis 253 Buchstaben, Ziffern, Punkte oder Bindestriche ohne führendes @. Unterstriche, Doppelpunkte, Profil-URLs, DIDs, leere Werte und zusätzliche Anfragefelder werden abgelehnt.

Der Standard-Kontodatensatz umfasst Identitäts- und Quellfelder, Benutzername, Anzeigename, Biografie, Avatar, Titelbild, Website, Werte zu Verifizierung und Datenschutz, optional den Standort, die Zahlen zu Followern, Gefolgten und Beiträgen sowie die Erfassungszeit. Optionale Felder bleiben null, wenn sie nicht verfügbar sind.

Nein. Jede Aufgabe akzeptiert einen Benutzernamen und liefert normalerweise höchstens ein Profil, ohne results_limit oder einen vom Aufrufer steuerbaren Eingabe-Cursor; die Aufgabenergebnisse nutzen dennoch die Standardhülle mit next_cursor und has_more.

Jede erfolgreiche Aufgabe kostet pauschal 0,19 SocQ-Credits. Die Gebühr hängt nicht von der Ergebnisanzahl ab, weil die Anfrage genau eine Profilabfrage ausführt.