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ámetros | Obligatorio | Descripción |
|---|---|---|
username | Obligatorio (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. |
url | Obligatorio (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.
- 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.
- Envíe username, url o ambos a /v1/kwai/profile y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que la tarea tenga éxito o devuelva un error.
- 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 trueCasos 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.
APIs relacionadas
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.