kwai/
post

Recupera un singolo post Kwai pubblico a partire da un URL noto di kwai.com o kwai-video.com, con testo normalizzato, autore, contenuti multimediali, timestamp ed engagement visibile.

Kwai Post API

URL noto del post
Contesto di post e autore
Costo fisso per attività
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 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

ParametriObbligatorioDescrizione
urlObbligatorioURL 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.

  1. Verifica che l’URL includa un nome host analizzabile su kwai.com, kwai-video.com o un sottodominio accettato.
  2. Invia con POST la stringa url a /v1/kwai/post e salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività riesce o fallisce.
  4. 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.items

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

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.

Esplora altre piattaforme

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

Kwai Post API — FAQ

Kwai Post API è un’interfaccia programmatica per recuperare un singolo post Kwai pubblico a partire da un URL noto su un host Kwai accettato. Restituisce identità normalizzata del post, testo, autore, contenuti multimediali, hashtag, menzioni, timestamp e campi di engagement visibili.

Invia un URL non vuoto il cui nome host analizzato sia kwai.com, kwai-video.com o uno dei loro sottodomini. Serve lo schema dell’URL per analizzare il nome host.

Il validatore del runtime attuale non impone alcuno schema di percorso. Usa l’URL di un vero post pubblico, perché il percorso di un’altra risorsa può superare la validazione del nome host ma non produrre alcun record di post.

Un record può includere identità del post, URL, testo, orari di pubblicazione e raccolta, dettagli dell’autore, contenuti multimediali, hashtag, menzioni e conteggi visibili di Mi piace, commenti, condivisioni e visualizzazioni. I campi pubblici facoltativi possono essere null.

Non è accettato alcun results_limit e una richiesta al provider può salvare al massimo un post. La route condivisa dei risultati delle attività espone comunque limit, next_cursor e has_more, ma questo risultato di dettaglio dovrebbe normalmente stare nella prima pagina.

Ogni attività riuscita costa 0,19 crediti SocQ fissi. La stima non cambia con il numero di risultati e un’attività riuscita che non risolve alcun record usa comunque il costo fisso dell’attività.