API de Reconocimiento de enlaces de Douyin

Pasa un texto (un texto de compartir completo, por ejemplo) como text y encuentra dentro los enlaces e IDs de videos, usuarios, música, colecciones y salas en vivo de Douyin; cada uno encontrado es una fila, por $0.79 por cada 1000 llamadas.

  • resource_type indica de qué tipo es, y resource_id puede ir directo al endpoint correspondiente.
  • needs_expansion es true para un enlace corto que aún no se ha expandido.
  • Las llamadas fallidas y los resultados vacíos no se cobran.

Salud de la API

Salud 24 h
Normal
  • Saludable / normal
  • Disponible
  • Limitada
  • Casi sin servicio
Normal

Últimas 24 horas

Últimos 30 días

  1. 1Solicitud

    POST /api/v1/social
    {
      "platform": "douyin",
      "action": "resolve_links",
      "params": {
        "text": "https://www.douyin.com/video/7539330955225484584"
      }
    }
  2. 2Respuesta JSON

    {
      "results": [
        {
          "matched_text": …,
          "match_type": …,
          "resource_type": …,
          "resource_id": …
        },
        …
      ]
    }
  3. 3Filas

    matched_textmatch_typeresource_typeresource_id
    …………
  4. 4CSV

    douyin-resolve_links-sample.csv matched_text,match_type,resource_type,resource_id,handle,url,needs_expansion,id_created_at,platform

Entra una solicitud con text y sale cada enlace o ID encontrado; cada fila de results es uno, y se muestra como tabla de campos y se puede descargar en CSV.

Qué datos obtienes

Este endpoint aún no tiene una muestra real pública. La tabla lista los campos, tipos y significados que devuelve cada fila, sin valores.

CampoTipoSignificado
matched_text—El fragmento exacto del texto que coincidió (resolve_links).
match_type—Cómo aparece la coincidencia en el texto (resolve_links): link para un enlace, id para un ID suelto, etc.
resource_type—Qué es lo reconocido (resolve_links): video, user, music, mix para una colección, live para una sala en directo, y otros.
resource_id—ID del elemento reconocido (resolve_links): ID de vídeo, secUid, ID de música, etc., listo para enviarlo a la acción correspondiente.
handle—El Douyin ID o el nombre cuando la coincidencia es un usuario (resolve_links); no aparece en los demás casos.
urlstringEnlace al registro en la plataforma.
needs_expansion—Si la coincidencia es un enlace corto que hay que expandir para saber a qué apunta (resolve_links); en true, resource_id puede venir vacío.
id_created_at—Fecha de creación que se lee en el propio ID (resolve_links, ISO 8601, UTC): el ID de un vídeo de Douyin lleva dentro su fecha de publicación.
platformstringIdentificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok).

Casos de uso

  • Sacar el ID del video de un texto de compartir

    Pasa el texto de compartir completo como text y lee la fila cuyo resource_type es video; su resource_id es el ID del video.

  • Encontrar al autor y leer su perfil

    Cuando el texto contiene un enlace de perfil de usuario, la fila cuyo resource_type es user da el secUid, que puedes pasar a profiles_batch o a profile.

  • Clasificar un montón de enlaces por tipo

    Usa resource_type (video, usuario, música, colección, sala en vivo, etc.) para enviar cada elemento reconocido al endpoint correspondiente.

  • Calcular cuándo se publicó un video

    Lee id_created_at, la fecha de creación calculada a partir del propio ID del video.

Límites y detalles a tener en cuenta

  • text es obligatorio y es un texto, por ejemplo un texto de compartir completo.
  • Cada elemento encontrado es una fila; match_type indica si se encontró como enlace (link) o como ID simple (id), etc.
  • needs_expansion es true para un enlace corto que aún hay que expandir para saber a qué apunta; entonces resource_id puede estar vacío.
  • handle existe solo cuando el elemento encontrado es un usuario, y es el ID de Douyin o el nombre.
  • id_created_at es la fecha de creación calculada a partir del propio ID; el ID de un video de Douyin lleva dentro su hora de publicación.

Precios

Cada llamada cuesta $0.000792 y se factura por llamada, no por fila encontrada; una llamada procesa un texto. Las llamadas fallidas y los resultados vacíos no se cobran.

LlamadasCosto
10,000$7.92
100,000$79.17
1,000,000$791.67

Los totales se calculan con el precio de lista por llamada.

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": "resolve_links",
  "params": {
    "text": "https://www.douyin.com/video/7539330955225484584"
  }
}'

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.

Referencia de API

Consulta los parámetros, los campos de respuesta, los errores y la facturación de resolve_links, y copia la página o ábrela en Markdown para dársela a un asistente de IA.

POST

Prompt para IA

#
Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra Douyin: Reconocimiento de enlaces (douyin/resolve_links).

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 resolve_links, y los parámetros dentro de params.
- Parámetros obligatorios:
  - text: Un texto, por ejemplo un texto completo de compartir, en el que resolve_links busca enlaces e IDs de vídeo, usuario, música, colección y sala en directo de Douyin.
- Parámetros opcionales:
  - limit: Número máximo de filas que devuelve esta llamada, un entero de 1 o más. Si no lo envías, se usa el valor predeterminado, y una llamada puede devolver menos filas.
- Devuelve una lista de registros. Campos principales de cada registro: matched_text (El fragmento exacto del texto que coinc…), match_type (Cómo aparece la coincidencia en el text…), resource_type (Qué es lo reconocido (resolve_links): v…), resource_id (ID del elemento reconocido (resolve_lin…), handle (El Douyin ID o el nombre cuando la coin…), url, needs_expansion (Si la coincidencia es un enlace corto q…), id_created_at (Fecha de creación que se lee en el prop…).
- Cuerpo de solicitud de ejemplo:
{
  "platform": "douyin",
  "action": "resolve_links",
  "params": {
    "text": "https://www.douyin.com/video/7539330955225484584"
  }
}
- Precio: $0.79 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íresolve_linksIdentificador de la capacidad, valor fijo.
textbody.paramsstringSí-Un texto, por ejemplo un texto completo de compartir, en el que resolve_links busca enlaces e IDs de vídeo, usuario, música, colección y sala en directo de Douyin.
limitbody.paramsinteger (1–)No-Número máximo de filas que devuelve esta llamada, un entero de 1 o más. Si no lo envías, se usa el valor predeterminado, y una llamada puede devolver menos filas.

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": "resolve_links",  "results": [    {      "matched_text": …,      "match_type": …,      "resource_type": …,      "resource_id": …,      "handle": …,      "url": …,      "needs_expansion": …,      "id_created_at": …,      "platform": …    }  ],  "count": …,  "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
matched_textEl fragmento exacto del texto que coincidió (resolve_links).
match_typeCómo aparece la coincidencia en el texto (resolve_links): link para un enlace, id para un ID suelto, etc.
resource_typeQué es lo reconocido (resolve_links): video, user, music, mix para una colección, live para una sala en directo, y otros.
resource_idID del elemento reconocido (resolve_links): ID de vídeo, secUid, ID de música, etc., listo para enviarlo a la acción correspondiente.
handleEl Douyin ID o el nombre cuando la coincidencia es un usuario (resolve_links); no aparece en los demás casos.
urlEnlace al registro en la plataforma.
needs_expansionSi la coincidencia es un enlace corto que hay que expandir para saber a qué apunta (resolve_links); en true, resource_id puede venir vacío.
id_created_atFecha de creación que se lee en el propio ID (resolve_links, ISO 8601, UTC): el ID de un vídeo de Douyin lleva dentro su fecha de publicación.
platformIdentificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok).

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

Preguntas frecuentes

¿Qué devuelve la API de reconocimiento de enlaces?

Una fila por cada enlace o ID encontrado en el texto: matched_text, match_type, resource_type, resource_id, handle, url, needs_expansion e id_created_at.

¿Qué significa que needs_expansion sea true?

El elemento encontrado es un enlace corto que aún hay que expandir para saber a qué apunta; entonces resource_id puede estar vacío.

¿Y si el texto contiene varios enlaces?

Cada elemento encontrado es una fila; distínguelos con resource_type y resource_id.

¿Cuánto cuesta reconocer un texto?

Cuesta $0.000792 por llamada, o $0.79 por cada 1000 llamadas, y se factura por llamada, no por fila encontrada. Las llamadas fallidas y los resultados vacíos no se cobran.

Con la misma clave de API de EveryInfra puedes llamar a los demás endpoints de Douyin.

Google Analytics solo si aceptas. Privacidad