Torna alle API
Dati pubblici di Snapchat

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àSocQStrumenti di prodotto di Snapchat
Uso principaleRecuperare i dettagli di un solo Spotlight pubblico notoCreare, pubblicare, gestire, analizzare o promuovere contenuti autorizzati
AutenticazioneChiave API di SocQAccount Snapchat, app, token o autorizzazione specifica del prodotto
Input inizialeUn solo URL pubblico di snapchat.comContesto di un account o di un prodotto autorizzato
Pubblicare o gestire contenutiNon supportatoDisponibile nel prodotto Snapchat applicabile
Forma della rispostaRecord ReelVideoItem normalizzatoOggetti 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. 1. Invia un URL pubblico

    Invia l’URL di un solo Spotlight di snapchat.com e salva il task_id restituito.

  2. 2. Segui l’attività

    Interroga /v1/tasks/{task_id} finché l’elaborazione non riesce o non segnala un errore.

  3. 3. Leggi il risultato archiviato

    Leggi data.results.items e usa next_cursor solo se il lettore di attività condiviso segnala altri record archiviati.

Recupera un solo Spotlight di Snapchat

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

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

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.