kwai/
user-posts

Raccogli una pagina di post Kwai pubblici a partire da un nome utente o da un URL del profilo supportato, con testo, autore, contenuti multimediali, hashtag, timestamp ed engagement visibile come record normalizzati.

Kwai User Posts API

Nome utente o URL del profilo
Una pagina della fonte
Post pubblici normalizzati
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 User Posts

I post degli utenti Kwai sono pubblicazioni pubbliche di un account con didascalie, identità dell’autore, contenuti multimediali allegati, hashtag, menzioni, timestamp e conteggi di engagement visibili. Questi campi di contenuto e di contesto supportano la ricerca sugli account, la revisione dei formati multimediali e il confronto puntuale dell’engagement.

Funzionalità della Kwai User Posts API

  • Due input di identità supportatiParti da un nome utente o da un URL di profilo pubblico su kwai.com o kwai-video.com; deve essere presente almeno un campo di identità.
  • Raccolta dei post pubblici in una paginaRaccogli i post restituiti da una pagina del provider per l’account pubblico selezionato, senza esporre un cursore della fonte né un limite di risultati indicato da chi chiama.
  • Contenuto normalizzato e contesto dell’autoreRicevi testo del post, campi pubblici dell’autore, URL di origine, riferimenti ai contenuti multimediali, hashtag, menzioni, orario di pubblicazione e orario di raccolta in una forma coerente del post.
  • Istantanee dell’engagement visibileMantiene i conteggi disponibili di Mi piace, commenti, condivisioni e visualizzazioni con collected_at, così i confronti restano ancorati al loro orario di osservazione.

Parametri della Kwai User Posts API

ParametriObbligatorioDescrizione
urlObbligatorio (almeno uno)Un riferimento non vuoto a un profilo Kwai il cui nome host analizzato sia kwai.com, kwai-video.com o un 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. Fornisci url o username; si possono indicare entrambi.
usernameObbligatorio (almeno uno)Un nome utente Kwai con una @ iniziale facoltativa seguita da 1 a 64 lettere ASCII, numeri, punti, trattini bassi o trattini, per una lunghezza totale massima di 65 caratteri. Il provider riceve questo valore come handle.

Come usare la Kwai User Posts API

Invia un’identità Kwai supportata, segui l’attività asincrona e scorri i risultati normalizzati salvati al termine.

  1. Prepara un nome utente Kwai oppure un URL di profilo pubblico su kwai.com o kwai-video.com.
  2. Invia con POST url o username a /v1/kwai/user-posts, poi salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività riesce o segnala un errore.
  4. Leggi data.results.items e usa il next_cursor del risultato dell’attività finché has_more è true; questo cursore pagina i risultati salvati, non la fonte Kwai.
curl -X POST "https://api.socq.ai/v1/kwai/user-posts" \
  -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 the stored-result next_cursor while has_more is true

Casi d’uso della Kwai User Posts API

  • Ricerca sui contenuti di un account pubblico: Esamina didascalie, attribuzione dell’autore, riferimenti ai contenuti multimediali pubblici, hashtag, menzioni e orari di pubblicazione di un account selezionato.
  • Revisione dei formati multimediali: Raggruppa i post restituiti per tipo di contenuto multimediale, durata, miniatura e dimensioni disponibili, conservando il post e l’autore di origine.
  • Confronto puntuale dell’engagement: Confronta Mi piace, commenti, condivisioni e visualizzazioni visibili sui post raccolti, usando collected_at per individuare la finestra di osservazione.

Consigli degli esperti per la Kwai User Posts API

  • Normalizza i nomi utente nella forma accettata con @ facoltativa prima dell’invio e verifica che gli host degli URL dei profili siano kwai.com o kwai-video.com.
  • Non aggiungere cursor o results_limit alla richiesta alla fonte: ogni attività chiede al provider una pagina usando solo i campi di identità supportati.
  • Usa cursor e limit di GET /v1/tasks/{task_id} solo dopo l’invio, quando pagini i risultati salvati dell’attività; limit accetta da 1 a 500 e vale 50 per impostazione predefinita.
  • Considera testo, dettagli dell’autore, singole metriche, contenuti multimediali, hashtag, menzioni e orario di pubblicazione come facoltativi e ancora le istantanee con collected_at.

Oltre alla Kwai User Posts API, usa queste API quando ti serve un altro tipo di dati pubblici di Kwai.

  • Kwai Profile API — Recupera un profilo Kwai pubblico per nome utente o URL supportato con identità, immagini, flag dell’account, conteggi visibili e contesto della raccolta 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 User Posts API — FAQ

Kwai User Posts API raccoglie una pagina di record di post pubblici a partire da un nome utente Kwai o da un URL del profilo supportato. Restituisce contenuto normalizzato, contesto dell’autore, contenuti multimediali, timestamp, hashtag, menzioni ed engagement visibile, quando questi campi pubblici sono disponibili.

Fornisci almeno uno tra url e username. Un nome utente può iniziare con @ e usare lettere, numeri, punti, trattini bassi o trattini; un URL deve usare kwai.com, kwai-video.com o un sottodominio di uno dei due host.

No. La specifica di invio non prevede results_limit né un cursore della fonte ed effettua una sola richiesta al provider. Il cursore di GET /v1/tasks/{task_id} pagina solo i risultati già salvati per l’attività completata.

Un post può includere ID e URL, testo, identità pubblica dell’autore, conteggi visibili di Mi piace, commenti, condivisioni e visualizzazioni, contenuti multimediali, hashtag, menzioni, published_at e collected_at. I campi facoltativi della fonte possono essere null o vuoti.

Ogni attività riuscita costa 0,19 crediti SocQ fissi. Il costo non cambia con il numero di record di post restituiti da quella richiesta a pagina singola.