Snapchat Profile
Un profilo pubblico di Snapchat può esporre nome utente, nome visualizzato, biografia, avatar, copertina, sito web, flag dell’account, località e conteggi visibili del profilo. Questa ricerca mirata trasforma un nome utente noto in un’istantanea normalizzata dell’account, utile per arricchimento, revisione o confronto successivo.
Funzionalità della Snapchat Profile API
- Ricerca esatta per nome utenteRisolve un nome utente Snapchat noto per attività, con o senza una singola @ iniziale, invece di cercare account.
- Identità del profilo normalizzataRestituisce, quando disponibili, nome utente, nome visualizzato, biografia, URL pubblico e identificatore stabile della fonte in un record AccountItem.
- Media e contesto del profiloMantiene separati i campi disponibili di avatar, copertina, sito web e località per la visualizzazione, l’indicizzazione e i flussi di arricchimento.
- Segnali visibili dell’accountAcquisisce i flag disponibili di verifica e privacy insieme ai conteggi di follower, seguiti e post al momento della raccolta.
Parametri della Snapchat Profile API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
username | Obbligatorio | Nome utente Snapchat obbligatorio. Fornisci una @ iniziale facoltativa seguita da 1–64 lettere ASCII, cifre, punti, trattini bassi o trattini; spazi, URL di profili e altri caratteri vengono rifiutati. |
Come usare la Snapchat Profile API
Invia un nome utente accettato, attendi l’attività asincrona, poi leggi il relativo risultato di profilo normalizzato.
- Scegli un nome utente Snapchat noto composto da lettere, cifre, punti, trattini bassi o trattini; una @ iniziale è facoltativa.
- Invia username a /v1/snapchat/profile e conserva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché l’attività non raggiunge succeeded o failed.
- Dopo il successo leggi data.results.items; questa ricerca di dettaglio di norma restituisce un profilo o un elenco vuoto.
curl -X POST "https://api.socq.ai/v1/snapchat/profile" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"zane"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items after the task succeedsCasi d’uso della Snapchat Profile API
- Arricchimento di account noti: Aggiungi identità pubblica, biografia, media del profilo, sito web e conteggi disponibili a un record che contiene già un nome utente Snapchat.
- Revisione di profili selezionati: Presenta un account pubblico in una scheda profilo o in una coda di revisione coerente, senza mescolare Storie, Spotlight o azioni di gestione dell’account.
- Confronto di istantanee pubbliche: Salva collected_at con i risultati successivi per confrontare nel tempo testo del profilo pubblico, flag dell’account, media o conteggi visibili.
Consigli degli esperti per la Snapchat Profile API
- Usa la stessa forma canonica del nome utente nei tuoi record, anche se la richiesta accetta una @ iniziale.
- Invia esattamente un nome utente per attività; batch, URL di profili e results_limit non rientrano nella specifica di questo endpoint.
- Considera la sintassi accettata come una validazione dell’input, non come la prova che il nome utente corrisponda a un profilo pubblico accessibile.
- Gestisci sito web, località, media del profilo, flag dell’account e singole metriche come campi facoltativi.
- Conserva collected_at con ogni risultato salvato, perché il testo del profilo e i conteggi visibili sono valori puntuali.
API correlate
Oltre alla Snapchat Profile API, usa queste API quando ti serve un altro tipo di dati pubblici di Snapchat.
- Snapchat Spotlight API — Recupera un Snapchat Spotlight pubblico noto con creator, didascalia, media, audio, data, durata ed engagement visibile normalizzati, quando disponibili.
- Snapchat Spotlight Comments API