snapchat/
spotlight

Ein öffentliches Snapchat Spotlight über eine bekannte snapchat.com-URL abrufen – mit normalisierten Angaben zu Creator, Bildunterschrift, Medien, Audio, Zeitstempel, Dauer und sichtbarer Interaktion, soweit verfügbar.

Snapchat Spotlight API

Einzelne Spotlight-URL
Creator-Kontext
Video-Momentaufnahme
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

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

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

  1. Kopieren Sie eine öffentliche Snapchat-Spotlight-URL auf snapchat.com oder einer seiner Subdomains.
  2. Senden Sie die URL als url an /v1/snapchat/spotlight und speichern Sie die zurückgegebene task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich ist oder einen Fehler meldet.
  4. 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 only

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

Ergänzend zur Snapchat Spotlight 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 Spotlight API — FAQ

Snapchat Spotlight API ist eine Schnittstelle, die ein öffentliches Spotlight zu einer bekannten Snapchat-URL als normalisierten Videodatensatz abruft.

Senden Sie eine nicht leere http- oder https-URL, deren Host snapchat.com oder eine Subdomain wie www.snapchat.com ist; die Laufzeit erzwingt keinen bestimmten Pfad, der Anbieter erwartet aber einen öffentlichen Spotlight-Link.

Nein. Die Eingabe akzeptiert nur url und führt eine einzige Detailabfrage aus; sie entdeckt daher keinen Feed und akzeptiert kein results_limit.

Der gemeinsame Reader für Aufgaben stellt limit, next_cursor und has_more für gespeicherte Datensätze bereit; diese Felder machen die zugrunde liegende Spotlight-Abfrage nicht zu einer Anfrage mit Paginierung bei der Quelle.

Nein. Er ruft unterstützte öffentliche Daten ab und meldet sich weder an noch veröffentlicht, bearbeitet, löscht oder moderiert er Inhalte, verwaltet Konten oder betreibt Snapchat-Werbung.

Jede erfolgreiche Aufgabe kostet pauschal 0,19 SocQ-Credits, unabhängig davon, welche Felder verfügbar sind und wie viele Ergebnisse es gibt.