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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
url | Obbligatorio | URL 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.
- Copia un URL pubblico di Snapchat Spotlight su snapchat.com o su uno dei suoi sottodomini.
- Invia l’URL come url a /v1/snapchat/spotlight e salva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché l’attività non ha successo o segnala un errore.
- 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 onlyCasi 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.
API correlate
Oltre alla Snapchat Spotlight API, usa queste API quando ti serve un altro tipo di dati pubblici di Snapchat.