kwai/
profile

Recupera un singolo profilo Kwai pubblico tramite nome utente o URL del profilo supportato, con identità normalizzata, immagini del profilo, flag dell’account, conteggi visibili e contesto di raccolta.

Kwai Profile API

Nome utente o URL del profilo
Identità normalizzata del profilo
Attività a 0,19 crediti fissi
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

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

ParametriObbligatorioDescrizione
usernameObbligatorio (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.
urlObbligatorio (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.

  1. 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.
  2. Invia username, url o entrambi a /v1/kwai/profile e salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività riesce o restituisce un errore.
  4. 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 true

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

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.

Esplora altre piattaforme

Combina i dati di Kwai con i dati pubblici delle altre piattaforme social supportate.

Kwai Profile API — FAQ

Kwai Profile API è un’interfaccia programmatica per recuperare un singolo profilo Kwai pubblico tramite nome utente o URL del profilo supportato. Restituisce, quando disponibili, identità normalizzata, immagini del profilo, flag dell’account, conteggi visibili e contesto di raccolta.

Invia username, url o entrambi. Un nome utente può avere una sola @ iniziale seguita da 1 a 64 lettere ASCII, numeri, punti, trattini bassi o trattini. Un riferimento URL deve essere analizzabile come kwai.com, kwai-video.com o un sottodominio; è accettato qualsiasi schema con un’autorità e un nome host, oltre ai riferimenti relativi al protocollo.

Un risultato può includere ID, URL di origine, nome utente, nome visualizzato, testo della biografia, avatar, immagine di copertina, sito web, flag di verifica e privacy, conteggi visibili di follower, seguiti e post, e orario di raccolta.

No. Un’attività risolve un solo profilo e la richiesta non ha results_limit. Il lettore dei risultati salvati espone comunque items, next_cursor e has_more secondo la specifica comune dei risultati asincroni.

Ogni attività Kwai Profile riuscita costa 0,19 crediti SocQ fissi. Il costo non varia con il numero di campi o di elementi del risultato.