snapchat/
spotlight

Recupera un Snapchat Spotlight pubblico da un URL snapchat.com noto, con creator, didascalia, media, audio, timestamp, durata ed engagement visibile normalizzati, quando disponibili.

Snapchat Spotlight API

URL di un singolo Spotlight
Contesto del creator
Istantanea del video
0,19 crediti per richiesta
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

Snapchat Spotlight

Un record pubblico di Snapchat Spotlight può contenere link alla fonte, didascalia, identità del creator, riferimenti ai media, data di pubblicazione, durata, dettagli sull’audio e conteggi visibili di engagement. Il risultato normalizzato conserva questi campi disponibili con un timestamp di raccolta, per la revisione di video selezionati, l’arricchimento di cataloghi e il confronto puntuale.

Funzionalità della Snapchat Spotlight API

  • Risoluzione di uno Spotlight notoInvia un URL snapchat.com pubblico e risolvi la risposta di dettaglio corrispondente in al massimo un record standard, senza espandere un feed.
  • Contesto di creator e videoConserva in un’unica struttura di risultato fissa l’URL della fonte e, se disponibili, didascalia, identità dell’autore, media, durata, audio, hashtag, menzioni e data di pubblicazione.
  • Istantanea dell’engagement visibileRestituisce Mi piace, commenti, condivisioni, riproduzioni e visualizzazioni disponibili con collected_at, così le analisi a valle mantengono il momento dell’osservazione.

Parametri della Snapchat Spotlight API

ParametriObbligatorioDescrizione
urlObbligatorioURL http o https obbligatorio non vuoto il cui host sia snapchat.com o uno dei suoi sottodomini. Il runtime non impone alcuna regola sul pathname; usa un link pubblico a uno Spotlight, come /@username/spotlight/{spotlight_id}.

Come usare la Snapchat Spotlight API

Invia un URL pubblico di Snapchat Spotlight, segui l’attività asincrona e leggi il risultato normalizzato salvato.

  1. Copia un URL pubblico di Snapchat Spotlight su snapchat.com o su uno dei suoi sottodomini.
  2. Invia l’URL come url a /v1/snapchat/spotlight e salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività non ha successo o segnala un errore.
  4. Leggi data.results.items; se la risposta dei risultati salvati restituisce has_more, continua con il relativo next_cursor.
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

Casi d’uso della Snapchat Spotlight API

  • Rivedere uno Spotlight selezionato: Trasforma un link pubblico noto in un record tracciabile con fonte, didascalia, autore, media, data e campi di engagement disponibili.
  • Arricchire un catalogo di contenuti: Aggiungi a un elenco di URL esistente identità del video, contesto del creator, durata, audio, hashtag, menzioni e momento della raccolta in forma normalizzata.
  • Confrontare l’engagement acquisito: Abbina i conteggi visibili a collected_at quando confronti osservazioni separate, senza considerare i valori come in tempo reale o completi.

Consigli degli esperti per la Snapchat Spotlight API

  • Invia esattamente un URL in url; array, results_limit, usernames e callback_url non sono accettati da questo endpoint.
  • Usa un link pubblico a uno Spotlight, anche se la validazione controlla l’host Snapchat e non impone un pathname; percorsi Snapchat non correlati possono fallire presso il provider.
  • Non considerare il next_cursor dei risultati dell’attività come paginazione del feed della fonte, perché la ricerca del provider è una singola richiesta di dettaglio con al massimo un record.
  • Metti in conto che ID, didascalie, campi dell’autore, media, timestamp, audio e singole metriche siano null quando la risposta pubblica li omette.
  • Salva collected_at accanto ai conteggi di engagement, così ogni misurazione resta legata al proprio momento di raccolta.
  • Preventiva 0,19 crediti per ogni attività riuscita; la fatturazione fissa non cambia con i campi restituiti o con il numero di risultati.

Oltre alla Snapchat Spotlight API, usa queste API quando ti serve un altro tipo di dati pubblici di Snapchat.

Esplora altre piattaforme

Combina i dati di Snapchat con i dati pubblici delle altre piattaforme social supportate.

Snapchat Spotlight API — FAQ

Snapchat Spotlight API è un’interfaccia programmatica per recuperare uno Spotlight pubblico da un URL Snapchat noto come record video normalizzato.

Invia un URL http o https non vuoto il cui host sia snapchat.com o un sottodominio come www.snapchat.com; il runtime non impone un pathname specifico, ma il provider si aspetta un link pubblico a uno Spotlight.

No. L’input accetta solo url ed esegue una sola ricerca di dettaglio, quindi non scopre un feed né accetta results_limit.

Il lettore condiviso delle attività espone limit, next_cursor e has_more per i record salvati; questi campi non rendono la ricerca Spotlight sottostante una richiesta paginata alla fonte.

No. Recupera dati pubblici supportati e non effettua l’accesso, non pubblica, modifica, elimina né modera contenuti, non gestisce account e non gestisce la pubblicità di Snapchat.

Ogni attività riuscita costa 0,19 crediti SocQ fissi, indipendentemente dalla disponibilità dei campi restituiti o dal numero di risultati.