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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
url | Obbligatorio (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. |
username | Obbligatorio (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.
- Prepara un nome utente Kwai oppure un URL di profilo pubblico su kwai.com o kwai-video.com.
- Invia con POST url o username a /v1/kwai/user-posts, poi salva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché l’attività riesce o segnala un errore.
- 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 trueCasi 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.
API correlate
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.