Kwai Post
Las publicaciones de Kwai son registros de contenido público que pueden combinar texto y contenido multimedia con la identidad del autor, hashtags, menciones, la hora de publicación y la interacción visible. Estos campos sirven para enriquecer catálogos de URL, revisar contenido y comparar en un momento dado publicaciones seleccionadas.
Funcionalidades de la Kwai Post API
- Búsqueda de una sola URL conocidaResuelve una URL pública de kwai.com, kwai-video.com o sus subdominios sin agregar una regla de ruta no verificada.
- Contexto de la publicación y del autorDevuelve la identidad de la publicación, la URL de origen, el texto, la hora de publicación y, si están disponibles, el ID del autor, el nombre de usuario, el nombre visible, la URL del perfil, el avatar y los indicadores de cuenta.
- Contenido multimedia y entidadesConserva junto al registro de la publicación las referencias multimedia disponibles, las vistas previas, las dimensiones, la duración, los hashtags y las menciones.
- Instantánea de la interacción visibleNormaliza los conteos disponibles de Me gusta, comentarios, veces compartido y vistas junto con collected_at, de modo que el registro tenga una hora de observación clara.
Parámetros de la Kwai Post API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
url | Obligatorio | URL obligatoria y no vacía con un nombre de host analizable de kwai.com o kwai-video.com, incluidos los subdominios admitidos. El runtime no exige un patrón de ruta concreto. |
Cómo usar la Kwai Post API
Envíe una URL de Kwai aceptada, siga la tarea asíncrona y lea el registro normalizado de la publicación al finalizar.
- Confirme que la URL incluya un nombre de host analizable de kwai.com, kwai-video.com o un subdominio aceptado.
- Envíe la cadena url por POST a /v1/kwai/post y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que la tarea tenga éxito o falle.
- Tras el éxito, lea data.results.items. El proveedor de detalle puede guardar como máximo una publicación, por lo que has_more normalmente debería ser false aunque la ruta de resultados de la tarea exponga 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.itemsCasos de uso de la Kwai Post API
- Enriquecer un catálogo de publicaciones conocidas: Reemplace un enlace guardado de Kwai por el ID de la publicación, el texto, la identidad del autor, la hora de publicación y los campos de origen normalizados.
- Revisar el contenido de publicaciones seleccionadas: Use el texto, las referencias multimedia, los hashtags, las menciones y el contexto del autor para inspeccionar un conjunto aprobado de publicaciones individuales.
- Comparar instantáneas de interacción: Repita las búsquedas en momentos definidos y combine los conteos visibles de Me gusta, comentarios, veces compartido y vistas con collected_at para comparar en un momento dado.
Consejos de expertos para la Kwai Post API
- Incluya el esquema de la URL para que se pueda analizar el nombre de host, y use el enlace público exacto de la publicación y no solo el nombre de una cuenta.
- Envíe una URL por tarea, porque este endpoint de detalle acepta un único campo url y no tiene results_limit ni entrada por lotes.
- Conserve la URL enviada cuando una tarea exitosa no devuelva ningún elemento, ya que un nombre de host aceptado no garantiza que el proveedor pueda resolver el recurso.
- Almacene con tolerancia los campos opcionales de autor, contenido multimedia, entidades e interacción, porque una publicación pública puede no exponer todos los campos normalizados.
- Use collected_at en cada comparación de métricas y no trate los contadores visibles como un flujo en tiempo real.
APIs relacionadas
Además de la Kwai Post API, use estas APIs cuando necesite otro tipo de datos públicos de Kwai.
- Kwai Profile API — Obtiene un perfil público de Kwai por nombre de usuario o URL compatible, con identidad normalizada, imágenes, indicadores de cuenta, conteos visibles y contexto de recolección.
- Kwai User Posts API — Recolecta una página de publicaciones públicas de Kwai por nombre de usuario o URL de perfil compatible, con contenido normalizado, autores, contenido multimedia, marcas de tiempo, hashtags, menciones e interacción visible.