Snapchat Spotlight Comments
I commenti di Snapchat Spotlight sono risposte pubbliche associate a uno specifico elemento Spotlight. SocQ salva ogni risposta restituita come CommentItem con identità della fonte, testo del commento, contesto dell’autore disponibile, riferimenti al genitore e al post, date di pubblicazione e raccolta e conteggi visibili di Mi piace o risposte.
Funzionalità della Snapchat Spotlight Comments API
- Un URL di Spotlight per attivitàInvia un url non vuoto su snapchat.com o su un sottodominio di Snapchat; il provider richiede una pagina della fonte per quella destinazione.
- Record di commenti normalizzatiLeggi ID dei commenti, testo, URL della fonte, timestamp e identità dell’autore, quando disponibile, nella struttura di risultato stabile CommentItem 1.0.
- Contesto di thread ed engagementConserva parent_id, post_id, likes_count e replies_count quando la fonte li espone, senza considerare i campi mancanti come zero né come copertura completa del thread.
Parametri della Snapchat Spotlight Comments API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
url | Obbligatorio | URL Snapchat obbligatorio non vuoto. La validazione a runtime accetta snapchat.com e i suoi sottodomini; usa un URL pubblico canonico /@username/spotlight/{spotlight_id}, così il provider riceve la risorsa Spotlight voluta. |
Come usare la Snapchat Spotlight Comments API
Invia un URL pubblico di Snapchat Spotlight, segui l’attività asincrona e leggi i commenti normalizzati salvati con la paginazione dei risultati dell’attività.
- Copia l’URL pubblico canonico di Snapchat Spotlight che vuoi esaminare.
- Invia con POST url a /v1/snapchat/spotlight-comments e salva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché l’attività non ha successo o restituisce un errore.
- Leggi data.results.items; se il risultato salvato dell’attività si estende su più pagine di risposta, continua con next_cursor finché has_more è true.
curl -X POST "https://api.socq.ai/v1/snapchat/spotlight-comments" \
-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 and follow next_cursor while has_more is trueCasi d’uso della Snapchat Spotlight Comments API
- Revisione qualitativa delle risposte: Esamina il testo pubblico dei commenti restituiti e il contesto disponibile sugli autori per individuare domande, reazioni e temi ricorrenti attorno a uno Spotlight selezionato.
- Archivi di commenti collegati alla fonte: Conserva ID dei commenti, URL della fonte, post_id, parent_id, published_at e collected_at, così ogni risposta salvata mantiene la provenienza disponibile.
- Istantanee dell’engagement visibile: Confronta likes_count e replies_count disponibili tra i commenti restituiti, ancorando ogni osservazione a collected_at.
Consigli degli esperti per la Snapchat Spotlight Comments API
- Usa l’URL pubblico canonico /@username/spotlight/{spotlight_id}, anche se la validazione a runtime controlla l’host Snapchat e non impone quel percorso esatto.
- Non inviare cursor o results_limit nel payload di invio; questo endpoint gestisce solo url e raccoglie una pagina del provider.
- Considera parent_id e replies_count come contesto disponibile, non come prova che i record restituiti contengano un albero completo delle risposte.
- Metti in conto che ID, URL, testo, campi dell’autore, published_at, parent_id, post_id e metriche siano null quando la fonte non li fornisce.
- Tieni separata la profondità di raccolta del provider dalla paginazione di GET /v1/tasks/{task_id}, il cui cursore scorre solo i risultati già salvati dall’attività completata.
API correlate
Oltre alla Snapchat Spotlight Comments API, usa queste API quando ti serve un altro tipo di dati pubblici di Snapchat.
- Snapchat Profile API
- Snapchat Spotlight API — Recupera un Snapchat Spotlight pubblico noto con creator, didascalia, media, audio, data, durata ed engagement visibile normalizzati, quando disponibili.