Snapchat Spotlight Comments
Kommentare zu Snapchat Spotlight sind öffentliche Reaktionen, die einem bestimmten Spotlight-Eintrag zugeordnet sind. SocQ speichert jede zurückgegebene Reaktion als CommentItem mit Quellidentität, Kommentartext, verfügbarem Autorenkontext, Verweisen auf den übergeordneten Kommentar und den Beitrag, Veröffentlichungs- und Erfassungszeitpunkt sowie sichtbaren Like- oder Antwortzahlen.
Funktionen der Snapchat Spotlight Comments API
- Eine Spotlight-URL pro AufgabeSenden Sie eine nicht leere url auf snapchat.com oder einer Snapchat-Subdomain; der Anbieter fordert für dieses Ziel eine Quellseite an.
- Normalisierte KommentardatensätzeLesen Sie Kommentar-IDs, Text, Quell-URLs, Zeitstempel und die verfügbare Identität des Autors in der stabilen Ergebnisstruktur CommentItem 1.0.
- Thread- und InteraktionskontextBehält parent_id, post_id, likes_count und replies_count bei, wenn die Quelle sie bereitstellt, ohne fehlende Felder als 0 oder als vollständige Abdeckung des Threads zu werten.
Parameter der Snapchat Spotlight Comments API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
url | Erforderlich | Erforderliche, nicht leere Snapchat-URL. Die Validierung zur Laufzeit akzeptiert snapchat.com und seine Subdomains; verwenden Sie eine kanonische öffentliche URL der Form /@username/spotlight/{spotlight_id}, damit der Anbieter die gewünschte Spotlight-Ressource erhält. |
So verwenden Sie die Snapchat Spotlight Comments API
Senden Sie eine öffentliche Snapchat-Spotlight-URL, verfolgen Sie die asynchrone Aufgabe und lesen Sie die gespeicherten normalisierten Kommentare mit der Paginierung der Aufgabenergebnisse.
- Kopieren Sie die kanonische öffentliche Snapchat-Spotlight-URL, die Sie untersuchen möchten.
- Senden Sie url per POST an /v1/snapchat/spotlight-comments und speichern Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich ist oder einen Fehler zurückgibt.
- Lesen Sie data.results.items; erstreckt sich das gespeicherte Aufgabenergebnis über mehrere Antwortseiten der API, fahren Sie mit next_cursor fort, solange has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/snapchat/spotlight-comments" \
-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 and follow next_cursor while has_more is trueAnwendungsfälle der Snapchat Spotlight Comments API
- Qualitative Auswertung der Reaktionen: Werten Sie den zurückgegebenen Text öffentlicher Kommentare und den verfügbaren Autorenkontext aus, um Fragen, Reaktionen und wiederkehrende Themen zu einem ausgewählten Spotlight zu erkennen.
- Kommentararchive mit Quellenbezug: Bewahren Sie Kommentar-IDs, Quell-URLs, post_id, parent_id, published_at und collected_at auf, damit jede gespeicherte Reaktion ihre verfügbare Herkunft behält.
- Momentaufnahmen der sichtbaren Interaktion: Vergleichen Sie die verfügbaren Werte likes_count und replies_count über die zurückgegebenen Kommentare hinweg und binden Sie jede Beobachtung mit collected_at an ihren Erfassungszeitpunkt.
Profi-Tipps zur Snapchat Spotlight Comments API
- Verwenden Sie die kanonische öffentliche URL /@username/spotlight/{spotlight_id}, auch wenn die Validierung zur Laufzeit den Snapchat-Host prüft und diesen genauen Pfad nicht erzwingt.
- Senden Sie in den Nutzdaten weder cursor noch results_limit; dieser Endpunkt kennt nur url und sammelt eine Seite beim Anbieter.
- Behandeln Sie parent_id und replies_count als verfügbaren Kontext und nicht als Beweis, dass die zurückgegebenen Datensätze einen vollständigen Antwortbaum enthalten.
- Rechnen Sie damit, dass IDs, URLs, Text, Autorenfelder, published_at, parent_id, post_id und Kennzahlen null sein können, wenn die Quelle sie nicht liefert.
- Halten Sie die Erfassungstiefe beim Anbieter getrennt von der Paginierung bei GET /v1/tasks/{task_id}, deren Cursor nur durch Ergebnisse blättert, die die abgeschlossene Aufgabe bereits gespeichert hat.
Verwandte APIs
Ergänzend zur Snapchat Spotlight Comments API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Snapchat-Daten benötigen.
- Snapchat Profile API
- 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.