API de Resumen de una cuenta de Douyin

No disponible temporalmente

Estamos restableciendo esta capacidad. Mientras tanto, las llamadas suelen fallar o no devolver resultados; las llamadas fallidas y los resultados vacíos no se cobran.

POST

Salud de la API

Salud 24 h
No disponible temporalmente
  • Saludable / normal
  • Disponible
  • Limitada
  • Casi sin servicio
No disponible temporalmente

Últimas 24 horas

Últimos 30 días

Obtén un resumen de una cuenta de Douyin a partir de su secUid en user_id (una cadena MS4w) o de un enlace https://www.douyin.com/user/<secUid>; no se aceptan apodos, Douyin ID ni enlaces cortos. Recibes un objeto con los campos del perfil (apodo, Douyin ID, biografía, contadores de seguidores, seguidos, «me gusta» y vídeos, verificación, avatar) y estadísticas de las publicaciones recientes de la cuenta: recent_post_count (unas 20, fijadas incluidas), recent_media_types, recent_stats (media, mediana y máximo de «me gusta», comentarios, compartidos y guardados), posts_per_week, newest_post_at, oldest_post_at, top_posts por «me gusta» y las propias recent_posts. Las estadísticas cubren las publicaciones de la primera página del perfil, así que no incluyen lo publicado en los últimos 7 días, más o menos; newest_post_at indica la publicación más reciente incluida.

Envía POST https://api.everyinfra.com/api/v1/social con platform igual a douyin y action igual a user_overview. Precio $1.6 por 1.000 solicitudes ($0.001597 por llamada). Las llamadas fallidas y los resultados vacíos no se cobran. Síncrona. Para tareas lentas añade "mode": "async" al cuerpo, recibe un job_id y consúltalo.

Prompt para IA

#
Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra Douyin: Resumen de una cuenta (douyin/user_overview).

Cómo funciona el endpoint:
- Solicitud: POST https://api.everyinfra.com/api/v1/social con la cabecera Authorization: Bearer <clave API>. Lee la clave de la variable de entorno EVERYINFRA_API_KEY y no la escribas en el código.
- En el cuerpo de la solicitud, pon platform en douyin y action en user_overview, y los parámetros dentro de params.
- Parámetros obligatorios:
  - user_id: La cuenta que quieres resumir: su secUid (empieza por MS4w) o un enlace de perfil https://www.douyin.com/user/<secUid>. No se aceptan apodos, Douyin ID ni enlaces cortos.
- Devuelve un objeto. Campos principales: user_id, douyin_id (Douyin ID: el identificador buscable qu…), nickname (Nombre visible de la cuenta), bio, url, follower_count, following_count, like_count, video_count (Número de videos: los de la cuenta en p…), is_verified, avatar_url, recent_post_count (Cuántas publicaciones recientes usan la…); 19 campos en total, lista completa en https://api.everyinfra.com/api/v1/social/catalog?platform=douyin.
- Cuerpo de solicitud de ejemplo:
{
  "platform": "douyin",
  "action": "user_overview",
  "params": {
    "user_id": "https://www.douyin.com/user/MS4wLjABAAAAk1tZ-L085zZf2yW_H5dnVFZWyk8Rt8v4RAvf9KhTyPoVdMDxTs7Q_rvgTJGWXezS"
  }
}
- Precio: $1.6 por 1.000 solicitudes; los resultados fallidos y vacíos no se cobran.
- Para decenas o cientos de objetivos, añade "mode": "async" al cuerpo: recibes un job_id al instante y consultas GET https://api.everyinfra.com/api/v1/jobs/{job_id} para obtener el resultado.
- Ante un 422, corrige la solicitud con los nombres de parámetros y los valores admitidos que sugiere el error; ante un 429 o un 503, espera lo que indique Retry-After y vuelve a intentarlo.

Antes de escribir código, pregúntame qué objetivos necesito, cuántos, qué campos y en qué formato quiero el resultado; luego confirma conmigo el plan y el coste aproximado.

Parámetros de la solicitud

#
NombreUbicaciónTipoObligatorioPor defectoDescripción
AuthorizationheaderstringSí-Bearer seguido de tu clave de API. Créala en la consola; nunca la pongas en una URL ni en un repositorio de código.
platformbodystringSídouyinIdentificador de la plataforma, valor fijo.
actionbodystringSíuser_overviewIdentificador de la capacidad, valor fijo.
user_idbody.paramsstringSí-La cuenta que quieres resumir: su secUid (empieza por MS4w) o un enlace de perfil https://www.douyin.com/user/<secUid>. No se aceptan apodos, Douyin ID ni enlaces cortos.

Ejemplos de código

#
bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "douyin",
  "action": "user_overview",
  "params": {
    "user_id": "https://www.douyin.com/user/MS4wLjABAAAAk1tZ-L085zZf2yW_H5dnVFZWyk8Rt8v4RAvf9KhTyPoVdMDxTs7Q_rvgTJGWXezS"
  }
}'

Definición OpenAPI (JSON)Los ejemplos leen la clave de la variable de entorno EVERYINFRA_API_KEY; el código copiado nunca contiene tu clave.

Ejemplo de respuesta

#
Todavía no hay una muestra real para estos parámetros de ejemplo: se muestra la estructura de la respuesta y sus campos según la definición de la API, con … como marcadores. No es el resultado de una llamada real.
json
{  "id": "req_…",  "platform": "douyin",  "action": "user_overview",  "results": {    "user_id": …,    "douyin_id": …,    "nickname": …,    "bio": …,    "url": …,    "follower_count": …,    "following_count": …,    "like_count": …,    "video_count": …,    "is_verified": …,    "avatar_url": …,    "platform": …,    "recent_post_count": …,    "recent_media_types": …,    "recent_stats": …,    "posts_per_week": …,    "newest_post_at": …,    "oldest_post_at": …,    "top_posts": …,    "recent_posts": …  },  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

Campos de la respuesta

#

Los datos están en results. La tabla lista los campos que puede tener cada registro; los valores que la plataforma no muestra nunca se inventan.

CampoSignificado
user_idIdentificador único del usuario en la plataforma.
douyin_idDouyin ID: el identificador buscable que elige el titular de la cuenta.
nicknameNombre visible de la cuenta.
bioBiografía escrita por la cuenta; puede incluir saltos de línea y emoji.
urlEnlace al registro en la plataforma.
follower_countSeguidores. null significa no publicado, no 0.
following_countCuentas seguidas. null significa no publicado, no 0.
like_countMe gusta. null significa que la plataforma o esta capacidad no lo publica; no es 0.
video_countNúmero de videos: los de la cuenta en profile, profiles_batch, user_overview y billboard_account_search, y los relacionados con la entrada en trending.
is_verifiedSi la plataforma verificó la cuenta. null significa que no se puede determinar.
avatar_urlEnlace a la imagen de perfil. Algunas plataformas dan enlaces de CDN con tamaño que pueden caducar.
platformIdentificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok).
recent_post_countCuántas publicaciones recientes usan las estadísticas (user_overview), unas 20, fijadas incluidas.
recent_media_typesNúmero de publicaciones recientes por tipo (user_overview), como {"video": 22}.
recent_statsInteracción de las publicaciones recientes (user_overview): like_count, comment_count, share_count y collect_count, cada uno como {avg (media), median (mediana), max (máximo)}.
posts_per_weekPromedio de publicaciones por semana en la muestra reciente (user_overview).
newest_post_atFecha de publicación de la más reciente de la muestra (user_overview, ISO 8601, UTC); lo publicado en los últimos 7 días, más o menos, no entra en la muestra.
oldest_post_atFecha de publicación de la más antigua de la muestra (user_overview, ISO 8601, UTC).
top_postsLas publicaciones recientes con más «me gusta» (user_overview): [{id, title, like_count, url}].
recent_postsLas publicaciones recientes (user_overview); cada una tiene los mismos campos que una fila de user_posts.

Errores y facturación

#
401
Falta la clave o no es válida.
402
Saldo insuficiente. Recarga primero.
422
Nombre o valor de parámetro incorrecto. Corrígelo según las opciones indicadas en el error. Sin cargo.
429
Se alcanzó el límite de solicitudes por minuto. Espera el tiempo indicado en Retry-After y vuelve a intentarlo.
503
No se pudo completar. El cargo retenido vuelve a tu saldo. Si el resultado es incierto, compruébalo antes de reenviar.
200 vacío
Sin datos. Sin cargo.

Errores

Google Analytics solo si aceptas. Privacidad