snapchat/
spotlight-comments

Eine Quellseite mit öffentlichen Kommentaren zu einer Snapchat-Spotlight-URL sammeln – mit normalisiertem Text, Autor, Verweisen auf den Thread, Zeitstempel und sichtbaren Interaktionsfeldern.

Snapchat Spotlight Comments API

Eingabe: Spotlight-URL
Eine Quellseite
Normalisierte Kommentare
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 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

ParameterErforderlichBeschreibung
urlErforderlichErforderliche, 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.

  1. Kopieren Sie die kanonische öffentliche Snapchat-Spotlight-URL, die Sie untersuchen möchten.
  2. Senden Sie url per POST an /v1/snapchat/spotlight-comments und speichern Sie die zurückgegebene task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich ist oder einen Fehler zurückgibt.
  4. 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 true

Anwendungsfä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.

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.

Weitere Plattformen entdecken

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

Snapchat Spotlight Comments API — FAQ

Snapchat Spotlight Comments API ist eine Schnittstelle, die eine Quellseite mit öffentlichen Kommentardatensätzen zu einer bestimmten Snapchat-Spotlight-URL sammelt.

Die Spezifikation der Anfrage akzeptiert genau eine erforderliche Zeichenfolge url. Die Validierung zur Laufzeit verlangt einen Host snapchat.com oder eine Subdomain; verwenden Sie für die gewünschte Ressource die kanonische öffentliche Form /@username/spotlight/{spotlight_id}.

Nein. Die Spezifikation der Anfrage hat weder ein Feld results_limit noch ein Feld cursor, und die Integration beim Anbieter stellt eine einzige Quellanfrage.

Dieser Cursor gehört zu GET /v1/tasks/{task_id}. Er paginiert Kommentardatensätze, die für eine erfolgreiche Aufgabe bereits gespeichert sind, mit einem Standardlimit von 50 pro Antwort und einem akzeptierten Bereich von 1 bis 500; er ruft keine weitere Quellseite von Snapchat ab.

CommentItem 1.0 umfasst id, platform, resource, type, url, published_at, collected_at, text, author, parent_id, post_id und metrics mit likes_count und replies_count. Nullable-Felder bleiben null, wenn sie nicht verfügbar sind.

Eine erfolgreiche Aufgabe von Snapchat Spotlight Comments kostet pauschal 0,19 SocQ-Credits, unabhängig von der Anzahl der Kommentare, die diese eine Quellseite zurückgibt.