douyin/
user-profile

Obtenga un perfil público de Douyin a partir de una URL de perfil compatible o de un identificador de usuario, con identidad, biografía, imágenes, indicadores de cuenta y conteos visibles normalizados.

Douyin User Profile API

URL o ID de usuario
Un solo perfil público
Campos de cuenta normalizados
0.1 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

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ámetrosObligatorioDescripción
urlObligatorio (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_idObligatorio (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.

  1. Prepare una URL completa de perfil de Douyin con una ruta /user/<identifier> o un user_id público compatible.
  2. Envíe por POST un identificador a /v1/douyin/user-profile y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que el estado sea succeeded o failed.
  4. 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.items

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

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

Explorar otras plataformas

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

Douyin User Profile API — FAQ

Douyin User Profile API obtiene una cuenta pública de Douyin a partir de una URL de perfil compatible o de un identificador de usuario, y devuelve identidad, biografía, imágenes, indicadores de cuenta, conteos visibles y momento de recopilación normalizados.

Cualquiera de los dos campos cumple el requisito de la solicitud. Envíe solo el identificador que desea resolver, porque user_id tiene prioridad cuando ambos valores están presentes.

El nombre de host analizado debe ser douyin.com, iesdouyin.com o un subdominio, y la ruta debe contener /user/ seguido de un identificador formado por letras, números, guiones bajos o guiones. Los enlaces a videos y los hosts no relacionados se rechazan.

El esquema de cuenta puede contener ID y URL del perfil, nombre de usuario, nombre visible, biografía, avatar, imagen de portada, sitio web, indicadores de verificación y privacidad, ubicación, cantidad de seguidores, cantidad de seguidos, cantidad de publicaciones y collected_at. Los campos públicos opcionales quedan en null cuando no hay un valor disponible.

No. La consulta al proveedor es una solicitud de un solo detalle que produce como máximo un perfil de origen; next_cursor y has_more solo describen la paginación sobre los resultados que SocQ ya almacenó.

Cada tarea exitosa tiene un costo fijo de 0.10 créditos de SocQ. El cargo no depende de cuántos campos opcionales del perfil estén completos.