snapchat/
profile

Ein öffentliches Snapchat-Profil über den Benutzernamen abfragen – mit normalisierter Identität, Biografie, Profilmedien, Website, Kontomerkmalen, Standort und den verfügbaren Profilzahlen.

Snapchat Profile API

Abfrage per Benutzername
Öffentliches Profil
Normalisiertes Konto
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

Snapchat Profile

Ein öffentliches Snapchat-Profil kann Benutzernamen, Anzeigenamen, Biografie, Avatar, Titelbild, Website, Kontomerkmale, Standort und sichtbare Profilzahlen offenlegen. Diese gezielte Abfrage macht aus einem bekannten Benutzernamen eine normalisierte Konto-Momentaufnahme für Anreicherung, Prüfung oder späteren Vergleich.

Funktionen der Snapchat Profile API

  • Exakte Abfrage per BenutzernameLöst pro Aufgabe einen bekannten Snapchat-Benutzernamen auf, mit oder ohne ein einzelnes führendes @, statt nach Konten zu suchen.
  • Normalisierte ProfilidentitätLiefert den verfügbaren Benutzernamen, Anzeigenamen, die Biografie, die öffentliche URL und die stabile Quellkennung in einem AccountItem-Datensatz.
  • Profilmedien und KontextHält die verfügbaren Felder für Avatar, Titelbild, Website und Standort getrennt, für Anzeige, Indexierung und Workflows zur Anreicherung.
  • Sichtbare KontosignaleErfasst die verfügbaren Merkmale für Verifizierung und Datenschutz sowie die Zahlen zu Followern, Gefolgten und Beiträgen zum Zeitpunkt der Erfassung.

Parameter der Snapchat Profile API

ParameterErforderlichBeschreibung
usernameErforderlichErforderlicher Snapchat-Benutzername. Geben Sie ein optionales führendes @ gefolgt von 1–64 ASCII-Buchstaben, Ziffern, Punkten, Unterstrichen oder Bindestrichen an; Leerzeichen, Profil-URLs und andere Zeichen werden abgelehnt.

So verwenden Sie die Snapchat Profile API

Senden Sie einen akzeptierten Benutzernamen, warten Sie auf die asynchrone Aufgabe und lesen Sie anschließend ihr normalisiertes Profilergebnis.

  1. Wählen Sie einen bekannten Snapchat-Benutzernamen aus Buchstaben, Ziffern, Punkten, Unterstrichen oder Bindestrichen; ein führendes @ ist optional.
  2. Senden Sie username an /v1/snapchat/profile und behalten Sie die zurückgegebene task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe den Status succeeded oder failed erreicht.
  4. Lesen Sie nach einem Erfolg data.results.items; diese Detailabfrage liefert normalerweise ein Profil oder eine leere Liste.
curl -X POST "https://api.socq.ai/v1/snapchat/profile" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"zane"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items after the task succeeds

Anwendungsfälle der Snapchat Profile API

  • Anreicherung bekannter Konten: Ergänzen Sie einen Datensatz, der bereits einen Snapchat-Benutzernamen enthält, um öffentliche Identität, Biografie, Profilmedien, Website und die verfügbaren Zahlen.
  • Prüfung ausgewählter Profile: Zeigen Sie ein öffentliches Konto in einer einheitlichen Profilkarte oder Prüfwarteschlange an, ohne Stories, Spotlights oder Aktionen der Kontoverwaltung zu vermischen.
  • Vergleich öffentlicher Momentaufnahmen: Speichern Sie collected_at zusammen mit aufeinanderfolgenden Ergebnissen, um öffentliche Profiltexte, Kontomerkmale, Medien oder sichtbare Zahlen im Zeitverlauf zu vergleichen.

Profi-Tipps zur Snapchat Profile API

  • Verwenden Sie in Ihren eigenen Datensätzen dieselbe kanonische Form des Benutzernamens, auch wenn die Anfrage ein führendes @ akzeptiert.
  • Senden Sie pro Aufgabe genau einen Benutzernamen; Batches, Profil-URLs und results_limit gehören nicht zur Spezifikation dieses Endpunkts.
  • Betrachten Sie akzeptierte Syntax als Eingabevalidierung und nicht als Beweis, dass der Benutzername zu einem zugänglichen öffentlichen Profil führt.
  • Behandeln Sie Website, Standort, Profilmedien, Kontomerkmale und einzelne Kennzahlen als optionale Felder.
  • Speichern Sie collected_at bei jedem Ergebnis, denn Profiltexte und sichtbare Zahlen sind Momentaufnahmen.

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

Weitere Plattformen entdecken

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

Snapchat Profile API — FAQ

Snapchat Profile API ist eine Schnittstelle, die ein öffentliches Snapchat-Profil über den Benutzernamen abfragt und die verfügbaren Felder als normalisierten Kontodatensatz zurückgibt.

Verwenden Sie ein optionales einzelnes @, gefolgt von 1–64 ASCII-Buchstaben, Ziffern, Punkten, Unterstrichen oder Bindestrichen. Leerzeichen, Profil-URLs und andere Satzzeichen bestehen die Validierung der Anfrage nicht.

Das AccountItem-Schema umfasst Identität, öffentliche URL, Biografietext, Avatar, Titelbild, Website, Merkmale für Verifizierung und Datenschutz, Standort, Erfassungszeitpunkt sowie die verfügbaren Zahlen zu Followern, Gefolgten und Beiträgen.

Ja. Eine gültige Syntax des Benutzernamens garantiert kein öffentlich zugängliches Ergebnis des Anbieters, daher kann eine erfolgreiche Aufgabe null Elemente speichern.

Nein. Der Anbieter führt eine einzige Anfrage nach Profildetails aus und liefert höchstens einen Profildatensatz. Die gemeinsame Route für Aufgabenergebnisse arbeitet mit Cursor-Paginierung, dieser Endpunkt hat jedoch kein results_limit und passt normalerweise auf die erste Seite.

Eine erfolgreiche Aufgabe kostet pauschal 0,19 SocQ-Credits, unabhängig davon, ob die Anzahl gespeicherter Ergebnisse eins oder null beträgt. Fehlgeschlagene Aufgaben folgen der Rückerstattungsregel der Plattform für Aufgaben.