Kwai Post
I post di Kwai sono record di contenuti pubblici che possono abbinare testo e contenuti multimediali a identità dell’autore, hashtag, menzioni, orario di pubblicazione ed engagement visibile. Questi campi supportano l’arricchimento di cataloghi di URL, la revisione dei contenuti e il confronto puntuale di post selezionati.
Funzionalità della Kwai Post API
- Ricerca di un singolo URL notoRisolve un URL pubblico su kwai.com, kwai-video.com o sui loro sottodomini, senza aggiungere regole di percorso non verificate.
- Contesto di post e autoreRestituisce identità del post, URL di origine, testo, orario di pubblicazione e, se disponibili, ID dell’autore, nome utente, nome visualizzato, URL del profilo, avatar e flag dell’account.
- Contenuti multimediali ed entità del contenutoMantiene, insieme al record del post, i riferimenti ai contenuti multimediali disponibili, le anteprime, le dimensioni, la durata, gli hashtag e le menzioni.
- Istantanea dell’engagement visibileNormalizza i conteggi disponibili di Mi piace, commenti, condivisioni e visualizzazioni con collected_at, così il record ha un orario di osservazione chiaro.
Parametri della Kwai Post API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
url | Obbligatorio | URL obbligatorio e non vuoto con un nome host analizzabile di kwai.com o kwai-video.com, inclusi i sottodomini supportati. Il runtime non richiede un particolare schema di percorso. |
Come usare la Kwai Post API
Invia un URL Kwai accettato, segui l’attività asincrona e leggi il record normalizzato del post al termine.
- Verifica che l’URL includa un nome host analizzabile su kwai.com, kwai-video.com o un sottodominio accettato.
- Invia con POST la stringa url a /v1/kwai/post e salva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché l’attività riesce o fallisce.
- Leggi data.results.items dopo il successo. Il provider di dettaglio può salvare al massimo un post, quindi has_more dovrebbe normalmente essere false anche se la route dei risultati delle attività espone next_cursor.
curl -X POST "https://api.socq.ai/v1/kwai/post" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.kwai.com/@ShortShortz8/photo/5235021727595785285"}'
# Poll GET /v1/tasks/{task_id}
# Read the normalized post from data.results.itemsCasi d’uso della Kwai Post API
- Arricchire un catalogo di post noti: Sostituisci un link Kwai salvato con ID del post, testo, identità dell’autore, orario di pubblicazione e campi di origine normalizzati.
- Rivedere il contenuto di post selezionati: Usa testo, riferimenti ai contenuti multimediali, hashtag, menzioni e contesto dell’autore per esaminare un insieme approvato di singoli post.
- Confrontare istantanee dell’engagement: Ripeti le ricerche in momenti definiti e abbina i conteggi visibili di Mi piace, commenti, condivisioni e visualizzazioni a collected_at per un confronto puntuale.
Consigli degli esperti per la Kwai Post API
- Includi lo schema dell’URL, così il nome host può essere analizzato, e usa il link pubblico esatto del post invece del semplice nome di un account.
- Invia un solo URL per attività, perché questo endpoint di dettaglio accetta un singolo campo url e non ha results_limit né input in batch.
- Conserva l’URL inviato quando un’attività riuscita non restituisce alcun elemento, perché un nome host accettato non garantisce che il provider riesca a risolvere la risorsa.
- Salva in modo difensivo i campi facoltativi di autore, contenuti multimediali, entità ed engagement, perché un post pubblico può non esporre tutti i campi normalizzati.
- Usa collected_at in ogni confronto di metriche e non trattare i contatori visibili come un feed in tempo reale.
API correlate
Oltre alla Kwai Post 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 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.