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.
| Funktion | SocQ | Snapchat-Produktwerkzeuge |
|---|---|---|
| Hauptzweck | Details eines bekannten öffentlichen Spotlights abrufen | Autorisierte Inhalte erstellen, veröffentlichen, verwalten, analysieren oder bewerben |
| Authentifizierung | SocQ-API-Schlüssel | Snapchat-Konto, App, Token oder produktspezifische Autorisierung |
| Ausgangseingabe | Eine öffentliche snapchat.com-URL | Autorisierter Konto- oder Produktkontext |
| Inhalte veröffentlichen oder verwalten | Nicht unterstützt | Im jeweiligen Snapchat-Produkt verfügbar |
| Antwortform | Normalisierter ReelVideoItem-Datensatz | Produktspezifische Snapchat-Objekte und Schnittstellen |
So funktioniert die Snapchat API
Snapchat Spotlight nutzt eine asynchrone Aufgabe, gefolgt vom Abruf des gespeicherten Ergebnisses.
1. Öffentliche URL senden
Senden Sie eine snapchat.com-Spotlight-URL und speichern Sie die zurückgegebene task_id.
2. Aufgabe verfolgen
Fragen Sie /v1/tasks/{task_id} ab, bis die Verarbeitung erfolgreich ist oder einen Fehler meldet.
3. Gespeichertes Ergebnis lesen
Lesen Sie data.results.items und verwenden Sie next_cursor nur, wenn der gemeinsame Aufgabenleser weitere gespeicherte Datensätze meldet.
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.itemsTypische 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.
Daten verschiedener Plattformen kombinieren und umfassendere Geschäftseinblicke gewinnen
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.
Twitch API
Wandeln Sie einen bekannten öffentlichen Twitch-Benutzernamen in ein normalisiertes Profil um, erfassen Sie dessen öffentlichen Videobestand oder laden Sie einen einzelnen Clip samt herunterladbarem Video für Creator-Recherche, Kataloganreicherung, Vergleiche und die Beobachtung per Momentaufnahme.
Rednote API
Rufen Sie öffentliche Profile und Notes ab, suchen Sie nach Notes oder Nutzern, erfassen Sie Kommentare und verschachtelte Antworten und holen Sie eine Seite mit Empfehlungen der Startseite.
Kwai API
Rufen Sie öffentliche Kwai-Profile, eine Seite mit Kontobeiträgen oder einen bekannten Beitrag ab – mit normalisierten Angaben zu Identität, Inhalt, Medien, Zeitstempeln und sichtbarem Engagement.
Truth Social API
Rufen Sie öffentliche Kontodetails ab, erfassen Sie eine Quellseite mit Kontobeiträgen oder wandeln Sie die URL eines bekannten Beitrags in normalisierte Datensätze um.
Google Ad Library API
Finden Sie öffentliche Werbetreibende, erfassen Sie die Creatives eines Unternehmens oder rufen Sie ein bekanntes Creative aus dem Transparency Center per URL ab – für Recherche und Prüfung.
Google Maps API
Finden Sie öffentliche Orte, rufen Sie normalisierte Details zu bekannten Maps-URLs ab und erfassen Sie öffentliche Bewertungen mit quellenverknüpftem Orts- und Autorenkontext.


