Snapchat Public Data API
Recupera uno Spotlight pubblico noto di Snapchat come record normalizzato con i campi disponibili su creator, didascalia, media, audio, data, durata ed engagement.
API di Snapchat disponibile
Usa Snapchat Spotlight quando hai già l’URL di un solo Spotlight pubblico su snapchat.com e ti servono i suoi dettagli disponibili in una forma di risultato standard.
Quali dati di Snapchat puoi recuperare?
SocQ trasforma un solo Spotlight pubblico noto in un record ReelVideoItem fisso, conservando solo i campi disponibili nella risposta della fonte.
Identità e origine dello Spotlight
Conserva ID dell’elemento, URL pubblico originale, tipo di risorsa, data di pubblicazione e momento della raccolta, quando disponibili.
Didascalia e contesto del creator
Restituisce il testo disponibile insieme a ID del creator, nome utente, nome visualizzato, URL del profilo, avatar e flag di verifica e privacy.
Video, audio e tassonomia
Mantiene nel record normalizzato i riferimenti ai media, la durata, i metadati dell’audio, lo shortcode, gli hashtag e le menzioni, quando disponibili.
Engagement visibile
Acquisisce i conteggi disponibili di Mi piace, commenti, condivisioni, riproduzioni e visualizzazioni come valori pubblici riferiti a un preciso momento.
SocQ vs strumenti di prodotto di Snapchat
SocQ si concentra sulla ricerca dei dettagli di uno Spotlight pubblico supportato, mentre le app di Snapchat e gli strumenti per creator e aziende servono flussi di lavoro autorizzati di pubblicazione, account, pubblico e pubblicità.
| Funzionalità | SocQ | Strumenti di prodotto di Snapchat |
|---|---|---|
| Uso principale | Recuperare i dettagli di un solo Spotlight pubblico noto | Creare, pubblicare, gestire, analizzare o promuovere contenuti autorizzati |
| Autenticazione | Chiave API di SocQ | Account Snapchat, app, token o autorizzazione specifica del prodotto |
| Input iniziale | Un solo URL pubblico di snapchat.com | Contesto di un account o di un prodotto autorizzato |
| Pubblicare o gestire contenuti | Non supportato | Disponibile nel prodotto Snapchat applicabile |
| Forma della risposta | Record ReelVideoItem normalizzato | Oggetti e interfacce di Snapchat specifici del prodotto |
Come funziona l’API di Snapchat
Snapchat Spotlight usa un’attività asincrona seguita dal recupero del risultato archiviato.
1. Invia un URL pubblico
Invia l’URL di un solo Spotlight di snapchat.com e salva il task_id restituito.
2. Segui l’attività
Interroga /v1/tasks/{task_id} finché l’elaborazione non riesce o non segnala un errore.
3. Leggi il risultato archiviato
Leggi data.results.items e usa next_cursor solo se il lettore di attività condiviso segnala altri record archiviati.
Autenticati con una chiave API di SocQ e invia l’URL di un solo Spotlight pubblico.
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.itemsCasi d’uso comuni dell’API di Snapchat
Ricerca su contenuti selezionati
Trasforma l’URL di uno Spotlight scelto in un record tracciabile per revisione e annotazione.
Arricchimento del catalogo
Aggiungi i campi disponibili su creator, didascalia, media, audio, durata, tassonomia e data a una raccolta di link esistente.
Istantanee dell’engagement
Confronta le metriche visibili tra raccolte separate, mantenendo collected_at come momento dell’osservazione.
Limiti e policy sui dati pubblici
I risultati di Snapchat Spotlight sono record pubblici riferiti a un preciso momento e non offrono operazioni autorizzate sugli account Snapchat.
- Il payload accetta esattamente un url obbligatorio e rifiuta campi aggiuntivi come results_limit o callback_url.
- La validazione accetta snapchat.com e i suoi sottodomini ma non verifica il percorso; usa un link pubblico a uno Spotlight, perché percorsi non pertinenti possono fallire presso il provider.
- Il provider esegue una sola ricerca di dettaglio e restituisce al massimo un elemento normalizzato, non un feed di Spotlight.
- La paginazione dei risultati archiviati appartiene al lettore di attività condiviso e non è la paginazione della fonte Snapchat.
- I campi facoltativi di didascalia, creator, media, pubblicazione, audio, durata, tassonomia e metriche possono essere null.
- L’endpoint non accede, non pubblica, non modifica, non elimina, non modera, non gestisce account e non gestisce campagne pubblicitarie.
Domande frequenti sull’API di Snapchat
Che cosa recupera l’API di Snapchat Spotlight?
Recupera un solo Spotlight pubblico noto e restituisce al massimo un record normalizzato con i campi della fonte disponibili al momento della raccolta.
L’API di Snapchat raccoglie un feed di Spotlight?
No. L’endpoint attuale è una ricerca di dettaglio singola e non accetta un profilo, un termine di ricerca, un cursore o results_limit per la scoperta dalla fonte.
I conteggi di engagement restituiti sono in tempo reale?
No. Considera i conteggi disponibili come un’istantanea pubblica acquisita in collected_at, non come analytics completi o aggiornati di continuo.
SocQ può pubblicare su Snapchat?
No. Questo endpoint di dati pubblici non offre accesso, pubblicazione, gestione degli account, moderazione né operazioni pubblicitarie.
Quanto costa Snapchat Spotlight?
Ogni attività completata con successo costa 0,19 crediti SocQ fissi, indipendentemente dalla disponibilità dei campi restituiti o dal numero di risultati.
Combina i dati di più piattaforme per analisi di business più complete
Riunisci in un unico flusso i dati pubblici di profili, contenuti ed engagement di piattaforme diverse per monitorare brand, creator e argomenti e condurre monitoraggi e analisi cross-platform in modo più efficiente.
Twitch API
Risolvi un nome utente Twitch pubblico noto in un profilo normalizzato, raccogli il suo inventario di video pubblici o recupera una clip con il suo video scaricabile per ricerca sui creator, arricchimento del catalogo, confronto e monitoraggio con istantanee.
Rednote API
Recupera profili e note pubblici, cerca note o utenti, raccogli commenti e risposte annidate e acquisisci una pagina di consigli della home.
Kwai API
Recupera profili Kwai pubblici, una pagina di post di un account o un post noto, con identità, contenuti, media, timestamp ed engagement visibile normalizzati.
Truth Social API
Recupera i dettagli pubblici di un account, raccogli una pagina della fonte con i post di un account o risolvi l’URL di un post noto in record normalizzati.
Google Ad Library API
Trova gli inserzionisti pubblici, raccogli le creatività di un’azienda o recupera per URL una creatività nota del Transparency Center, per ricerca e verifica.
Google Maps API
Trova i luoghi pubblici, recupera dettagli normalizzati da URL noti di Maps e raccogli le recensioni pubbliche con il contesto di luogo e autore collegato alla fonte.


