API de Kuaishou en Python: tres vías para obtener datos de Kuaishou, probadas

El 2026-11-14, entre las 00:18 y las 01:25 hora de Singapur, ejecutamos cuatro veces en Python, con requests, una cadena de 9 pasos sobre Kuaishou: búsqueda por palabra clave, detalle de vídeo, dos páginas de comentarios y cinco rankings públicos. Las 36 peticiones cobradas devolvieron datos y cada cobro coincidió con el precio del catálogo. Una cadena completa costó 0,016030 USD.

Los resultados muestran tres cosas que la documentación no cuenta. La antigüedad de los resultados depende de la palabra: con 20 filas, «siembra de trigo» trajo 18 vídeos de los últimos 30 días y «manzana Fuji», solo 1. Los rankings cambian a ritmos muy distintos: tras 37 minutos solo seguían 21 de los 49 títulos en tendencia, mientras los 50 productos del ranking de compras no cambiaron en cuatro capturas. Y para un exportador de aguacate, los comentarios dicen más que las cifras: en un vídeo con 6412 comentarios, cerca de la mitad de las 20 filas leídas decían que la fruta no sabe a nada o tiene un gusto raro.

Las otras dos vías las contrastamos con fuentes primarias. La plataforma abierta de Kuaishou admite empresas tras una revisión, y el token de un usuario solo lee su propio perfil y sus propios vídeos. Entre los proyectos abiertos, un issue de KS-Downloader del 2026-11-02 informa de que el detalle de vídeo falla siempre tras el rediseño web.

Kwai y Kuaishou no son la misma aplicación

Quien busca «api de kuaishou» desde América Latina suele pensar en Kwai. Kwai es la aplicación internacional de la misma empresa y tiene mucho uso en Brasil y en otros mercados latinoamericanos. Kuaishou es la aplicación de vídeo corto para China continental. Tienen usuarios distintos, contenidos distintos y dominios web distintos. Esta guía trata solo de Kuaishou en China continental. Si un resultado de búsqueda sobre la «kuaishou api» habla de Kwai, mire primero el dominio.

¿Por qué interesa Kuaishou a un exportador, una oficina comercial o un periodista latinoamericano? Por su tamaño y por su público. La empresa declaró 412,3 millones de usuarios activos diarios y 797,3 millones de usuarios activos mensuales en el segundo trimestre de 2026. Kuaishou tiene mucho peso fuera de las grandes ciudades chinas y en el comercio en directo de alimentos. Para quien vende fruta, carne o vino a China, ver qué se publica y se comenta allí es información de mercado.

Las tres vías y para quién sirve cada una

Hay tres formas de obtener datos de Kuaishou con Python. Puede registrarse en la plataforma abierta de Kuaishou, crear una aplicación y pedir a los usuarios que la autoricen. Puede ejecutar un kuaishou scraper de código abierto de GitHub. O puede llamar a una API de datos de pago por llamada. Lo que cada vía permite leer es muy distinto.

Vía 1: la plataforma abierta y la kuaishou api oficial

Leímos todas las páginas citadas abajo el 2026-11-14; entre paréntesis va la fecha de actualización que muestra cada página.

Quién puede entrar: empresas, tras una revisión

La página de introducción (actualizada el 2024-09-06) enumera tres capacidades abiertas: inicio de sesión con Kuaishou, gestión de usuarios y compartir contenido, en forma de SDK o de API abierta. También cita tres productos más: miniprogramas, juegos y comercio electrónico. No aparece ninguna capacidad de consulta de datos ni de búsqueda de contenidos. La plataforma existe para que las aplicaciones de terceros usen las cuentas de Kuaishou y la función de compartir.

La página de alta (actualizada el 2026-03-06) empieza con una frase en negrita: el desarrollador debe completar sus datos básicos y una verificación de cualificación, y la plataforma debe aprobarlo. La verificación pide datos de la empresa, del representante legal y del administrador. Después empieza una revisión, y solo con la aprobación se pueden crear aplicaciones. No encontramos ninguna vía de alta para desarrolladores particulares.

La página de registro de aplicaciones (actualizada el 2026-03-06) distingue aplicaciones móviles, web y de juegos. Una aplicación web también sube un formulario de registro del sitio. En la parte móvil, una nota dice que los permisos de directo todavía no se pueden pedir. Con la aprobación llegan un app_id y un app_secret, y después se pide cada endpoint por separado en los detalles de la aplicación. La página de preguntas frecuentes (actualizada el 2024-08-26) explica dos errores habituales: ACCESS_DENIED indica que el usuario no concedió ese permiso, e INVALID_SCOPE indica que la aplicación nunca pidió el endpoint.

Qué puede leer: los datos propios del usuario que autoriza

La página de inicio de sesión (actualizada el 2024-07-23) es la puerta de todos los endpoints de datos. Solo admite el flujo authorization_code de OAuth 2.0. El usuario aprueba su aplicación dentro de Kuaishou y su dirección de retorno recibe un código válido durante 2 minutos. Ese código se cambia por un access_token que dura 48 horas (172 800 segundos). El refresh_token dura 180 días y no se alarga al refrescar. Aunque refresque cada día, a los 180 días el usuario tiene que volver a autorizar.

Dos páginas muestran qué se puede leer con el token. El endpoint de información pública devuelve el apodo, el género, el avatar, la ciudad, el número de seguidores y el número de seguidos del usuario. La página de consulta de vídeos (actualizada el 2024-12-23) ofrece una lista de vídeos, el detalle de un vídeo y el número de vídeos. Los tres piden el permiso user_video_info y leen los vídeos que publicó el propio usuario. La lista pagina con un cursor; count vale 20 por defecto y como máximo 200.

Por eso la documentación de la plataforma abierta no tiene endpoints para tres tareas frecuentes: buscar vídeos de otros por palabra clave, leer los comentarios de un vídeo popular y capturar a diario la lista de tendencias. La plataforma sirve para algo concreto: que un usuario de Kuaishou inicie sesión en su aplicación y que usted le muestre o analice sus propios vídeos.

Comercio electrónico, publicidad y el Índice de Kuaishou

Kuaishou tiene otras tres entradas oficiales relacionadas con datos, y quien busca «api de kuaishou» suele mezclarlas. La plataforma abierta de comercio electrónico tiene dos perfiles, proveedor de servicios y comerciante, y sus endpoints cubren su propia tienda, productos, pedidos y posventa. El centro de desarrolladores de publicidad ofrece la API de marketing para sus propias cuentas publicitarias, campañas e informes; su registro de cambios más reciente es del 2026-08-27. El Índice de Kuaishou muestra la popularidad de palabras clave tras iniciar sesión, pero su acuerdo de usuario, vigente desde el 2023-06-01, solo permite el uso no comercial y prohíbe rastreadores y otras herramientas automáticas.

El acuerdo de servicio de miniprogramas (actualizado el 2025-09-22, vigente desde el 2025-09-16) es claro en su sección 5, punto 5: sin el consentimiento de Kuaishou, no se pueden recoger, almacenar, extraer ni tratar datos de usuarios, ni pedir a un usuario que los facilite. La cláusula obliga a quien desarrolla miniprogramas, pero también muestra la postura general de Kuaishou: leer o guardar datos de usuarios exige su consentimiento previo.

Vía 2: un kuaishou scraper de código abierto en GitHub

Si busca «kuaishou scraper» o «api de kuaishou github», salen una y otra vez los cinco proyectos de la tabla. El 2026-11-14, hacia las 00:20 hora de Singapur, leímos con la API de GitHub sus estrellas, su último push y su licencia. También leímos cada README y los issues sobre Kuaishou del último año. Aquí nombramos solo los proyectos, nunca a quienes abrieron los issues.

Fallos públicos de 2026: el detalle de vídeo se rompe tras un rediseño

El aviso de fallo más reciente es el issue #84 de KS-Downloader, abierto el 2026-11-02 y todavía abierto cuando lo leímos. Su título dice que el detalle de vídeo falla siempre. El texto explica que, tras un rediseño reciente de la web de Kuaishou, la página de escritorio ya no contiene los datos del vídeo. La página móvil para compartir sí los contiene, pero la expresión regular del proyecto exige que dos campos estén juntos. Cerca de la mitad de las respuestas al mismo enlace usan otra variante de página, así que el mismo enlace a veces funciona y a veces no.

Si cambia la estructura de la página, el analizador tiene que cambiar, y el arreglo espera a que el mantenedor tenga tiempo. MediaCrawler tuvo cuatro casos de Kuaishou en 2026. El issue #808 (2026-01-10) informó de que no salían comentarios y se cerró ese mismo día. El #843 (2026-03-09) informó de comentarios incompletos con un error del endpoint y sigue abierto. La solicitud de cambios #917 (2026-06-15) arregló un bucle infinito en la paginación. El #954 (2026-08-06) informó de que no se descargaban vídeos en el modo de detalle y sigue abierto.

Los comentarios y la paginación son lo que más se rompe, y el detalle de vídeo puede caer entero tras un rediseño. Si usa un script, cuente con ese mantenimiento y lea los issues del último mes antes de depender de un proyecto.

Licencias, sesiones iniciadas y robots.txt

La licencia decide si puede usar un script en su trabajo. El README de MediaCrawler dice que todo el contenido es solo para estudio y referencia y que no puede usarse con fines comerciales, y enlaza un repositorio que recopila casos judiciales chinos sobre rastreadores. KS-Downloader y lxSpider usan GPL-3.0, así que una versión modificada que se distribuya también debe ser abierta. KuaiShou-Spider no declara licencia; según la documentación de GitHub, sin licencia rigen los derechos de autor por defecto y nadie más puede copiar, distribuir ni modificar la obra. Solo kuaishou-crawler usa la licencia MIT, pero su último push es de mayo de 2023.

La sesión iniciada es otro coste. MediaCrawler abre un navegador real con Playwright y guarda el estado de la sesión. Su plantilla de issues pide confirmar que el problema no viene de un control deslizante, de una cookie caducada o del control de riesgos de la plataforma: ahí es donde se suelen atascar los scripts propios. El robots.txt de Kuaishou, leído el 2026-11-14, permite una docena de rastreadores con nombre y termina con Disallow: / para todos los demás. Esta guía no explica cómo superar controles, desafíos o sesiones caducadas, porque eso sería sortear los límites de la plataforma.

Vía 3: una API de datos de Kuaishou de pago por llamada en Python

La tercera vía deja las sesiones, el análisis de páginas y los arreglos tras cada rediseño del lado del servicio. Su código en Python solo envía peticiones HTTP y lee JSON. Usamos POST /api/v1/social de EveryInfra, con platform igual a kuaishou y una action distinta para cada capacidad. Antes de empezar, lea gratis el catálogo GET /api/v1/social/catalog?platform=kuaishou. El 2026-11-14 a las 00:14 hora de Singapur mostraba las capacidades de Kuaishou como disponibles; la tabla recoge sus precios y nuestras llamadas de prueba.

El script de abajo solo necesita requests. El 2026-11-14 a las 02:15 hora de Singapur lo ejecutamos tal cual con la palabra clave de la manzana Fuji: las 9 peticiones devolvieron datos y el cobro sumó 0,016030 USD. Lee la clave de una variable de entorno y guarda en JSON la petición, el tiempo y la respuesta completa de cada paso. Resuelve tres casos que vimos en las pruebas. Ante un 429 o un 503 reintentable, espera lo que indica retry_after y repite la petición; ninguno de los dos se cobra. Una llamada lenta puede responder status: running con una poll_url, y entonces el script consulta esa URL en vez de enviar dos veces. Por último, descarta las filas cuyo texto no contiene la palabra clave antes de elegir un vídeo.

"""Kuaishou chain: search -> video -> comments (2 pages) -> trending -> hot_boards -> live_rank -> shopping_rank -> brand_rank.
pip install requests==2.32.3 ; export EVERYINFRA_API_KEY=... ; python kuaishou_chain.py 红富士苹果 run1"""
import json, os, sys, time
from pathlib import Path
import requests

API = "https://api.everyinfra.com/api/v1/social"
SESSION = requests.Session()
SESSION.headers["Authorization"] = "Bearer " + os.environ["EVERYINFRA_API_KEY"]  # the key stays in the environment


def call(action, params, out_dir, name):
    body = {"platform": "kuaishou", "action": action, "params": params}
    for _ in range(5):
        t0 = time.time()
        r = SESSION.post(API, json=body, timeout=150)
        data = r.json()
        err = data.get("error") or {}
        # 429 and retryable 503 are not charged: wait as told, then send the same request again
        if r.status_code == 429 or (r.status_code == 503 and err.get("retryable")):
            time.sleep(int(err.get("retry_after") or 60))
            continue
        break
    # slow calls answer status=running with a poll_url: poll it instead of sending the request again
    while data.get("status") == "running" and data.get("poll_url"):
        time.sleep(5)
        data = SESSION.get(data["poll_url"], timeout=60).json()
    rec = {"started_sgt": time.strftime("%Y-%m-%d %H:%M:%S", time.localtime(t0)), "elapsed_s": round(time.time() - t0, 2),
           "http_status": r.status_code, "request": body, "response": data}
    out_dir.mkdir(parents=True, exist_ok=True)
    (out_dir / f"{name}.json").write_text(json.dumps(rec, ensure_ascii=False, indent=1))
    rows = data.get("results") or []
    print(name, r.status_code, rec["elapsed_s"], len(rows), (data.get("billing") or {}).get("charged_usd"), flush=True)
    time.sleep(7)  # a short gap between calls; set it from the rate limit of your own key
    return data, rows


def main(keyword, tag, hot="hot", shop="products", brand="food_drink", live="all"):
    out = Path(os.environ.get("OUT_DIR", ".")) / tag
    _, videos = call("search", {"keyword": keyword, "limit": 20}, out, "1_search")
    word = keyword.split()[0]  # keep rows whose text has the keyword, then take the most-commented one
    on_topic = [v for v in videos if word in (v.get("text") or "")] or videos
    if not on_topic:
        return print("empty search: not charged, stop here")
    pick = max(on_topic, key=lambda v: (int(v.get("comment_count") or 0), int(v.get("like_count") or 0)))
    vid = str(pick["id"])  # a long numeric id also works as the url input of video and comments
    call("video", {"url": vid}, out, "2_video")
    page1, _ = call("comments", {"url": vid}, out, "3_comments_p1")
    if page1.get("next_page_token"):
        call("comments", {"url": vid, "page_token": page1["next_page_token"]}, out, "4_comments_p2")
    call("trending", {}, out, "5_trending")
    call("hot_boards", {"board": hot}, out, "6_hot_boards")
    call("live_rank", {"category": live}, out, "7_live_rank")
    call("shopping_rank", {"board": shop}, out, "8_shopping_rank")
    call("brand_rank", {"category": brand}, out, "9_brand_rank")


if __name__ == "__main__":
    main(*sys.argv[1:])

Cada paso hace una sola cosa. kuaishou/search busca vídeos públicos para una palabra clave; cada fila trae campos como el id, el texto, la duración en milisegundos, las vistas, los me gusta, la fecha de publicación y el id del autor. kuaishou/video añade los guardados, el enlace del vídeo y el enlace del perfil del autor. kuaishou/comments devuelve una página de comentarios, y cada fila trae el id de quien comenta, el texto, los me gusta, la fecha y la región. Los cinco pasos finales son rankings y no necesitan palabra clave. Para encontrar cuentas por palabra clave, llame además a kuaishou/user_search: nuestra búsqueda de «huerto» devolvió 30 cuentas por 0,008 USD. El script deja 7 segundos entre llamadas; ajuste esa pausa al límite de su propia clave.

Pruebas reales: cuatro palabras clave en cuatro momentos

Elegimos cuatro palabras clave. «Manzana Fuji» y «siembra de trigo» alimentan el ejemplo de muestreo rural: una es un producto agrícola y la otra una técnica de la siembra de otoño. «Aguacate» es una fruta importada que se vende todo el año y sirve para el ejemplo de exportadores. «BYD» va con el ranking de marcas de coches. Las tres primeras ejecuciones usaron el tablero hot o useful, el tablero products y el ranking de marcas de alimentación; la cuarta usó el ranking de marcas de coches. Las cuatro empezaron a las 00:18, 00:29, 00:56 y 01:20, hora de Singapur, el 2026-11-14.

Cada cobro coincidió con el precio del catálogo: 0,008 USD la búsqueda, 0,000806 USD el detalle y cada ranking, y 0,001597 USD cada página de comentarios. Una cadena completa costó por tanto 0,016030 USD.

Medimos el tiempo de API como la suma de los nueve tiempos de petición, sin la pausa entre pasos ni las esperas antes de un reintento: la mediana de las cuatro cadenas completas fue de 58,9 segundos (muestra de 4). En trabajos por lotes, ponga las búsquedas en una cola en paralelo y programe los rankings aparte; el límite de su propia clave marca hasta dónde llegar.

Búsqueda: las mismas 20 filas pueden ser muy viejas o muy nuevas

La búsqueda de Kuaishou ordena por relevancia, y un resultado puede tener tres años o un día. En la prueba 1, «manzana Fuji» devolvió 20 vídeos: el más antiguo era del 2023-09-05 y el más reciente del 2026-10-27, y solo uno de los 20 se publicó en los últimos 30 días. En la prueba 2, los 20 vídeos de «siembra de trigo» eran de 2026 y 18 de los últimos 30 días. La razón es la temporada: a mediados de noviembre terminaba la siembra del trigo de invierno, y el 2026-11-11 la televisión estatal china informó de que ya se había sembrado más del 80 %. La cosecha y la venta de manzana se concentran en septiembre y octubre, así que la búsqueda conserva los éxitos de años anteriores.

La prueba 3, a las 00:56 hora de Singapur, buscó «aguacate» y quedó en un punto intermedio: 6 de los 20 vídeos eran de los últimos 30 días, 2 de antes en 2026, 10 de 2025 y 2 de 2023. El aguacate se vende en China todo el año, así que no hay una temporada que concentre lo nuevo. Si usted quiere saber qué se dice este mes, filtre por posted_at a su ventana de tiempo antes de contar nada, y amplíe la búsqueda con variantes del nombre si la muestra se queda corta.

El id de vídeo de cada fila es un número largo que sirve directamente como url en kuaishou/video y kuaishou/comments, sin construir ningún enlace. La marca de verificación separa bien las dos palabras: ninguna de las 20 filas de «manzana Fuji» venía de una cuenta verificada, frente a 9 de las 20 de «siembra de trigo», porque en los temas agrícolas abundan las instituciones y los medios. Nuestro script elige el vídeo primero por comentarios y después por me gusta. En sus estadísticas, registre «vacío» y «cero» como valores distintos.

Las vistas varían muchísimo. «Manzana Fuji» fue de 112 a 3 086 343 vistas, con una mediana de 24 703. «Siembra de trigo» fue de 64 a 905 160, con una mediana de 4162. Nuestro script conserva las filas cuyo texto contiene los dos primeros caracteres de la palabra clave, lo que dejó 18 filas en cada caso, y después elige la que tiene más comentarios.

Comentarios: de 10 a 15 por página y 217 páginas para un vídeo popular

kuaishou/comments devuelve una página por llamada y el tamaño de página varía. En la prueba 1 las dos páginas tuvieron 10 filas; en la prueba 2, la primera tuvo 15 y la segunda 10. Cada página trae un next_page_token: devuélvalo tal cual para pedir la siguiente. Es una cadena larga que empieza por pt1. y no hace falta interpretarla. Las pruebas 3 y 4 también devolvieron 10 filas por página: en las ocho páginas reunimos 85 filas, 10,6 por página de media.

Con 10 filas por página, el vídeo de manzana Fuji de la prueba 1 necesita 217 páginas para leer sus 2166 comentarios. A 0,001597 USD por página son unos 0,35 USD, lo mismo que 43 búsquedas. Por eso conviene pedir los comentarios en dos niveles: para análisis de temas o de sentimiento, las dos o tres primeras páginas (de 20 a 45 filas) suelen bastar; para un archivo completo, calcule antes las páginas y el presupuesto a partir del número de comentarios.

El orden también cuenta. En la prueba 1, los 20 comentarios llegaron del más nuevo al más viejo: el más reciente del 2026-08-28 y el más antiguo del 2026-01-07, en un vídeo publicado el 2024-11-03. Dos páginas cubrieron solo los últimos ocho meses de conversación. Los 25 comentarios de la prueba 2 no llegaron en orden estricto de fecha.

Las 85 filas de comentarios de las cuatro pruebas traían ip_location, la región que Kuaishou muestra. En la prueba 1 las regiones más frecuentes fueron Guangdong 5, Yunnan 4 y Shandong 2; en la prueba 2, Hunan 6, Sichuan 5 y Guangdong 3. Los me gusta escasean: 19 de 20 filas en la prueba 1 y 23 de 25 en la prueba 2 tenían cero. La respuesta incluye el nombre y el avatar de quien comenta, pero no los guardamos.

La prueba 4 enseñó otro caso. El vídeo elegido para BYD, un anuncio del modelo Seal 08 publicado el 2026-07-08 por una cuenta verificada, tenía 15 169 comentarios. Las dos páginas más recientes trajeron 20 filas del 2026-11-09 al 2026-11-13, y las 20 eran emojis o «666», la jerga china para «genial», todas con cero me gusta. Un análisis de sentimiento no encontraría nada que leer. Quite primero los comentarios que solo tienen emojis y cuente cuántos comentarios reales quedan. Leer los 15 169 comentarios costaría unas 1517 páginas, cerca de 2,42 USD.

El vídeo elegido en la prueba 2 era una noticia sobre la siembra del trigo de invierno publicada el 2026-11-12 por una cuenta verificada de la televisión estatal, con 632 220 vistas y 6976 me gusta. Los 25 comentarios de sus dos páginas llegaron en las 24 horas siguientes a la publicación, así que muestran la primera reacción a una noticia.

Rankings: las tendencias cambian rápido, compras y marcas casi no se mueven

Los cinco rankings no necesitan palabra clave. Cada uno cuesta 0,000806 USD y devuelve entre 27 y 51 filas, así que son los datos más baratos de la cadena. Tomamos una captura de cada uno en cuatro momentos para ver cuánto cambian.

kuaishou/trending devolvió entre 47 y 51 filas cada vez, con posición, título, etiqueta y una lista de id de vídeos relacionados. Las capturas de las 00:20 y las 00:31, separadas por 11 minutos, compartían 40 de 49 títulos y 7 de los 10 primeros. Después cambió más: a las 00:57 solo coincidían 21 títulos (43 %) con la lista de las 00:20, y a las 01:21 coincidían 29 (59 %). En cada captura, 7 de los 10 primeros seguían siendo los de la primera. En la misma hora, la parte de los 50 presentadores en directo que coincidía con la primera captura bajó del 94 % al 52 %. Las noticias y los asuntos públicos ocupan la parte alta; no citamos títulos. Para investigar, trate la lista como el registro de lo que la plataforma mostraba en ese momento.

kuaishou/hot_boards tiene cuatro tableros: hot, entertainment, society y useful. Cada fila trae posición, título, número de vistas y etiqueta. El tablero hot de las 00:21 tuvo 51 filas, y sus 10 primeras eran los mismos títulos que las 10 primeras tendencias de un minuto antes: las seis primeras en el mismo orden y de la 7 a la 10 en otro orden. El tablero useful de las 00:31 tuvo 27 filas: recetas caseras y saberes rurales, como secar hojas de mostaza o una nueva forma de cocinar el rábano, mezclados con guías de videojuegos y tutoriales de baile. La posición no sigue a las vistas: la primera fila tenía 10 037 740 vistas y la cuarta, 11 988 803.

kuaishou/live_rank devuelve 50 presentadores en directo con una puntuación de popularidad y el título de la emisión. kuaishou/shopping_rank con el tablero products devuelve 50 productos con precio en yuanes, etiquetas de promoción y popularidad. kuaishou/brand_rank devuelve las cuentas en directo de las marcas de una categoría. En nuestras capturas, el tablero de productos y el ranking de marcas de alimentación y bebidas fueron idénticos cada vez. Entre las 10 primeras marcas de alimentación estaban Mixue, el arroz de Wuchang, Want Want, KFC, Moutai, Oreo y Wuliangye, con popularidad de 203 000 a 188 000. En la cuarta captura, a las 01:25, los 50 productos y su orden seguían igual que a las 00:22, y el ranking de marcas de alimentación fue idéntico en las tres primeras capturas. Estos dos rankings no cambiaron en cuatro capturas a lo largo de 63 minutos. No encontramos ninguna nota pública sobre cada cuánto se actualizan, así que una captura al día es una opción prudente.

El tablero de productos también muestra la franja de precios de los más vendidos. La mediana de los 50 productos fue de 39,45 yuanes; el más barato costaba 8,9 yuanes y el más caro, 236. De los 50, 28 costaban menos de 50 yuanes. La promoción más común, 2 yuanes de descuento por cada 12 de compra, aparecía en 17 productos. Por el nombre, unos 30 de los 50 eran alimentos o productos de consumo diario. Para un exportador de fruta, esa es la franja de precio en la que se mueve la venta en directo de Kuaishou.

Coste por cada 1000 filas

El precio por llamada es fácil de leer. Lo difícil es el coste de 1000 filas, porque cada llamada devuelve un número distinto. Lo calculamos con las filas y los cobros reales de todas las llamadas: coste por cada 1000 filas = cobro total ÷ filas devueltas × 1000. Los resultados vacíos se reembolsaron y no cuentan.

La tabla recoge las cuatro cadenas completas y una búsqueda de cuentas: 37 llamadas cobradas. Con una llamada a kuaishou/user_live (0,000806 USD) suman 38 peticiones cobradas por 0,072926 USD. La ejecución adicional del script (9 llamadas, 0,016030 USD) no está en esta tabla.

La búsqueda cuesta diez veces más que un ranking por llamada y más de veinte veces por cada 1000 filas. El coste de los comentarios depende del tamaño de página: 0,16 USD con 10 filas y unos 0,11 USD con 15. El detalle de vídeo devuelve una fila, así que sale a 0,806 USD por cada 1000 vídeos; úselo para completar guardados y enlaces, no para cada fila de búsqueda. El catálogo permite un limit de hasta 100 en la búsqueda y cobra por llamada, así que en muestras grandes un limit mayor baja el coste por 1000 filas; lo que cuenta es el número de filas que llegan.

Ejemplo para exportadores: el aguacate en Kuaishou

México, Perú, Colombia y Chile compiten por vender aguacate Hass en China, y Kuaishou es un buen sitio para ver cómo lo presentan los vendedores y qué responde el público. En la prueba 3 buscamos «aguacate» en chino a las 00:56 hora de Singapur y seguimos la cadena completa. Todo lo que sigue sale de esa única cadena, que costó 0,016030 USD, más una lectura atenta de las 20 filas de búsqueda y las 20 de comentarios.

Hay dos lecturas útiles para un exportador. La primera es de posicionamiento: en esta muestra, el aguacate aparece como alimento saludable, para bebés o para perder peso, más que como ingrediente de cocina. La segunda es de competencia: el Hass peruano ya aparece en el texto de los vendedores, y también un Hass nacional de Yunnan, de modo que «importado» no es el único argumento que circula.

Los comentarios añaden matices. De las 20 filas de comentarios del vídeo elegido, unas 9 dicen que el aguacate no sabe a nada, que sabe a hierba o que tiene un gusto raro; 2 dicen que, maduro y blando, está muy bueno; y 2 recomiendan tomarlo con yogur o con salsa de soja. La lección práctica para una campaña es explicar cuándo está maduro y cómo se come. Estas cifras salen de 20 comentarios de un solo vídeo y valen como pista, no como medida del mercado.

Los comentarios de esta prueba tienen un rasgo que conviene conocer: 13 de las 20 filas eran respuestas, que empiezan por la palabra china que significa «responder», seguida del nombre de otra persona. Si guarda el texto, quite ese prefijo con el nombre antes de almacenarlo, igual que oculta el autor. Leer los 6412 comentarios del vídeo elegido costaría unas 642 páginas, cerca de 1,03 USD.

Ejemplo de otro campo: muestrear a creadores rurales y sus comentarios

Kuaishou celebró su conferencia del ecosistema rural el 2026-10-25. Según un diario local, el informe de la empresa sobre ese ecosistema en 2026 contaba más de 96 000 creadores rurales activos al mes con más de 10 000 seguidores, 1450 millones de reproducciones diarias de contenido rural, más de 200 000 creadores de técnicas agrícolas activos al mes y más de 240 000 usuarios que buscan técnicas agrícolas cada día. Son cifras del propio informe de la plataforma, recogidas por un periódico; no leímos el informe original. Los pasos de abajo dan un método de muestreo para la investigación sobre economía rural, extensión agraria o medios rurales. Describen solo un método y no juzgan a ninguna persona ni cuenta.

El método en seis pasos

1. Haga dos listas de palabras clave: técnicas agrícolas y productos agrícolas. Las técnicas, según la época del año, como la siembra del trigo o la poda invernal de frutales en noviembre; los productos, según región y cultivo, como la manzana Fuji o el arroz de Wuchang. Pase también cada palabra por kuaishou/user_search para ver qué cuentas aparecen.
2. Filtre por ventana de tiempo. Las pruebas mostraron que las palabras de producto traen sobre todo vídeos viejos. Fije la ventana antes, por ejemplo los últimos 30 días o la siembra del 1 de octubre al 30 de noviembre, y guarde aparte lo que quede fuera.
3. Clasifique a los autores y guarde solo un hash. El contenido rural mezcla agricultores particulares, vendedores de insumos y cuentas de medios o instituciones. En la muestra de siembra de trigo, 9 de 20 filas venían de cuentas verificadas y otras 5 tenían nombres de vendedor. Guarde un hash SHA-256 del id del autor, nunca nombres ni avatares.
4. Marque las etiquetas de campañas de la plataforma. En la muestra de siembra de trigo, 6 de 20 filas llevaban etiquetas de campañas; en la de manzana Fuji, 2. Esos vídeos reciben tráfico extra, así que analice sus vistas e interacciones como un grupo aparte.
5. Tome dos páginas de comentarios y agrúpelas por región. Para cada palabra, elija los tres vídeos con más comentarios dentro de la ventana y pida dos páginas de cada uno: de 60 a 90 filas. Guarde solo texto, fecha, región y me gusta, y cuente las regiones por provincia.
6. Añada rankings como contexto: una captura diaria del tablero useful de kuaishou/hot_boards y del tablero products de kuaishou/shopping_rank.

El script de abajo cubre los pasos 2 a 4. Lee el JSON de la búsqueda, filtra por días, aplica un hash al id del autor, asigna un papel sencillo a cada autor y marca las etiquetas de campaña. El resultado es un archivo CSV.

"""Sample kuaishou/search results for agriculture research: time window, hashed author ids, roles, campaign tags.
python sannong_sample.py 30 run1/1_search.json run2/1_search.json > sample.csv"""
import csv, hashlib, json, re, sys
from datetime import datetime, timedelta, timezone

CAMPAIGN = re.compile(r"#(喜爱度激励计划|助农帮帮团|快手助农|光合计划|幸福乡村|快手三农)")  # platform campaign hashtags
SELLER = re.compile(r"农资|种业|农机|机械|播种机|装备|厂|果业|商行|旗舰")  # seller-style words in author names

def rows(path):
    rec = json.load(open(path, encoding="utf-8"))
    kw = rec["request"]["params"]["keyword"]
    for v in rec["response"].get("results") or []:
        yield kw, rec["started_sgt"], v

def main(days, *paths):
    now = datetime.now(timezone.utc)
    w = csv.writer(sys.stdout)
    w.writerow(["keyword", "fetched_sgt", "video_id", "posted_at", "in_window", "author_hash", "author_role",
                "campaign_tag", "has_keyword", "view_count", "like_count", "comment_count", "duration_s"])
    for kw, fetched, v in (r for p in paths for r in rows(p)):
        posted = datetime.fromisoformat(v["posted_at"])
        name, text = v.get("author_name") or "", v.get("text") or ""
        role = "verified" if v.get("author_verified") else ("seller_like" if SELLER.search(name) else "other")
        w.writerow([kw, fetched, v["id"], v["posted_at"][:10], posted >= now - timedelta(days=int(days)),
                    hashlib.sha256(str(v["author_id"]).encode()).hexdigest()[:12],  # no nickname is kept
                    role, bool(CAMPAIGN.search(text)), kw.split()[0] in text,
                    v.get("view_count"), v.get("like_count"), v.get("comment_count"), round((v.get("duration_ms") or 0) / 1000)])

if __name__ == "__main__":
    main(*sys.argv[1:])

Lo ejecutamos sobre las dos búsquedas de las pruebas 1 y 2. «Manzana Fuji» tuvo 1 fila dentro de la ventana de 30 días, 16 autores distintos, 2 filas de campaña y una duración mediana de 8 segundos. «Siembra de trigo» tuvo 18 filas en la ventana, 18 autores distintos, 6 filas de campaña y una duración mediana de 21,5 segundos. Los vídeos de producto son clips breves en el huerto; los de técnica tienen que enseñar un proceso y duran más del doble.

Los precios salen del catálogo leído el 2026-11-14 y la tabla cuenta solo el coste de la API, sin almacenamiento, análisis ni horas de trabajo. En el seguimiento trimestral, el 56 % del dinero va a comentarios, así que el número de páginas de comentarios es lo primero que hay que decidir. Para recortar, elija 3 vídeos por palabra en lugar de 5 y el coste de comentarios baja un 40 %.

El método responde a una pregunta: qué contenido público muestra Kuaishou y qué comentarios públicos recibe. No dice lo que piensan de verdad los agricultores. La búsqueda ordena por relevancia y solo devuelve de 20 a 100 filas, las campañas empujan algunos vídeos, y la región de un comentario es la provincia que la plataforma muestra a partir de la IP, no el domicilio de quien comenta. En un informe, describa el marco de la muestra (palabras clave, ventana de tiempo y horas de captura) y cite los comentarios solo como recuentos o paráfrasis que no permitan llegar a una persona.

Errores y cobros: cuándo no se paga nada

Hacia las 00:33 hora de Singapur hicimos tres pruebas de error a propósito, y ninguna costó nada. Una petición sin clave devolvió 401 con el código missing_key y el aviso de que no se había cobrado nada. Una búsqueda con keywords en lugar de keyword devolvió 422 missing_param, y el cuerpo del error traía una petición de ejemplo que funciona. Una llamada a kuaishou/hot_boards con board igual a sports devolvió 422 invalid_value con los valores permitidos: entertainment, hot, society y useful.

En las pruebas reales, una petición que devolvió 503 no se cobró, y el reintento tras retry_after funcionó. Para tareas programadas y llamadas que se reintentan solas, use la API REST con la cabecera Idempotency-Key; nuestra guía sobre claves de idempotencia y reintentos de agentes de IA explica cómo. Para cuadrar cobros y reembolsos en su propia contabilidad, lea nuestra guía de conciliación de reembolsos por fallo.

Kuaishou en los tres últimos meses

Un plan de datos tiene que seguir a la plataforma. La tabla recoge hechos de Kuaishou relevantes para quien trabaja con datos desde agosto de 2026, con las fechas de las fuentes originales.

Los resultados del tercer trimestre salen el 2026-11-19 y entonces volveremos a revisar las cifras de usuarios. Para quien trabaja con datos, el cambio más directo es el rediseño web de principios de noviembre, tras el cual el issue #84 de KS-Downloader describe fallos en el detalle de vídeo. Por nuestra parte, kuaishou/video devolvió vistas, me gusta, comentarios y guardados en las cuatro cadenas del 2026-11-14.

Cuándo encajan mejor las otras dos vías

Si los usuarios deben iniciar sesión en su aplicación con Kuaishou y ver su lista de vídeos y sus cifras, o si su aplicación comparte vídeos en Kuaishou por ellos, use la plataforma abierta: ninguna API de terceros debe hacer eso por usted. Para gestionar su propia tienda, productos y posventa en Kuaishou, use la plataforma de comercio electrónico; para sus cuentas e informes publicitarios, la API de marketing. Todas leen datos sobre los que usted ya tiene derechos.

Un script abierto también tiene su sitio. Quizá necesite una descarga única de unos cientos de vídeos públicos para una clase o una tesis, tenga una tarde para preparar el entorno y la sesión, y la licencia permita ese uso; o quizá un proyecto ya analice justo el campo que busca. Pero si sigue a diario decenas de palabras clave y rankings, y nadie en su equipo puede reparar analizadores tras cada rediseño, una API de pago por llamada pide menos esfuerzo y deja una factura previsible.

La misma serie tiene guías de Douyin, Bilibili y Weibo. Compare capacidades y precios en las páginas de la API de datos de Kuaishou, Douyin, Bilibili y Weibo.

Límites legales

Las tres vías comparten el mismo suelo legal. La Ley de Protección de Información Personal de China, en su artículo 27, permite tratar dentro de lo razonable la información personal que una persona hizo pública o que se publicó legalmente, salvo que esa persona se oponga de forma clara; si el tratamiento afecta de manera importante a sus derechos, hace falta su consentimiento. Según la definición del artículo 4 de esa ley, el nombre, el avatar, la región y las palabras de quien comenta pueden ser información personal; la valoración final corresponde a su asesoría jurídica.

La Ley contra la Competencia Desleal, revisada en 2025 y vigente desde el 2025-10-15, dice en el párrafo 3 del artículo 13 que una empresa no puede obtener ni usar datos que otra empresa posee legalmente mediante fraude, coacción o eludiendo o rompiendo medidas técnicas de gestión. El Reglamento de Gestión de la Seguridad de los Datos de Red, vigente desde el 2025-01-01, fija en su artículo 18 obligaciones para las herramientas automáticas que acceden a datos de red o los recogen: no pueden entrar ilegalmente en redes ajenas ni alterar el funcionamiento normal del servicio.

En esta guía seguimos ese suelo. Leemos solo vídeos, comentarios y rankings públicos; no iniciamos sesión en ninguna cuenta de Kuaishou ni tocamos mensajes privados o contenido solo para seguidores. Ocultamos los nombres de autores y comentaristas particulares y nombramos solo instituciones y marcas. El script de muestreo aplica un hash al id del autor y no guarda nombres ni avatares. Esta guía no enseña a sortear los límites de la plataforma; citamos las notas de los proyectos abiertos sobre sesiones y controles solo para mostrar el coste de mantener esa vía.

Preguntas frecuentes

¿Hay una kuaishou api oficial y puede pedirla un particular?

Sí, la plataforma abierta de Kuaishou es la kuaishou api oficial, pero el alta pide datos de la empresa, del representante legal y del administrador, más una revisión, y no encontramos una vía para particulares. Tras el alta se leen el perfil público y los vídeos propios del usuario que autoriza. La documentación no tiene endpoints para buscar por palabra clave, leer comentarios de vídeos ajenos ni consultar rankings.

¿La API de Kuaishou es lo mismo que la API de Kling?

No. Kling es el producto de generación de vídeo con IA de Kuaishou; su documentación está en kling.ai y cobra por vídeo generado. Sirve para convertir texto o imágenes en vídeo, no para obtener vídeos, comentarios ni rankings de Kuaishou. Para datos públicos de Kuaishou, use una de las tres vías de esta guía.

¿Existe un dataset público de Kuaishou?

Hay dos datasets académicos. KuaiRec (arXiv:2202.10842) es un conjunto para sistemas de recomendación con una matriz de interacciones totalmente observada de 1411 usuarios. KuaiRand (arXiv:2208.08696) añade vídeos expuestos al azar para estudiar sesgos de recomendación. Ambos contienen interacciones anonimizadas entre usuarios y vídeos, sin textos ni comentarios, y sirven para investigar recomendadores; para estudiar contenido y comentarios necesita su propia muestra.

¿Se puede buscar en la API de Kuaishou en español?

La búsqueda funciona sobre el contenido de Kuaishou en China continental, que está en chino. Una palabra en español devuelve pocos resultados útiles. Traduzca primero sus términos al chino: aguacate, cereza o vino tienen nombres comerciales en chino que son los que usan los vendedores y los compradores. Esta guía muestra las palabras en español solo para facilitar la lectura.

¿Se puede hacer sin programar?

Sí. Puede conectar la misma clave a nuestro servidor MCP y pedir a un asistente de IA compatible con MCP que busque en Kuaishou vídeos recientes sobre la siembra de trigo y que traiga dos páginas de comentarios del más comentado. En esta guía no probamos la vía MCP. Para tareas programadas y llamadas que se reintentan, recomendamos la API REST con la cabecera Idempotency-Key.

Primeros pasos

1. Cree una clave de API en la consola y guárdela en la variable de entorno EVERYINFRA_API_KEY; los pasos están en la guía rápida.
2. Lea gratis el catálogo GET /api/v1/social/catalog?platform=kuaishou para confirmar parámetros, precios y disponibilidad; también puede ver los precios en la página de precios y en el mercado de datos.
3. Ejecute pip install requests, copie el script de la cadena y ejecute python kuaishou_chain.py "su palabra clave" run1.
4. Abra los JSON de la carpeta run1 y compare billing.charged_usd con el precio del catálogo; para paginar comentarios, devuelva next_page_token tal cual.
5. Para muestras rurales o de otro sector, pase sannong_sample.py para filtrar la ventana de tiempo y aplicar el hash a los id de autor antes de contar nada.

Páginas de parámetros de cada capacidad: kuaishou/search, kuaishou/video, kuaishou/comments, kuaishou/user_search, kuaishou/trending, kuaishou/hot_boards, kuaishou/live_rank, kuaishou/shopping_rank, kuaishou/brand_rank.

Referencias

1. Plataforma abierta de Kuaishou, «Introducción de la plataforma», actualizada el 2024-09-06, leído el 2026-11-14, https://open.kuaishou.com/platformDocs/newGuide/introduce.html
2. Plataforma abierta de Kuaishou, «Alta de desarrolladores», actualizada el 2026-03-06, leído el 2026-11-14, https://open.kuaishou.com/platformDocs/newGuide/entry.html
3. Plataforma abierta de Kuaishou, «Registro de aplicaciones», actualizada el 2026-03-06, leído el 2026-11-14, https://open.kuaishou.com/platformDocs/newGuide/login.html
4. Plataforma abierta de Kuaishou, «Inicio de sesión con Kuaishou», actualizada el 2024-07-23, leído el 2026-11-14, https://open.kuaishou.com/platformDocs/openAbility/kwaiLogin
5. Plataforma abierta de Kuaishou, «Información pública del usuario», leído el 2026-11-14, https://open.kuaishou.com/platformDocs/openAbility/userInformation/publicInformation.html
6. Plataforma abierta de Kuaishou, «Consulta de vídeos», actualizada el 2024-12-23, leído el 2026-11-14, https://open.kuaishou.com/platformDocs/openAbility/contentManagement/searchForVideos.html
7. Plataforma abierta de Kuaishou, «Aplicaciones web», actualizada el 2024-11-14, leído el 2026-11-14, https://open.kuaishou.com/platformDocs/develop/web-app
8. Plataforma abierta de Kuaishou, «SDK de servidor», leído el 2026-11-14, https://open.kuaishou.com/platformDocs/develop/serverSDK
9. Plataforma abierta de Kuaishou, «Integración en Android», leído el 2026-11-14, https://open.kuaishou.com/platformDocs/develop/mobile-app/android.html
10. Plataforma abierta de Kuaishou, «Preguntas frecuentes», actualizada el 2024-08-26, leído el 2026-11-14, https://open.kuaishou.com/platformDocs/other/commonProblem
11. Plataforma abierta de Kuaishou, «Acuerdo de servicio de miniprogramas», actualizada el 2025-09-22, leído el 2026-11-14, https://open.kuaishou.com/docs/operate/platformAgreement/agreement.html
12. Plataforma abierta de Kuaishou, «Requisitos de cualificación de minijuegos», leído el 2026-11-14, https://open.kuaishou.com/miniGameDocs/operation/specification/qualifications.html
13. Plataforma abierta de Kuaishou, «Guía de alta de minijuegos», leído el 2026-11-14, https://open.kuaishou.com/miniGameDocs/gameIntroduction/entryGuide.html
14. Plataforma abierta de comercio electrónico de Kuaishou, documentación para desarrolladores, leído el 2026-11-14, https://open.kwaixiaodian.com/zone/new/docs/dev?pageSign=e1d9e229332f4f233a04b44833a5dfe71614263940720
15. Plataforma abierta de comercio electrónico de Kuaishou, portada, leído el 2026-11-14, https://open.kwaixiaodian.com/
16. Centro de desarrolladores de publicidad de Kuaishou, documentación, leído el 2026-11-14, https://developers.e.kuaishou.com/docs
17. Centro de desarrolladores de publicidad de Kuaishou, registro de cambios, leído el 2026-11-14, https://developers.e.kuaishou.com/tools/logs
18. Índice de Kuaishou, acuerdo de usuario, vigente desde 2023-06-01, leído el 2026-11-14, https://index.e.kuaishou.com/m/userAgreement
19. Kuaishou, robots.txt, leído el 2026-11-14, https://www.kuaishou.com/robots.txt
20. Kuaishou, acuerdo de usuario y política de privacidad, leído el 2026-11-14, https://www.kuaishou.com/about/policy
21. Relación con inversores de Kuaishou, "Kuaishou Technology announces second quarter and interim 2026 results", 2026-08-19, https://ir.kuaishou.com/news-releases/news-release-details/kuaishou-technology-announces-second-quarter-and-interim-2026
22. PR Newswire, "Kuaishou Technology to report 2026 third quarter financial results on 2026-11-19", 2026-11-06, https://www.prnewswire.com/news-releases/kuaishou-technology-to-report-2026-third-quarter-financial-results-on-november-19-2026-302931918.html
23. PR Newswire, "Kuaishou Technology announces second quarter and interim 2026 unaudited financial results", 2026-08-19, https://www.prnewswire.com/news-releases/kuaishou-technology-announces-second-quarter-and-interim-2026-unaudited-financial-results-302855081.html
24. Sohu, crónica de la conferencia rural de Kuaishou 2026 (en chino), 2026-10-25, https://www.sohu.com/a/1093340526_355158
25. CCTV News, la siembra del trigo de invierno supera el 80 % (en chino), 2026-11-11, https://news.cctv.com/2026/11/11/ARTIRbFL7fRE9sXRzp8flmOu261111.shtml
26. GitHub, MediaCrawler README, leído el 2026-11-14, https://github.com/NanmiCoder/MediaCrawler
27. GitHub, MediaCrawler LICENSE, leído el 2026-11-14, https://github.com/NanmiCoder/MediaCrawler/blob/main/LICENSE
28. GitHub, MediaCrawler issue #808, 2026-01-10, https://github.com/NanmiCoder/MediaCrawler/issues/808
29. GitHub, MediaCrawler issue #843, 2026-03-09, https://github.com/NanmiCoder/MediaCrawler/issues/843
30. GitHub, MediaCrawler solicitud de cambios #917, 2026-06-15, https://github.com/NanmiCoder/MediaCrawler/pull/917
31. GitHub, MediaCrawler issue #954, 2026-08-06, https://github.com/NanmiCoder/MediaCrawler/issues/954
32. GitHub, KS-Downloader README, leído el 2026-11-14, https://github.com/JoeanAmier/KS-Downloader
33. GitHub, KS-Downloader issue #84, 2026-11-02, https://github.com/JoeanAmier/KS-Downloader/issues/84
34. GitHub, KuaiShou-Spider, leído el 2026-11-14, https://github.com/cv-cat/KuaiShou-Spider
35. GitHub, lxSpider, leído el 2026-11-14, https://github.com/lixi5338619/lxSpider
36. GitHub, kuaishou-crawler, leído el 2026-11-14, https://github.com/oGsLP/kuaishou-crawler
37. GitHub, recopilación de casos judiciales chinos sobre rastreadores, leído el 2026-11-14, https://github.com/HiddenStrawberry/Crawler_Illegal_Cases_In_China
38. GitHub Docs, "Licensing a repository", leído el 2026-11-14, https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/licensing-a-repository
39. Administración Nacional de Propiedad Intelectual de China, Ley contra la Competencia Desleal (revisión de 2025, en chino), https://www.cnipa.gov.cn/art/2026/5/20/art_104_206437.html
40. Administración del Ciberespacio de China, Ley de Protección de Información Personal (en chino), https://www.cac.gov.cn/2021-08/20/c_1631050028355286.htm
41. Reglamento de Gestión de la Seguridad de los Datos de Red, vigente desde 2025-01-01 (en chino), https://www.mee.gov.cn/zcwj/gwywj/202410/t20241003_1087417.shtml
42. Gao et al., "KuaiRec: A Fully-observed Dataset and Insights for Evaluating Recommender Systems", arXiv:2202.10842, https://arxiv.org/abs/2202.10842
43. Gao et al., "KuaiRand: An Unbiased Sequential Recommendation Dataset with Randomly Exposed Videos", arXiv:2208.08696, https://arxiv.org/abs/2208.08696
44. Kling AI, resumen de la documentación de la API, leído el 2026-11-14, https://kling.ai/document-api/guides/get-started/overview
45. Kling AI, página para desarrolladores, leído el 2026-11-14, https://kling.ai/dev
46. EveryInfra, catálogo de capacidades de Kuaishou (precios, parámetros, disponibilidad), leído el 2026-11-14 a las 00:14, hora de Singapur, https://api.everyinfra.com/api/v1/social/catalog?platform=kuaishou
47. Documentación de Python, hashlib, https://docs.python.org/3/library/hashlib.html
48. Documentación de Python, csv, https://docs.python.org/3/library/csv.html
49. Documentación de Requests, objetos Session, https://requests.readthedocs.io/en/latest/user/advanced/#session-objects