Snapchat Spotlight
Ein öffentlicher Snapchat-Spotlight-Datensatz kann einen Quelllink, eine Bildunterschrift, die Identität des Creators, Medienverweise, Veröffentlichungszeitpunkt, Dauer, Audiodetails und sichtbare Interaktionszahlen enthalten. Das normalisierte Ergebnis hält diese verfügbaren Felder mit einem Erfassungszeitstempel zusammen, für die Prüfung ausgewählter Videos, die Anreicherung von Katalogen und den Vergleich als Momentaufnahme.
Funktionen der Snapchat Spotlight API
- Auflösung eines bekannten SpotlightsSenden Sie eine öffentliche snapchat.com-URL und lösen Sie die passende Detailantwort zu höchstens einem Standarddatensatz auf, ohne einen Feed zu erweitern.
- Creator- und VideokontextBehält die Quell-URL und die verfügbaren Angaben zu Bildunterschrift, Autor, Medien, Dauer, Audio, Hashtags, Erwähnungen und Veröffentlichungszeitpunkt in einer festen Ergebnisstruktur bei.
- Momentaufnahme der sichtbaren InteraktionLiefert die verfügbaren Zahlen zu Likes, Kommentaren, Shares, Wiedergaben und Aufrufen zusammen mit collected_at, sodass die weitere Analyse den Beobachtungszeitpunkt behält.
Parameter der Snapchat Spotlight API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
url | Erforderlich | Erforderliche, nicht leere http- oder https-URL, deren Host snapchat.com oder eine seiner Subdomains ist. Die Laufzeit erzwingt keine Regel für den Pfad; verwenden Sie einen öffentlichen Spotlight-Link wie /@username/spotlight/{spotlight_id}. |
So verwenden Sie die Snapchat Spotlight API
Senden Sie eine öffentliche Snapchat-Spotlight-URL, verfolgen Sie die asynchrone Aufgabe und lesen Sie ihr gespeichertes normalisiertes Ergebnis.
- Kopieren Sie eine öffentliche Snapchat-Spotlight-URL auf snapchat.com oder einer seiner Subdomains.
- Senden Sie die URL als url an /v1/snapchat/spotlight und speichern Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich ist oder einen Fehler meldet.
- Lesen Sie data.results.items; liefert die Antwort mit den gespeicherten Ergebnissen has_more zurück, fahren Sie mit deren next_cursor fort.
curl -X POST "https://api.socq.ai/v1/snapchat/spotlight" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.snapchat.com/@queenhaley_13/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYY2pnZnF0bG52AZslQsUdAZslQoRQAAAAAQ"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items; next_cursor paginates stored results onlyAnwendungsfälle der Snapchat Spotlight API
- Ein ausgewähltes Spotlight prüfen: Machen Sie aus einem bekannten öffentlichen Link einen nachvollziehbaren Datensatz mit Quelle, Bildunterschrift, Autor, Medien, Zeit und den verfügbaren Interaktionsfeldern.
- Einen Inhaltskatalog anreichern: Ergänzen Sie eine bestehende URL-Liste um normalisierte Videoidentität, Creator-Kontext, Dauer, Audio, Hashtags, Erwähnungen und Erfassungszeitpunkt.
- Erfasste Interaktion vergleichen: Stellen Sie sichtbare Zahlen mit collected_at zusammen, wenn Sie getrennte Beobachtungen vergleichen, ohne die Werte als live oder vollständig zu behandeln.
Profi-Tipps zur Snapchat Spotlight API
- Senden Sie in url genau eine URL; Arrays, results_limit, usernames und callback_url werden von diesem Endpunkt nicht akzeptiert.
- Verwenden Sie einen öffentlichen Spotlight-Link, auch wenn die Validierung den Snapchat-Host prüft und keinen Pfad erzwingt; nicht zugehörige Snapchat-Pfade können beim Anbieter fehlschlagen.
- Behandeln Sie next_cursor des Aufgabenergebnisses nicht als Paginierung des Quell-Feeds, denn die Abfrage beim Anbieter ist eine einzelne Detailanfrage mit höchstens einem Datensatz.
- Rechnen Sie damit, dass IDs, Bildunterschriften, Autorenfelder, Medien, Zeitstempel, Audio und einzelne Kennzahlen null sein können, wenn die öffentliche Antwort sie auslässt.
- Speichern Sie collected_at neben den Interaktionszahlen, damit jede Messung an ihren Erfassungszeitpunkt gebunden bleibt.
- Planen Sie für jede erfolgreiche Aufgabe 0,19 Credits ein; die Pauschale ändert sich nicht mit den zurückgegebenen Feldern oder der Anzahl der Ergebnisse.
Verwandte APIs
Ergänzend zur Snapchat Spotlight API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Snapchat-Daten benötigen.