kwai/
profile

Obtenga un perfil público de Kwai por nombre de usuario o URL de perfil admitida, con identidad, imágenes de perfil, indicadores de cuenta, conteos visibles y contexto de recopilación normalizados.

Kwai Profile API

Nombre de usuario o URL de perfil
Identidad de perfil normalizada
Tarea fija de 0.19 créditos
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 Profile

Los perfiles de Kwai son páginas de cuenta públicas con nombres de usuario, nombres visibles, biografías, imágenes de perfil, sitios web, indicadores de cuenta y los conteos visibles de seguidores, seguidos y publicaciones. Estos datos de identidad y señales de un momento dado sirven para enriquecer perfiles, comparar cuentas y monitorear instantáneas repetidas.

Funcionalidades de la Kwai Profile API

  • Dos identificadores admitidosResuelve un perfil público a partir de un nombre de usuario válido, de una URL de perfil de kwai.com o kwai-video.com, o de ambos identificadores en la misma tarea.
  • Identidad pública normalizadaDevuelve el ID del perfil, la URL de origen, el nombre de usuario, el nombre visible, el texto de la biografía, el avatar, la imagen de portada y el sitio web en un registro de cuenta coherente.
  • Señales de la cuenta con hora de observaciónMantiene juntos, como instantánea del perfil en un momento dado, los indicadores de verificación y privacidad disponibles, los conteos visibles de seguidores, seguidos y publicaciones, y collected_at.

Parámetros de la Kwai Profile API

ParámetrosObligatorioDescripción
usernameObligatorio (al menos uno)Se requiere username o url. Un nombre de usuario puede comenzar con @, seguido de 1 a 64 letras ASCII, números, puntos, guiones bajos o guiones.
urlObligatorio (al menos uno)Se requiere url o username. La referencia, no vacía, debe analizarse como un nombre de host de kwai.com, kwai-video.com o un subdominio de cualquiera de los dos. Se acepta cualquier esquema cuando hay una autoridad y un nombre de host; también se aceptan las referencias relativas al protocolo.

Cómo usar la Kwai Profile API

Envíe un identificador admitido, siga la tarea asíncrona y lea el registro normalizado del perfil en la página de resultados almacenada.

  1. Prepare un nombre de usuario válido o una referencia de perfil de Kwai cuyo nombre de host analizado sea kwai.com, kwai-video.com o un subdominio de cualquiera de los dos.
  2. Envíe username, url o ambos a /v1/kwai/profile y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea tenga éxito o devuelva un error.
  4. Lea el perfil en data.results.items y siga next_cursor solo si has_more es true.
curl -X POST "https://api.socq.ai/v1/kwai/profile" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.kwai.com/@ShortShortz8"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor only while has_more is true

Casos de uso de la Kwai Profile API

  • Enriquecimiento de registros de perfil: Agregue la identidad pública normalizada, las imágenes de perfil, el sitio web, los indicadores de cuenta y la URL de origen a un registro vinculado a una cuenta de Kwai conocida.
  • Comparación de cuentas visibles: Compare los conteos disponibles de seguidores, seguidos y publicaciones entre perfiles seleccionados sin tratar los valores como totales en tiempo real.
  • Monitoreo de instantáneas de perfil: Almacene los resultados repetidos con collected_at para seguir a lo largo del tiempo los cambios en los campos de identidad pública, los indicadores de cuenta y los conteos visibles.

Consejos de expertos para la Kwai Profile API

  • Proporcione al menos un identificador. Cuando están presentes username y url, el backend reenvía ambos y no elige uno por usted.
  • Valide los nombres de usuario con ^@?[A-Za-z0-9._-]{1,64}$ y exija que el nombre de host de la URL analizada sea kwai.com, kwai-video.com o un subdominio antes del envío.
  • Trate la biografía, el avatar, la imagen de portada, el sitio web, los indicadores de cuenta y cada métrica como opcionales, porque un perfil público puede exponer solo una parte del esquema.
  • Use id como clave principal de deduplicación, recurra a url cuando sea necesario y conserve collected_at junto a cada instantánea de métricas de un momento dado.

Además de la Kwai Profile API, use estas APIs cuando necesite otro tipo de datos públicos de Kwai.

  • 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.
  • Kwai Post API — Convierte la URL de una publicación pública conocida de Kwai en contenido normalizado, autor, contenido multimedia, marcas de tiempo, entidades y campos de interacción visible.

Explorar otras plataformas

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

Kwai Profile API — FAQ

Kwai Profile API es una interfaz programática para obtener un perfil público de Kwai por nombre de usuario o URL de perfil admitida. Devuelve la identidad, las imágenes de perfil, los indicadores de cuenta, los conteos visibles y el contexto de recopilación normalizados, cuando están disponibles.

Envíe username, url o ambos. Un nombre de usuario puede tener una @ inicial seguida de 1 a 64 letras ASCII, números, puntos, guiones bajos o guiones. Una referencia URL debe analizarse como kwai.com, kwai-video.com o un subdominio; se acepta cualquier esquema con autoridad y nombre de host, además de las referencias relativas al protocolo.

Un resultado puede incluir el ID, la URL de origen, el nombre de usuario, el nombre visible, el texto de la biografía, el avatar, la imagen de portada, el sitio web, los indicadores de verificación y privacidad, los conteos visibles de seguidores, seguidos y publicaciones, y la hora de recopilación.

No. Una tarea resuelve un perfil y la solicitud no tiene results_limit. El lector de resultados almacenados sigue exponiendo items, next_cursor y has_more según el contrato común de resultados asíncronos.

Cada tarea exitosa de Kwai Profile cuesta una tarifa fija de 0.19 créditos de SocQ. El cargo no varía con la cantidad de campos ni de elementos de resultado.