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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
username | Erforderlich | Erforderlicher 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.
- Wählen Sie einen bekannten Snapchat-Benutzernamen aus Buchstaben, Ziffern, Punkten, Unterstrichen oder Bindestrichen; ein führendes @ ist optional.
- Senden Sie username an /v1/snapchat/profile und behalten Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe den Status succeeded oder failed erreicht.
- 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 succeedsAnwendungsfä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.
Verwandte APIs
Ergänzend zur Snapchat Profile API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Snapchat-Daten benötigen.
- Snapchat Spotlight API — Ein bekanntes öffentliches Snapchat-Spotlight abrufen – mit normalisierten Feldern zu Creator, Bildunterschrift, Medien, Audio, Zeitstempel, Dauer und, sofern verfügbar, sichtbaren Interaktionen.
- Snapchat Spotlight Comments API