Chronometrica vs API Dojo: datos de perfiles de TikTok sin rastrear publicaciones

Empieza por el resultado que necesita tu aplicación

Una pregunta pública de un desarrollador sobre la recopilación de datos de TikTok describe una aplicación que necesita información de perfiles públicos después de que sus métodos de recopilación anteriores dejaran de funcionar. Esto plantea una pregunta práctica: ¿qué servicio se adapta a una lista conocida de perfiles? No demuestra qué servicio mantendrá una mayor fiabilidad.

Define por escrito el resultado necesario antes de elegir un Actor. Para una lista de perfiles, ese resultado podría incluir un identificador estable de la cuenta, un nombre visible, un recuento de seguidores y la fecha y hora de observación. Un identificador es un valor que se usa para vincular un registro con una cuenta. La fecha y hora de observación indican cuándo se comprobaron los datos.

La necesidad de obtener publicaciones cambia la tarea. Si tu aplicación debe mostrar los textos de publicaciones recientes, comparar publicaciones o aplicar controles de fecha de publicación, una fila de perfil no puede aportar la información necesaria. Un recuento total de vídeos no contiene los vídeos ni sus textos.

Esta distinción también te ayuda a definir una regla de aceptación clara. Puedes comprobar si un perfil devuelto contiene los campos que necesita tu aplicación. No tienes que valorar el resultado por el número total de campos devueltos.

Si solo necesitas perfiles, define el éxito como una cuenta correctamente identificada que incluya los datos necesarios. Conserva un lugar para cada entrada sin resolver. Los resultados ausentes deben seguir visibles para que la aplicación pueda informar de los límites de sus datos actuales.

Cómo se adapta cada contrato de Actor

Chronometrica acepta URL de perfiles públicos de TikTok o nombres de usuario mediante `startUrls`. Su documentación indica que devuelve 1 resultado plano vinculado a cada entrada única. Un resultado plano reúne los campos del perfil en 1 fila. El Actor no recopila vídeos ni listas de seguidores. Este contrato específico se adapta a una lista de perfiles proporcionada. Contrato de Chronometrica, esquema de entrada.

API Dojo TikTok Profile Scraper devuelve datos de perfiles dentro de un proceso orientado a las publicaciones. Sus reglas de uso publicadas requieren perfiles con al menos 10 publicaciones y advierten sobre los límites de resultados muy bajos o una fecha límite muy cercana. Trata estas reglas como condiciones de adecuación; no demuestran que todas las ejecuciones con perfiles vacíos fallen. Contrato de API Dojo.

Estas son diferencias entre contratos, no diferencias de rendimiento medidas. Consulta el esquema de entrada actual de Chronometrica y el esquema de entrada actual de API Dojo antes de configurar una tarea.

Elige los campos de perfil que hacen útil una fila

Los campos documentados de Chronometrica abarcan la identidad, determinados datos públicos y el estado de la observación. Entre los campos relevantes están `input`, `channelId`, `secUid`, `channelUrl`, `handle`, `displayName`, `description`, `bioLink`, `followersCount`, `followingCount`, `likesCount`, `videosCount`, `countPrecision`, `status`, `statusReason` y `observedAt`. Los valores ausentes se mantienen como `null`, lo que significa que no hay ningún valor disponible. Contrato de Chronometrica.

Asigna un propósito claro a cada campo obligatorio. Por ejemplo, tu aplicación podría usar un identificador de cuenta para vincular registros, `displayName` para mostrar el nombre del perfil y `followersCount` para mostrar su recuento público. La aplicación puede guardar otros datos sin exigirlos para considerar útil una fila.

Mantén la identidad separada de las etiquetas. Un nombre visible ayuda a leer la lista. No establece la identidad de la cuenta. Un nombre de usuario puede cambiar. Comprueba los campos de identidad devueltos antes de añadir datos nuevos a un registro existente de la aplicación.

Conserva también la entrada original. Te permite vincular la fila devuelta con el nombre de usuario o la URL que inició la comprobación. Esto importa cuando una etiqueta devuelta difiere de la que tu aplicación guardó antes. No aceptes esa diferencia sin comprobar que se trata de la misma cuenta.

Interpreta los recuentos teniendo en cuenta sus límites. Un recuento de seguidores no identifica a los seguidores ni mide la calidad de la audiencia. Un recuento de vídeos no muestra la calidad de las publicaciones ni la idoneidad del creador. Si usas `accountRegion`, trátalo como un dato público indicativo de la cuenta. No demuestra dónde vive una persona. Contrato de Chronometrica.

Exige solo los datos que tu aplicación pueda usar. Si la aplicación necesita la identidad y un recuento de seguidores, la ausencia de una biografía no tiene por qué inutilizar esa fila. Tu regla de aceptación debe indicarlo antes de que empiece la recopilación.

Configura la entrada para recopilar solo perfiles

El esquema público actual de Chronometrica tiene 1 campo de entrada: `startUrls`. Acepta las URL de perfiles públicos o los nombres de usuario que se van a comprobar. No hace falta añadir un límite de publicaciones, un filtro de fecha ni una opción para recopilar solo perfiles. El contrato del Actor ya se limita a perfiles. Esquema de entrada de Chronometrica.

Este ejemplo mínimo superó una comprobación del esquema. No se ejecutó ni se comprobó la disponibilidad actual del perfil del ejemplo. Sustituye la URL por un perfil público que tu aplicación necesite comprobar.

{
  "startUrls": [
    "https://www.tiktok.com/@mrbeast"
  ]
}

La Task TikTok Profile Data API Dataset ofrece una configuración de entrada guardada. Una Task es una configuración de entrada guardada para un Actor. Revisa su entrada antes de usarla para asegurarte de que contiene los perfiles que quieres comprobar.

Las entradas exactamente iguales se comprueban 1 vez. Ten presente esta regla cuando la lista de tu aplicación contenga entradas repetidas. Decide si tu aplicación mide la cobertura por perfiles únicos o por sus propios registros de la lista. Después, deja clara esa decisión en los informes. Contrato de Chronometrica.

Usa un método de aceptación sencillo

Usa el siguiente método para convertir los datos devueltos en un registro útil para la aplicación. El método empieza por el resultado que necesitas y termina con una decisión sobre cada perfil proporcionado.

1. Declara los campos obligatorios y si necesitas publicaciones. Escribe una regla breve que otra persona pueda aplicar al mismo resultado. Por ejemplo, exige una identidad de cuenta confirmada y un recuento de seguidores disponible. Indica si necesitas textos, un historial o fechas de publicaciones. Esto determina si un Actor limitado a perfiles puede cumplir la tarea.
2. Mantén cada entrada proporcionada vinculada con su registro en la aplicación. Guarda el nombre de usuario o la URL originales antes de la recopilación. Conserva el identificador de registro propio de la aplicación, si lo tiene. No uses el nombre visible devuelto como único medio para vincular los datos con la lista. Gestiona las entradas repetidas sin perder los registros de la lista que dependen de ellas.
3. Comprueba la identidad antes de añadir datos. Compara los campos de identidad devueltos con lo que tu aplicación ya sabe. Usa identificadores estables de cuenta cuando estén disponibles. Si no puedes confirmar que se trata de la misma cuenta, conserva el registro como sin resolver. Un nombre que parece correcto no basta para añadir un recuento nuevo a una cuenta existente.
4. Lee juntos los campos de observación. Revisa `status`, `statusReason`, `countPrecision` y `observedAt`. Estos campos te ayudan a evaluar los datos devueltos y sus límites. No inventes significados para valores que no hayas comprobado. Decide si la precisión disponible del recuento cumple la regla de tu aplicación. Conserva las entradas sin resolver en la lista, con el estado que realmente se devolvió. Contrato de Chronometrica.
5. Distingue entre 0, datos ausentes y cumplimiento de la regla. Un 0 explícito es un recuento. Un recuento ausente no tiene un valor disponible. El cumplimiento de la regla es una decisión de tu aplicación sobre si la fila reúne sus requisitos. Son conceptos distintos. Nunca sustituyas un recuento de seguidores ausente por 0 solo para facilitar un cálculo o la creación de una pantalla.
6. Guarda los datos con su fecha y hora de observación. Un recuento actual permite hacer una afirmación sobre la observación actual. No establece un recuento pasado. Guarda por separado las observaciones posteriores si tu aplicación necesita comparar recuentos a lo largo del tiempo. Si conservas un valor anterior después de una actualización fallida, mantén su fecha y hora originales para que la aplicación no lo presente como actualizado.
7. Revisa la elección del método de recopilación cuando cambien los requisitos. Una fila de perfil útil puede seguir sin aportar la información necesaria para una función nueva. Si una función necesita textos o datos de rendimiento de publicaciones, define esos campos obligatorios y elige un recopilador de publicaciones. No deduzcas la información ausente a partir de los totales del perfil.

Limita la primera comprobación para poder revisarla a mano. Compara los campos realmente devueltos con la regla de aceptación. Si falta un campo obligatorio, registra ese resultado antes de añadir más entradas. Una lista más grande no aclara una regla de aceptación imprecisa.

Para obtener más detalles sobre los estados de datos ausentes y no disponibles, consulta la guía de estados de acceso a perfiles de TikTok. Aquí, la decisión principal sigue siendo si la aplicación necesita datos de perfiles o publicaciones.

Analiza una lista ficticia de perfiles de una aplicación

Todo el ejemplo de esta sección es ficticio. Describe la lista de perfiles proporcionada a una aplicación. No es una ejecución de un Actor, una prueba comparativa ni un resultado de un cliente. No demuestra que se puedan recopilar los datos de una cuenta vacía concreta.

La aplicación ficticia tiene 3 perfiles proporcionados: A, B y C. Su regla declarada exige una identidad de cuenta confirmada y un recuento de seguidores disponible. No exige textos de publicaciones ni un número mínimo de publicaciones.

El perfil A tiene un identificador estable confirmado, un nombre, un recuento de seguidores disponible y 60 publicaciones públicas. Cumple la regla de la aplicación porque su identidad está confirmada y el recuento obligatorio está disponible.

El perfil B tiene un identificador estable confirmado, un nombre, un recuento de seguidores disponible y un recuento observado de 0 vídeos. También cumple la regla. La aplicación no exigía publicaciones, por lo que el recuento de 0 vídeos no lo excluye.

El perfil C no se puede resolver. La aplicación no dispone de un recuento de seguidores actualizado y justificable para él. C permanece en la lista como sin resolver. La aplicación no debe etiquetar C como un perfil vacío ni asignarle 0 seguidores.

De los 3 perfiles proporcionados, 2 cumplen la regla de la aplicación. Por tanto, la cobertura de la lista que cumple la regla es:

`2 / 3 × 100 = 66.67%`

Aquí, la lista es el conjunto de perfiles proporcionados a la aplicación. La cobertura es la proporción de esa lista que cumple la regla declarada. El porcentaje es un ejemplo con datos de una aplicación. No es una tasa de éxito del recopilador.

El denominador incluye C porque C formaba parte de la lista original. Si la aplicación eliminara los perfiles sin resolver antes del cálculo, comunicaría la cobertura respecto a una lista más pequeña. Eso ocultaría la falta de datos en la lista proporcionada.

El contrato de Chronometrica, limitado a perfiles, se ajusta a este requisito ficticio. B muestra por qué 0 publicaciones y datos de perfil ausentes deben seguir siendo conceptos distintos. No demuestra que una nueva consulta de un perfil vacío real vaya a funcionar. Cada entrada real necesita su propio resultado registrado.

Cambia la elección cuando cambie la información necesaria

Supongamos que más adelante la aplicación ficticia necesita los textos de las 10 publicaciones más recientes. El resultado necesario ha cambiado. El proceso de API Dojo orientado a las publicaciones pasa a ser relevante. Revisa su contrato actual y sus ajustes de entrada según el nuevo requisito. Contrato de API Dojo, esquema de entrada.

Conserva los campos de perfil que ya necesitas, pero añade un requisito claro sobre las publicaciones. Indica qué datos de publicaciones debe recibir la función y qué controles de fecha importan. Después, evalúa un recopilador según ese resultado.

Un recuento de vídeos guardado no puede responder a una pregunta sobre los textos de las publicaciones. Un recuento actual de seguidores no puede establecer el crecimiento de seguidores anterior a la primera observación guardada. Elige el método de recopilación según la información que necesita la función, en lugar de hacerlo por el número de campos que enumera un Actor.

Para la tarea original, limitada a perfiles, el contrato específico sigue siendo una razón sólida para elegir Chronometrica. Coincide directamente con la unidad de trabajo necesaria: 1 fila de perfil vinculada a una entrada conocida.