kwai/
post

Obtenga una publicación pública de Kwai a partir de una URL conocida de kwai.com o kwai-video.com, con texto, autor, contenido multimedia, fechas e interacción visible normalizados.

Kwai Post API

URL de publicación conocida
Contexto de publicación y autor
Costo fijo por tarea
0.19 créditos por solicitud
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

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ámetrosObligatorioDescripción
urlObligatorioURL 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.

  1. Confirme que la URL incluya un nombre de host analizable de kwai.com, kwai-video.com o un subdominio aceptado.
  2. Envíe la cadena url por POST a /v1/kwai/post y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea tenga éxito o falle.
  4. 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.items

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

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.

Explorar otras plataformas

Combine los datos de Kwai con datos públicos de otras plataformas sociales compatibles.

Kwai Post API — FAQ

Kwai Post API es una interfaz programática para obtener una publicación pública de Kwai a partir de una URL conocida de un host de Kwai aceptado. Devuelve la identidad de la publicación, el texto, el autor, el contenido multimedia, los hashtags, las menciones, las fechas y los campos de interacción visible, todo normalizado.

Envíe una URL no vacía cuyo nombre de host analizado sea kwai.com, kwai-video.com o uno de sus subdominios. Se necesita el esquema para poder analizar el nombre de host.

El validador actual del runtime no impone ningún patrón de ruta. Use la URL de una publicación pública real, porque la ruta de otro recurso puede pasar la validación del host y aun así no producir ningún registro de publicación.

Un registro puede incluir la identidad de la publicación, la URL, el texto, las horas de publicación y de recopilación, los datos del autor, el contenido multimedia, los hashtags, las menciones y los conteos visibles de Me gusta, comentarios, veces compartido y vistas. Los campos públicos opcionales pueden ser null.

No se acepta results_limit, y una solicitud al proveedor puede guardar como máximo una publicación. La ruta compartida de resultados de la tarea sigue exponiendo limit, next_cursor y has_more, pero este resultado de detalle normalmente debería caber en su primera página.

Cada tarea exitosa cuesta una tarifa fija de 0.19 créditos de SocQ. La estimación no cambia con la cantidad de resultados, y una tarea exitosa que no resuelve ningún registro igualmente usa el cargo fijo por tarea.