Douyin User Profile
Los perfiles de usuario de Douyin son espacios de cuenta públicos con identidad, biografía, imágenes de perfil y señales de verificación y privacidad, además de los conteos visibles de seguidores, seguidos y publicaciones. Estos campos sirven para enriquecer cuentas, verificar identidades, monitorear instantáneas y comparar perfiles en una investigación.
Funcionalidades de la Douyin User Profile API
- Dos identificadores compatiblesResuelve un perfil público a partir de una URL de usuario de Douyin compatible o de un user_id que cumpla la regla de identificadores del entorno de ejecución.
- Identidad y presentación del perfilDevuelve el ID del perfil, la URL pública, el nombre de usuario, el nombre visible, la biografía, el avatar, la imagen de portada y el sitio web asociado disponibles en un único registro de cuenta.
- Campos explícitos del estado de la cuentaConserva los indicadores disponibles de verificación y privacidad como valores que pueden ser nulos, en lugar de inferir un estado cuando la fuente pública lo omite.
- Mediciones visibles del perfilNormaliza los conteos disponibles de seguidores, seguidos y publicaciones junto con collected_at, para tener una vista del perfil público en un momento determinado.
Parámetros de la Douyin User Profile API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
url | Obligatorio (al menos uno) | Indique url o user_id. Una URL no vacía debe usar douyin.com, iesdouyin.com o un subdominio e incluir una ruta /user/<identifier>. |
user_id | Obligatorio (al menos uno) | Indique user_id o url. user_id acepta de 1 a 256 letras ASCII, números, dos puntos, guiones bajos o guiones, y tiene prioridad si se envían ambos campos. |
Cómo usar la Douyin User Profile API
Envíe un identificador de perfil compatible, siga la tarea asíncrona y lea la cuenta normalizada en el contenedor de resultados almacenados.
- Prepare una URL completa de perfil de Douyin con una ruta /user/<identifier> o un user_id público compatible.
- Envíe por POST un identificador a /v1/douyin/user-profile y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que el estado sea succeeded o failed.
- Lea data.results.items tras el éxito; la consulta a la fuente produce como máximo un perfil, aunque el contenedor de resultados almacenados sigue informando has_more y next_cursor.
curl -X POST "https://api.socq.ai/v1/douyin/user-profile" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"user_id\":\"${DOUYIN_USER_ID}\"}"
# Poll GET /v1/tasks/{task_id}
# Read the normalized account from data.results.itemsCasos de uso de la Douyin User Profile API
- Enriquecimiento de registros de creadores de contenido: Agregue la identidad, la biografía, las imágenes, el sitio web, los indicadores de cuenta y los conteos públicos de Douyin disponibles a un registro de creador de contenido existente.
- Verificación de identidad de perfiles: Convierta una URL de perfil o un identificador de usuario conocidos en un objeto de cuenta consistente antes de vincularlo a una entidad interna.
- Comparación de cuentas públicas: Compare los conteos de seguidores, seguidos y publicaciones entre perfiles recopilados por separado, con las mismas claves de métricas normalizadas.
- Monitoreo de instantáneas de perfil: Almacene los campos de identidad y las métricas públicas con collected_at para que las tareas posteriores sigan siendo observaciones distinguibles en momentos concretos.
Consejos de expertos para la Douyin User Profile API
- Cuando ya cuente con un identificador de usuario canónico, envíe solo user_id; si url y user_id no coinciden, la solicitud al proveedor usa user_id.
- Antes de enviar una URL, verifique su nombre de host y exija una ruta /user/<identifier>, para que los enlaces a videos o a otros recursos de Douyin se rechacen de forma local.
- Espere cero o un registro de perfil de la fuente; el cursor del lector de tareas pagina los elementos guardados de SocQ y no puede solicitar otra página al proveedor en esta consulta.
- Trate la identidad, las imágenes, el sitio web, los indicadores de cuenta, la ubicación y cada métrica como valores que pueden ser nulos, y conserve collected_at al comparar instantáneas repetidas.
APIs relacionadas
Además de la Douyin User Profile API, use estas APIs cuando necesite otro tipo de datos públicos de Douyin.
- Douyin Live Room Detail API — Obtiene una transmisión en vivo conocida de Douyin por ID numérico de sala, con contexto normalizado de la sala, identidad del anfitrión, contenido multimedia y conteos visibles de audiencia.
- Douyin User Videos API
- Douyin Video Comments API
- Douyin Video Detail API
- Douyin Video Search API