MonitoreoAvanzado3 credits

track_changes

Rastree cambios de contenido en páginas web con captura de línea base, comparación inteligente y monitoreo programado con alertas por webhook. Ideal para monitorear competidores, políticas legales y noticias de última hora.

Casos de uso

Monitorear páginas de precios de competidores

Reciba alertas instantáneas cuando los competidores cambien precios, funciones u ofertas de productos

Rastrear cambios en documentos legales o de políticas

Monitoree términos de servicio, políticas de privacidad o documentos de cumplimiento normativo

Vigilar sitios de noticias en busca de actualizaciones

Detecte noticias de última hora o actualizaciones de artículos en páginas específicas en tiempo real

Detectar caídas o desfiguraciones de sitios web

Reciba alertas cuando cambios estructurales significativos indiquen errores o ataques

Monitorear documentación de API en busca de cambios incompatibles

Rastree páginas de referencia de API para detectar a tiempo discontinuaciones y cambios incompatibles

Endpoint

POST/api/v1/tools/track_changes

Auth Required

2 req/s en el plan Free

3 credits

Parameters

Name	Type	Required	Default	Description
url	string	Required	-	La URL que se monitoreará en busca de cambios Example: https://competitor.com/pricing
operation	string	Optional	compare	Tipo de operación: "create_baseline" \| "compare" \| "monitor" \| "get_history" \| "get_stats" Example: compare
trackingOptions	object	Optional	-	Opciones sobre qué rastrear y cómo hacerlo Example: {"granularity": "high", "ignoreWhitespace": true}
monitoringOptions	object	Optional	-	Opciones para el monitoreo programado Example: {"enabled": true, "interval": "1h"}
storageOptions	object	Optional	-	Opciones para el almacenamiento del historial de cambios Example: {"retainHistory": true, "maxHistoryEntries": 100}

Guía de operaciones

Distintas operaciones para diversos flujos de trabajo de monitoreo

create_baseline

Captura el estado inicial de una página web. Debe ejecutarse primero, antes de cualquier comparación. Crea una captura con hash de contenido, longitud de texto, conteo de enlaces y estructura.

compare

Compara el estado actual de la página web con la línea base. Devuelve el puntaje de cambio, la significancia y una lista detallada de todos los cambios detectados (texto, enlaces, estructura).

monitor

Habilita o deshabilita el monitoreo programado con notificaciones por webhook. Comprueba automáticamente los cambios en el intervalo especificado y envía alertas cuando se alcanza el umbral.

get_history

Recupera el historial de cambios de una URL. Devuelve un arreglo con todos los cambios detectados, con marcas de tiempo, puntajes de cambio y resúmenes.

get_stats

Obtiene estadísticas de monitoreo, incluido el total de comprobaciones, el puntaje de cambio promedio, la hora de la última comprobación y las tendencias de frecuencia de cambios.

Formato de notificación por webhook

Cuando se detectan cambios por encima del umbral, esta carga útil se envía a su webhook

webhook-payload.jsonJson

Su endpoint de webhook debe devolver 200 OK en menos de 10 segundos. Los webhooks fallidos se reintentan hasta 3 veces con retroceso exponencial.

Ejemplos de solicitud

terminalBash

Ejemplo de respuesta

200 OK2,340ms

{
  "success": true,
  "data": {
    "comparison": {
      "changeScore": 0.35,
      "significance": "medium",
      "changes": [
        {
          "type": "text",
          "description": "Pricing changed from $99/mo to $79/mo",
          "location": "div.pricing-card > span.price",
          "oldValue": "$99",
          "newValue": "$79",
          "impact": "high"
        },
        {
          "type": "link",
          "description": "New \"Enterprise\" link added",
          "location": "nav.pricing-tiers",
          "action": "added",
          "url": "/pricing/enterprise",
          "impact": "medium"
        },
        {
          "type": "structure",
          "description": "New section added: \"Compare Plans\"",
          "location": "main > section:nth-child(3)",
          "action": "added",
          "impact": "low"
        }
      ],
      "summary": "3 changes detected: 1 high impact, 1 medium impact, 1 low impact",
      "timestamp": "2025-10-15T14:30:00Z"
    },
    "baseline": {
      "url": "https://competitor.com/pricing",
      "captured_at": "2025-10-15T12:00:00Z",
      "hash": "a1b2c3d4e5f6",
      "metrics": {
        "textLength": 4567,
        "linkCount": 23,
        "elementCount": 145
      }
    },
    "history": {
      "totalChecks": 48,
      "changesDetected": 5,
      "lastCheck": "2025-10-15T14:30:00Z",
      "nextCheck": "2025-10-15T15:30:00Z"
    }
  },
  "credits_used": 3,
  "credits_remaining": 997,
  "processing_time": 2340
}

Field Descriptions

data.comparison.changeScorePuntaje de cambio general (0-1, donde 1 significa completamente diferente)

data.comparison.significancelow, medium o high según el changeScore

data.comparison.changesArreglo de cambios detectados con sus detalles

data.baseline.hashHash único del contenido de la línea base para la comparación

data.history.nextCheckPróxima comprobación programada (si el monitoreo está habilitado)

credits_used3 credits fijos por operación (baseline, compare, monitor, etc.)

processing_timeNormalmente de 2 a 4 segundos en operaciones de comparación

Manejo de errores

No se encontró línea base (400 Bad Request)

Debe ejecutar primero la operación create_baseline antes de comparar. Cada URL necesita su propia línea base.

Intervalo de monitoreo no válido (400 Bad Request)

El intervalo debe ser uno de: 15m, 30m, 1h, 6h, 24h. Los intervalos más cortos requieren planes superiores.

URL no accesible (400 Bad Request)

La URL de destino devolvió un error o está bloqueada. Verifique la accesibilidad de la URL y la autenticación.

Webhook fallido (500 Internal Server Error)

La URL del webhook devolvió un error o se agotó el tiempo de espera. Asegúrese de que el endpoint sea accesible y devuelva 200 OK.

Consejo profesional: Use alta granularidad para páginas críticas, como precios o documentos legales. Use granularidad media o baja para páginas con actualizaciones menores frecuentes y reducir así los falsos positivos.

Costo en credits

3 credits

3 credits por operación

Cada operación (create_baseline, compare, monitor, get_history, get_stats) cuesta 3 credits. Las comprobaciones de monitoreo programado se cobran por ejecución.

Desglose de costos:

create_baseline: 3 credits (una sola vez por URL)

compare: 3 credits por comprobación

monitor (configuración): 3 credits (una sola vez)

Comprobaciones programadas: 3 credits por ejecución

get_history: 3 credits por consulta

get_stats: 3 credits por consulta

Ejemplo de costo de monitoreo:

Intervalo de monitoreo de 1 hora: 24 comprobaciones/día × 3 credits = 72 credits/día/URL

Intervalo de monitoreo de 6 horas: 4 comprobaciones/día × 3 credits = 12 credits/día/URL

Intervalo de monitoreo de 24 horas: 1 comprobación/día × 3 credits = 3 credits/día/URL

Recomendaciones de plan:

Plan Free: 1,000 credits de prueba por única vez = Monitoree 5 URLs en intervalos de 6h durante 1 mes

Plan Hobby: 5,000 credits = Monitoree 25 URLs en intervalos de 6h ($19/mo)

Plan Professional: 50,000 credits = Monitoree 250 URLs en intervalos de 6h ($99/mo)

Herramientas relacionadas

fetch_url

Obtención básica de URL para comparación (1 credit)

extract_content

Extraiga el contenido principal para un monitoreo enfocado (2 credits)

stealth_mode

Monitoree páginas protegidas sin ser detectado (5 credits)

batch_scrape

Monitoree varias URLs en paralelo (1 credit por URL)

¿Listo para probar track_changes? Regístrese gratis y obtenga 1,000 credits para empezar a monitorear sus primeras páginas.

Casos de uso

Monitorear páginas de precios de competidores

Reciba alertas instantáneas cuando los competidores cambien precios, funciones u ofertas de productos

Rastrear cambios en documentos legales o de políticas

Monitoree términos de servicio, políticas de privacidad o documentos de cumplimiento normativo

Vigilar sitios de noticias en busca de actualizaciones

Detecte noticias de última hora o actualizaciones de artículos en páginas específicas en tiempo real

Detectar caídas o desfiguraciones de sitios web

Reciba alertas cuando cambios estructurales significativos indiquen errores o ataques

Monitorear documentación de API en busca de cambios incompatibles

Rastree páginas de referencia de API para detectar a tiempo discontinuaciones y cambios incompatibles

Parameters

Name	Type	Required	Default	Description
url	string	Required	-	La URL que se monitoreará en busca de cambios Example: https://competitor.com/pricing
operation	string	Optional	compare	Tipo de operación: "create_baseline" \| "compare" \| "monitor" \| "get_history" \| "get_stats" Example: compare
trackingOptions	object	Optional	-	Opciones sobre qué rastrear y cómo hacerlo Example: {"granularity": "high", "ignoreWhitespace": true}
monitoringOptions	object	Optional	-	Opciones para el monitoreo programado Example: {"enabled": true, "interval": "1h"}
storageOptions	object	Optional	-	Opciones para el almacenamiento del historial de cambios Example: {"retainHistory": true, "maxHistoryEntries": 100}

Guía de operaciones

Distintas operaciones para diversos flujos de trabajo de monitoreo

create_baseline

Captura el estado inicial de una página web. Debe ejecutarse primero, antes de cualquier comparación. Crea una captura con hash de contenido, longitud de texto, conteo de enlaces y estructura.

compare

Compara el estado actual de la página web con la línea base. Devuelve el puntaje de cambio, la significancia y una lista detallada de todos los cambios detectados (texto, enlaces, estructura).

monitor

Habilita o deshabilita el monitoreo programado con notificaciones por webhook. Comprueba automáticamente los cambios en el intervalo especificado y envía alertas cuando se alcanza el umbral.

get_history

Recupera el historial de cambios de una URL. Devuelve un arreglo con todos los cambios detectados, con marcas de tiempo, puntajes de cambio y resúmenes.

get_stats

Obtiene estadísticas de monitoreo, incluido el total de comprobaciones, el puntaje de cambio promedio, la hora de la última comprobación y las tendencias de frecuencia de cambios.

Ejemplo de respuesta

200 OK2,340ms

{
  "success": true,
  "data": {
    "comparison": {
      "changeScore": 0.35,
      "significance": "medium",
      "changes": [
        {
          "type": "text",
          "description": "Pricing changed from $99/mo to $79/mo",
          "location": "div.pricing-card > span.price",
          "oldValue": "$99",
          "newValue": "$79",
          "impact": "high"
        },
        {
          "type": "link",
          "description": "New \"Enterprise\" link added",
          "location": "nav.pricing-tiers",
          "action": "added",
          "url": "/pricing/enterprise",
          "impact": "medium"
        },
        {
          "type": "structure",
          "description": "New section added: \"Compare Plans\"",
          "location": "main > section:nth-child(3)",
          "action": "added",
          "impact": "low"
        }
      ],
      "summary": "3 changes detected: 1 high impact, 1 medium impact, 1 low impact",
      "timestamp": "2025-10-15T14:30:00Z"
    },
    "baseline": {
      "url": "https://competitor.com/pricing",
      "captured_at": "2025-10-15T12:00:00Z",
      "hash": "a1b2c3d4e5f6",
      "metrics": {
        "textLength": 4567,
        "linkCount": 23,
        "elementCount": 145
      }
    },
    "history": {
      "totalChecks": 48,
      "changesDetected": 5,
      "lastCheck": "2025-10-15T14:30:00Z",
      "nextCheck": "2025-10-15T15:30:00Z"
    }
  },
  "credits_used": 3,
  "credits_remaining": 997,
  "processing_time": 2340
}

Field Descriptions

data.comparison.changeScorePuntaje de cambio general (0-1, donde 1 significa completamente diferente)

data.comparison.significancelow, medium o high según el changeScore

data.comparison.changesArreglo de cambios detectados con sus detalles

data.baseline.hashHash único del contenido de la línea base para la comparación

data.history.nextCheckPróxima comprobación programada (si el monitoreo está habilitado)

credits_used3 credits fijos por operación (baseline, compare, monitor, etc.)

processing_timeNormalmente de 2 a 4 segundos en operaciones de comparación

Manejo de errores

No se encontró línea base (400 Bad Request)

Debe ejecutar primero la operación create_baseline antes de comparar. Cada URL necesita su propia línea base.

Intervalo de monitoreo no válido (400 Bad Request)

El intervalo debe ser uno de: 15m, 30m, 1h, 6h, 24h. Los intervalos más cortos requieren planes superiores.

URL no accesible (400 Bad Request)

La URL de destino devolvió un error o está bloqueada. Verifique la accesibilidad de la URL y la autenticación.

Webhook fallido (500 Internal Server Error)

La URL del webhook devolvió un error o se agotó el tiempo de espera. Asegúrese de que el endpoint sea accesible y devuelva 200 OK.

Costo en credits

3 credits

3 credits por operación

Cada operación (create_baseline, compare, monitor, get_history, get_stats) cuesta 3 credits. Las comprobaciones de monitoreo programado se cobran por ejecución.

Desglose de costos:

create_baseline: 3 credits (una sola vez por URL)

compare: 3 credits por comprobación

monitor (configuración): 3 credits (una sola vez)

Comprobaciones programadas: 3 credits por ejecución

get_history: 3 credits por consulta

get_stats: 3 credits por consulta

Ejemplo de costo de monitoreo:

Intervalo de monitoreo de 1 hora: 24 comprobaciones/día × 3 credits = 72 credits/día/URL

Intervalo de monitoreo de 6 horas: 4 comprobaciones/día × 3 credits = 12 credits/día/URL

Intervalo de monitoreo de 24 horas: 1 comprobación/día × 3 credits = 3 credits/día/URL

Recomendaciones de plan:

Plan Free: 1,000 credits de prueba por única vez = Monitoree 5 URLs en intervalos de 6h durante 1 mes

Plan Hobby: 5,000 credits = Monitoree 25 URLs en intervalos de 6h ($19/mo)

Plan Professional: 50,000 credits = Monitoree 250 URLs en intervalos de 6h ($99/mo)