Kwai Profile
I profili Kwai sono pagine pubbliche di account con nomi utente, nomi visualizzati, biografie, immagini del profilo, siti web, flag dell’account e conteggi visibili di follower, seguiti e post. Questi dati di identità e segnali puntuali supportano l’arricchimento dei profili, il confronto tra account e il monitoraggio con istantanee ripetute.
Funzionalità della Kwai Profile API
- Due identificatori supportatiRisolve un profilo pubblico da un nome utente valido, da un URL del profilo su kwai.com o kwai-video.com, oppure da entrambi gli identificatori nella stessa attività.
- Identità pubblica normalizzataRestituisce ID del profilo, URL di origine, nome utente, nome visualizzato, testo della biografia, avatar, immagine di copertina e sito web in un record dell’account coerente.
- Segnali dell’account con orario di osservazioneMantiene insieme, come istantanea puntuale del profilo, i flag di verifica e privacy disponibili, i conteggi visibili di follower, seguiti e post e collected_at.
Parametri della Kwai Profile API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
username | Obbligatorio (almeno uno) | È richiesto uno tra username e url. Un nome utente può iniziare con @, seguito da 1 a 64 lettere ASCII, numeri, punti, trattini bassi o trattini. |
url | Obbligatorio (almeno uno) | È richiesto uno tra url e username. Il riferimento non vuoto deve essere analizzabile come nome host kwai.com, kwai-video.com o sottodominio di uno dei due host. Qualsiasi schema è accettato se sono presenti un’autorità e un nome host; sono accettati anche i riferimenti relativi al protocollo. |
Come usare la Kwai Profile API
Invia un identificatore supportato, segui l’attività asincrona e leggi il record normalizzato del profilo dalla pagina dei risultati salvati.
- Prepara un nome utente valido o un riferimento a un profilo Kwai il cui nome host analizzato sia kwai.com, kwai-video.com o un sottodominio di uno dei due host.
- Invia username, url o entrambi a /v1/kwai/profile e salva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché l’attività riesce o restituisce un errore.
- Leggi il profilo in data.results.items e segui next_cursor solo se has_more è true.
curl -X POST "https://api.socq.ai/v1/kwai/profile" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.kwai.com/@ShortShortz8"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor only while has_more is trueCasi d’uso della Kwai Profile API
- Arricchimento dei record dei profili: Aggiungi identità pubblica normalizzata, immagini del profilo, sito web, flag dell’account e URL di origine a un record collegato a un account Kwai noto.
- Confronto dei dati visibili degli account: Confronta i conteggi disponibili di follower, seguiti e post tra profili selezionati, senza considerare i valori come totali in tempo reale.
- Monitoraggio delle istantanee dei profili: Salva i risultati ripetuti con collected_at per seguire nel tempo le variazioni dei campi di identità pubblica, dei flag dell’account e dei conteggi visibili.
Consigli degli esperti per la Kwai Profile API
- Fornisci almeno un identificatore. Quando sono presenti sia username sia url, il backend inoltra entrambi invece di sceglierne uno al posto tuo.
- Convalida i nomi utente con ^@?[A-Za-z0-9._-]{1,64}$ e richiedi che il nome host dell’URL analizzato sia kwai.com, kwai-video.com o un sottodominio prima dell’invio.
- Considera biografia, avatar, immagine di copertina, sito web, flag dell’account e singole metriche come facoltativi, perché un profilo pubblico può esporre solo una parte dello schema.
- Usa id come chiave principale di deduplicazione, ripiega su url quando serve e conserva collected_at accanto a ogni istantanea puntuale delle metriche.
API correlate
Oltre alla Kwai Profile API, usa queste API quando ti serve un altro tipo di dati pubblici di Kwai.
- Kwai User Posts API — Raccoglie una pagina di post pubblici di Kwai per nome utente o URL di profilo supportato con contenuti, autori, media, date, hashtag, menzioni ed engagement visibile normalizzati.
- Kwai Post API — Trasforma l’URL di un post pubblico noto di Kwai in contenuti, autore, media, date, entità ed engagement visibile normalizzati.