snapchat/
spotlight-comments

Raccogli una pagina della fonte di commenti pubblici per un URL di Snapchat Spotlight, con testo, autore, riferimento al thread, timestamp e engagement visibile normalizzati.

Snapchat Spotlight Comments API

URL di Spotlight in input
Una pagina della fonte
Commenti normalizzati
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 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

ParametriObbligatorioDescrizione
urlObbligatorioURL 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à.

  1. Copia l’URL pubblico canonico di Snapchat Spotlight che vuoi esaminare.
  2. Invia con POST url a /v1/snapchat/spotlight-comments e salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività non ha successo o restituisce un errore.
  4. 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 true

Casi 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.

Oltre alla Snapchat Spotlight Comments 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 Comments API — FAQ

Snapchat Spotlight Comments API è un’interfaccia programmatica per raccogliere una pagina della fonte di record di commenti pubblici associati a un URL di Snapchat Spotlight specificato.

La specifica di invio accetta esattamente una stringa url obbligatoria. La validazione a runtime richiede un host snapchat.com o un sottodominio; usa la forma pubblica canonica /@username/spotlight/{spotlight_id} per la risorsa voluta.

No. La specifica di invio non ha i campi results_limit o cursor e l’integrazione con il provider fa una sola richiesta alla fonte.

Quel cursore appartiene a GET /v1/tasks/{task_id}. Scorre i record di commenti già salvati per un’attività riuscita, con un limite di risposta predefinito di 50 e un intervallo accettato da 1 a 500; non recupera un’altra pagina della fonte Snapchat.

CommentItem 1.0 include id, platform, resource, type, url, published_at, collected_at, text, author, parent_id, post_id e metrics con likes_count e replies_count. I campi nullable restano null quando non sono disponibili.

Un’attività Snapchat Spotlight Comments riuscita costa 0,19 crediti SocQ fissi, indipendentemente dal numero di commenti restituiti in quell’unica pagina della fonte.