Zurück zu den APIs
Öffentliche Snapchat-Daten

Snapchat Public Data API

Ein bekanntes öffentliches Snapchat-Spotlight als normalisierten Datensatz abrufen – mit verfügbaren Feldern zu Creator, Bildunterschrift, Medien, Audio, Zeitstempel, Dauer und Engagement.

Verfügbare Snapchat-API

Verwenden Sie Snapchat Spotlight, wenn Sie bereits eine öffentliche snapchat.com-Spotlight-URL haben und deren verfügbare Details in einer standardisierten Ergebnisform benötigen.

Welche Snapchat-Daten können Sie abrufen?

SocQ wandelt ein bekanntes öffentliches Spotlight in einen festen ReelVideoItem-Datensatz um und bewahrt nur die Felder, die in der Antwort der Quelle verfügbar sind.

Identität und Quelle des Spotlights

Behält die verfügbare Element-ID, die ursprüngliche öffentliche URL, den Ressourcentyp, die Veröffentlichungszeit und die Erfassungszeit bei.

Bildunterschrift und Creator-Kontext

Liefert verfügbaren Text sowie Creator-ID, Benutzername, Anzeigename, Profil-URL, Avatar, Verifizierung und Datenschutzmerkmale.

Video, Audio und Taxonomie

Behält verfügbare Medienverweise, Dauer, Audiometadaten, Shortcode, Hashtags und Erwähnungen im normalisierten Datensatz bei.

Sichtbares Engagement

Erfasst verfügbare Zahlen zu Likes, Kommentaren, Shares, Wiedergaben und Aufrufen als öffentliche Werte zu einem bestimmten Zeitpunkt.

SocQ vs Snapchat-Produktwerkzeuge

SocQ konzentriert sich auf die unterstützte Abfrage der Details öffentlicher Spotlights, während die Apps und Creator- oder Business-Werkzeuge von Snapchat autorisierte Abläufe für Veröffentlichung, Konto, Zielgruppe und Werbung abdecken.

FunktionSocQSnapchat-Produktwerkzeuge
HauptzweckDetails eines bekannten öffentlichen Spotlights abrufenAutorisierte Inhalte erstellen, veröffentlichen, verwalten, analysieren oder bewerben
AuthentifizierungSocQ-API-SchlüsselSnapchat-Konto, App, Token oder produktspezifische Autorisierung
AusgangseingabeEine öffentliche snapchat.com-URLAutorisierter Konto- oder Produktkontext
Inhalte veröffentlichen oder verwaltenNicht unterstütztIm jeweiligen Snapchat-Produkt verfügbar
AntwortformNormalisierter ReelVideoItem-DatensatzProduktspezifische Snapchat-Objekte und Schnittstellen

So funktioniert die Snapchat API

Snapchat Spotlight nutzt eine asynchrone Aufgabe, gefolgt vom Abruf des gespeicherten Ergebnisses.

  1. 1. Öffentliche URL senden

    Senden Sie eine snapchat.com-Spotlight-URL und speichern Sie die zurückgegebene task_id.

  2. 2. Aufgabe verfolgen

    Fragen Sie /v1/tasks/{task_id} ab, bis die Verarbeitung erfolgreich ist oder einen Fehler meldet.

  3. 3. Gespeichertes Ergebnis lesen

    Lesen Sie data.results.items und verwenden Sie next_cursor nur, wenn der gemeinsame Aufgabenleser weitere gespeicherte Datensätze meldet.

Ein Snapchat-Spotlight abrufen

Authentifizieren Sie sich mit einem SocQ-API-Schlüssel und senden Sie eine öffentliche Spotlight-URL.

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

Typische Anwendungsfälle der Snapchat API

Recherche zu ausgewählten Inhalten

Wandeln Sie eine kuratierte Spotlight-URL in einen nachvollziehbaren Datensatz für Prüfung und Annotation um.

Anreicherung von Katalogen

Ergänzen Sie eine bestehende Linksammlung um verfügbare Felder zu Creator, Bildunterschrift, Medien, Audio, Dauer, Taxonomie und Zeitstempeln.

Engagement-Momentaufnahmen

Vergleichen Sie sichtbare Kennzahlen aus getrennten Erfassungen und behalten Sie collected_at als Beobachtungszeitpunkt bei.

Grenzen und Richtlinie für öffentliche Daten

Ergebnisse zu Snapchat-Spotlights sind öffentliche Datensätze zu einem bestimmten Zeitpunkt und bieten keine autorisierten Snapchat-Kontoaktionen.

  • Die Payload akzeptiert genau eine erforderliche url und lehnt zusätzliche Felder wie results_limit oder callback_url ab.
  • Die Validierung akzeptiert snapchat.com und seine Subdomains, erzwingt aber keinen Pfadnamen; verwenden Sie einen öffentlichen Spotlight-Link, da unpassende Pfade beim Anbieter fehlschlagen können.
  • Der Anbieter führt eine einzelne Detailabfrage aus und liefert höchstens ein normalisiertes Element, keinen Spotlight-Feed.
  • Die Paginierung gespeicherter Ergebnisse gehört zum gemeinsamen Aufgabenleser und ist keine Paginierung der Snapchat-Quelle.
  • Optionale Felder zu Bildunterschrift, Creator, Medien, Veröffentlichung, Audio, Dauer, Taxonomie und Kennzahlen können null sein.
  • Der Endpunkt meldet sich nicht an und veröffentlicht, bearbeitet, löscht oder moderiert nichts, verwaltet keine Konten und betreibt keine Werbung.

Häufige Fragen zur Snapchat API

Was ruft die Snapchat Spotlight API ab?

Sie ruft ein bekanntes öffentliches Spotlight ab und liefert höchstens einen normalisierten Datensatz mit den Quellfeldern, die zum Zeitpunkt der Erfassung verfügbar sind.

Erfasst die Snapchat API einen Spotlight-Feed?

Nein. Der aktuelle Endpunkt ist eine Einzelabfrage von Details und akzeptiert weder ein Profil, einen Suchbegriff, einen Cursor noch results_limit für die Suche in der Quelle.

Sind die zurückgegebenen Engagement-Zahlen in Echtzeit?

Nein. Behandeln Sie verfügbare Zahlen als öffentliche Momentaufnahme zum Zeitpunkt collected_at, nicht als vollständige oder laufend aktualisierte Analysen.

Kann SocQ auf Snapchat veröffentlichen?

Nein. Dieser Endpunkt für öffentliche Daten bietet weder Anmeldung noch Veröffentlichung, Kontoverwaltung, Moderation oder Werbefunktionen.

Wie wird Snapchat Spotlight abgerechnet?

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

Führen Sie öffentliche Profile, Inhalte und Interaktionsdaten verschiedener Plattformen in einem Workflow zusammen, um Marken, Creator und Themen zu verfolgen und plattformübergreifend effizienter zu überwachen und zu analysieren.