Torna alle API
Dati pubblici di Kwai

Kwai APIs

Recupera profili Kwai pubblici, una pagina di post di un account o un post noto, con identità, contenuti, media, timestamp ed engagement visibile normalizzati.

API di Kwai disponibili

Usa Profiles per i record degli account, User Posts per una pagina della fonte di un account e Posts per l’URL di un singolo post pubblico noto.

Quali dati di Kwai puoi recuperare?

SocQ conserva i campi pubblici disponibili per la risorsa selezionata, senza trattare i valori mancanti come zero.

Identità del profilo

Recupera identità del profilo, immagini, siti web e flag pubblici dell’account, quando disponibili.

Contenuto dei post

Recupera testo dei post, contesto dell’autore, data di pubblicazione, hashtag e menzioni normalizzati.

Media e metriche

Conserva i campi dei media disponibili e i numeri visibili dell’account o dell’engagement come osservazioni in un dato momento.

Panoramica della specifica delle API di Kwai

Ogni endpoint ha una richiesta alla fonte limitata e usa il lettore comune dei risultati delle attività asincrone.

EndpointInputAmbito della fonte
ProfilesNome utente, URL di profilo supportato oppure entrambiUn profilo pubblico
User PostsNome utente, URL di profilo supportato oppure entrambiUna pagina della fonte restituita
PostsURL di post pubblico supportatoUn post pubblico

Come funzionano le API di Kwai

Tutti e tre gli endpoint usano il flusso di lavoro standard delle attività asincrone di SocQ.

  1. 1. Invia un identificatore

    Scegli un endpoint di Kwai, invia il nome utente o l’URL supportato come input e salva il task_id.

  2. 2. Segui l’attività

    Interroga /v1/tasks/{task_id} finché l’elaborazione ha successo o fallisce.

  3. 3. Leggi i risultati salvati

    Leggi data.results.items e segui next_cursor solo quando has_more è true.

Recupera i dati pubblici di Kwai

Autenticati con una chiave API di SocQ e invia un identificatore pubblico supportato.

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

Casi d’uso comuni delle API di Kwai

Arricchimento dei profili

Aggiungi identità pubblica, immagini, flag dell’account, URL di origine e segnali visibili dell’account ai record di account già noti.

Inventario dei contenuti

Crea un’istantanea limitata dei post pubblici di un account o arricchisci l’URL di un post pubblico noto.

Monitoraggio dei segnali pubblici

Salva i risultati ripetuti con collected_at per confrontare nel tempo i campi pubblici visibili.

Limiti e policy sui dati pubblici

I risultati di Kwai sono record pubblici rilevati in un dato momento e non offrono funzioni di pubblicazione o di gestione dell’account.

  • Profiles e User Posts richiedono almeno uno tra username e url; possono essere forniti insieme.
  • Gli URL supportati usano HTTP(S) su kwai.com, kwai-video.com o su un sottodominio di uno dei due host.
  • User Posts non segue la paginazione della fonte; i cursori dei risultati delle attività paginano solo i record già salvati da SocQ.
  • Posts risolve l’URL di un solo post pubblico supportato e non accetta results_limit.
  • Ogni attività riuscita ha un costo fisso di 0,19 crediti.

Domande frequenti sulle API di Kwai

Che cosa sono le API di Kwai?

Le tre API di Kwai recuperano un profilo pubblico, una pagina di post pubblici di un account o un post pubblico noto.

Posso inviare insieme un nome utente e un URL?

Sì per Profiles e User Posts. Basta uno dei due campi per soddisfare il requisito, e quando vengono forniti entrambi sono inoltrati.

Quali host di URL di Kwai sono supportati?

Usa un URL HTTP o HTTPS su kwai.com, kwai-video.com o su un sottodominio di uno dei due host.

User Posts segue la paginazione della fonte?

No. Salva i record di una sola pagina della fonte restituita; i cursori dei risultati delle attività leggono solo i record già salvati da SocQ.

Quanto costa la raccolta su Kwai?

Ogni attività Kwai riuscita costa un importo fisso di 0,19 crediti SocQ.

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.