Vigilar una palabra
A veces lo que importa no es un precio ni una imagen, sino una sola palabra escondida en un muro de texto: una cláusula legal, un mensaje de error, la mención de una marca, una etiqueta de estado. Esta api para monitorear una palabra en una web lee una página y le avisa cuando un término o frase específica aparece o desaparece, sin que tenga que revisar todo el documento por su cuenta.
La palabra que lo cambia todo
Una página de términos de servicio que agrega una cláusula en silencio, un aviso gubernamental que cambia 'en trámite' por 'aprobado', una página de estado que deja de decir 'operativo', un foro donde por fin mencionan el nombre de su marca: en todos estos casos, un solo término contiene toda la señal y el resto de la página es ruido. Leer la página completa a mano todos los días para detectar una palabra es una pérdida de tiempo para cualquiera.
Cómo lee la página la verificación
Llama a POST /web/monitor-keyword con una URL y el término o frase a vigilar. La tarea obtiene el contenido de texto actual de la página, busca la palabra clave y registra si está presente. En cada comprobación siguiente, esa presencia se compara contra el estado anterior, y se le informa concretamente si el término apareció, desapareció o se mantuvo igual, no solo que la página fue revisada.
Una idea sencilla con raíces antiguas
Vigilar palabras clave es anterior a la web misma: los servicios de recortes de prensa alguna vez pagaban a personas para escanear periódicos en busca del nombre de un cliente. La mecánica cambió, la necesidad de fondo no: alguien, en algún lugar, necesita saber en el instante en que una palabra específica aparece en un lugar específico, ya sea un término normativo en una regulación o el nombre de un competidor en un comunicado.
Pensado para una vigilancia constante y silenciosa
Cada llamada es asíncrona: recibe un task_id de inmediato, y el hallazgo real llega después mediante un webhook firmado, la opción natural para un monitor que debe operar en silencio de fondo y solo avisar cuando cambia el estado de la palabra clave, o un enlace firmado válido por 24 horas si prefiere consultar los resultados de forma manual. Como cada verificación es liviana, se adapta bien a un sondeo frecuente en el horario que usted controle.
Un precio pensado para esa frecuencia
El costo es un valor fijo de $0.002 por solicitud, publicado y simple, sin plan gratuito ni período de prueba: el acceso requiere saldo prepago, lo que mantiene el servicio rápido y libre de abuso. Una solicitud que falla se reintenta automáticamente hasta tres veces y nunca se cobra si finalmente no se completa.
Qué puede hacer con ella
Vigilancia de texto legal o normativo
Reciba un aviso en el momento en que se agrega o elimina una cláusula, término o excepción específica de una regulación o página de términos.
Seguimiento de menciones de marca
Vigile un foro, una página de reseñas o una noticia para detectar la primera vez que aparece el nombre de su empresa o producto.
Cambios de palabra en una página de estado
Siga una página de estado o incidentes para la palabra 'operativo' o 'interrupción' y sepa el momento exacto en que cambia el estado de un servicio.
Detección de mensajes de error
Monitoree una página interna o de un socio en busca de un mensaje de error, y detecte una integración rota antes de que un cliente la reporte.
Preguntas frecuentes
¿Cómo configuro el monitoreo de una palabra específica?
Llame a POST /web/monitor-keyword con la URL objetivo y el término o frase exacta a vigilar; cada comprobación siguiente reporta si la presencia de esa palabra en la página cambió.
¿El monitoreo de palabras clave tiene una versión gratuita?
No hay capa gratuita: las capas gratis se abusan y ralentizan a todos. El acceso funciona con un saldo prepago de ForHosting KIT: se recarga desde $10.00 (no caduca) y cada solicitud se cobra a su precio publicado, así que una llamada sin saldo devuelve HTTP 402. Sin suscripción, sin tokens ni créditos inventados, y una tarea fallida no se cobra.
¿Puedo detectar cuando una frase desaparece y no solo cuando aparece?
Sí, cada comprobación compara la presencia actual de la palabra clave contra el último estado registrado, así que tanto la aparición como la desaparición de un término se detectan y se reportan.
¿La búsqueda admite coincidencias parciales o solo frases exactas?
La verificación busca el término o frase exacta que proporcione dentro del contenido de texto de la página, así que especificar la redacción precisa que le interesa da el resultado más confiable.
¿Con qué frecuencia puedo ejecutar esta verificación?
Con la frecuencia que su propio horario defina; no hay un límite artificial, y como cada solicitud se factura individualmente a $0.002, las verificaciones frecuentes siguen siendo predecibles y económicas.
¿Cómo recibo una alerta cuando cambia la palabra clave?
Configure un webhook firmado para recibir el resultado en el instante en que se detecta un cambio, o use un enlace firmado válido por 24 horas si prefiere consultar los resultados manualmente.
¿Puedo monitorear varias palabras clave en muchas páginas?
Sí, cada combinación de URL y palabra clave es una solicitud asíncrona independiente, así que el monitoreo masivo sobre muchas páginas y términos consiste en disparar monitor-keyword para cada combinación.
¿Qué pasa si la página falla al cargar durante una verificación?
La tarea se reintenta automáticamente hasta tres veces; si sigue fallando, recibe un error claro en lugar de un falso negativo, y el intento fallido no se cobra.
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, y pronto desde nuestra app, el email y Telegram.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/web/monitor-keyword \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"input":"…"}'const res = await fetch("https://api.kit.forhosting.com/web/monitor-keyword", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"input": "…"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/web/monitor-keyword",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"input": "…"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/web/monitor-keyword", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"input":"…"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/web/monitor-keyword", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"input": "…"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "web.monitor_keyword",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Límites
timeout_sec | 30 |
max_crawl_pages | 25 |
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |