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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
username | Erforderlich | Erforderlicher ö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.
- Bereiten Sie einen Bluesky-Benutzernamen aus Buchstaben, Ziffern, Punkten oder Bindestrichen vor, zum Beispiel jay.bsky.team, und lassen Sie das führende @ weg.
- Senden Sie username an /v1/bluesky/profile 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. 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.itemsAnwendungsfä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.
Verwandte APIs
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.