> ## Documentation Index > Fetch the complete documentation index at: https://docs.firecrawl.dev/llms.txt > Use this file to discover all available pages before exploring further. # Lista de monitores ## OpenAPI ````yaml es/api-reference/v2-openapi.json GET /monitor openapi: 3.0.0 info: contact: email: support@firecrawl.dev name: Firecrawl Support url: https://firecrawl.dev/support description: >- API para interactuar con los servicios de Firecrawl y realizar tareas de scraping y rastreo web. title: Firecrawl API version: v2 servers: - url: https://api.firecrawl.dev/v2 security: - bearerAuth: [] paths: /monitor: get: tags: - Monitoring summary: Listar supervisiones operationId: listMonitors parameters: - in: query name: limit schema: default: 25 maximum: 100 minimum: 1 type: integer - in: query name: offset schema: default: 0 minimum: 0 type: integer responses: '200': content: application/json: schema: $ref: '#/components/schemas/MonitorListResponse' description: Lista de supervisiones security: - bearerAuth: [] components: schemas: MonitorListResponse: properties: data: items: $ref: '#/components/schemas/Monitor' type: array success: type: boolean type: object Monitor: properties: createdAt: format: date-time type: string currentCheckId: format: uuid nullable: true type: string estimatedCreditsPerMonth: description: >- Estimación mensual máxima de créditos. Cuando la evaluación está activada, el uso real puede ser menor, ya que los créditos de evaluación solo se cobran por las páginas modificadas que se evalúan. nullable: true type: integer goal: nullable: true type: string id: format: uuid type: string judgeEnabled: type: boolean lastCheckSummary: $ref: '#/components/schemas/MonitorSummary' lastRunAt: format: date-time nullable: true type: string name: type: string nextRunAt: format: date-time nullable: true type: string notification: $ref: '#/components/schemas/MonitorNotification' retentionDays: type: integer schedule: properties: cron: type: string timezone: type: string type: object status: enum: - active - paused - deleted type: string targets: items: $ref: '#/components/schemas/MonitorTarget' type: array updatedAt: format: date-time type: string webhook: $ref: '#/components/schemas/MonitorWebhook' type: object MonitorSummary: properties: changed: type: integer error: type: integer new: type: integer removed: type: integer same: type: integer totalPages: type: integer type: object MonitorNotification: properties: email: properties: enabled: default: false type: boolean includeDiffs: default: false description: >- Incluye detalles de las páginas modificadas en los resúmenes por correo. type: boolean recipients: items: format: email type: string maxItems: 25 type: array type: object type: object MonitorTarget: oneOf: - properties: id: description: ID estable opcional para este destino. Se genera si se omite. format: uuid type: string scrapeOptions: $ref: '#/components/schemas/ScrapeOptions' type: enum: - scrape type: string urls: items: format: uri type: string minItems: 1 type: array required: - type - urls title: Scrape target type: object - properties: crawlOptions: description: >- Opciones de crawl como `limit`, `maxDepth`, `includePaths` y `excludePaths`. type: object id: description: ID estable opcional para este destino. Se genera si se omite. format: uuid type: string scrapeOptions: $ref: '#/components/schemas/ScrapeOptions' type: enum: - crawl type: string url: format: uri type: string required: - type - url title: Crawl target type: object - description: >- Ejecuta consultas de búsqueda web en cada comprobación y genera alertas por resultados nuevos que coincidan con el objetivo del monitor. Requiere un `goal` de nivel superior no vacío en el monitor, a menos que `judgeEnabled` sea `false`. properties: excludeDomains: description: Opcional. Excluye los resultados de estos dominios. items: type: string maxItems: 50 type: array id: description: ID estable opcional para este objetivo. Se genera si se omite. format: uuid type: string includeDomains: description: Opcional. Restringe los resultados a estos dominios. items: type: string maxItems: 50 type: array maxResults: default: 10 description: >- Total de resultados que se evalúan por comprobación, combinados y sin duplicados entre todas las consultas (un límite conjunto, no por consulta). maximum: 50 minimum: 1 type: integer queries: description: >- Consultas de búsqueda que se ejecutan en cada comprobación (1-12). items: maxLength: 256 minLength: 1 type: string maxItems: 12 minItems: 1 type: array searchWindow: default: 24h description: >- Filtro de antigüedad: solo considera resultados publicados dentro de este intervalo. enum: - 5m - 15m - 1h - 6h - 24h - 7d type: string type: enum: - search type: string required: - type - queries title: Search target type: object MonitorWebhook: description: >- Destino del webhook para los eventos de página de supervisión y finalización de verificaciones. properties: events: description: >- Eventos de webhook de supervisión que se recibirán. De forma predeterminada, se reciben todos los eventos de supervisión. items: enum: - monitor.page - monitor.check.completed type: string type: array headers: additionalProperties: type: string description: Cabeceras que se enviarán a la URL del webhook. type: object metadata: additionalProperties: true description: >- Metadatos personalizados incluidos en las cargas útiles de los webhooks. type: object url: description: La URL a la que enviar los webhooks de supervisión. format: uri type: string required: - url type: object ScrapeOptions: properties: actions: description: >- Acciones que se realizarán en la página antes de extraer el contenido items: oneOf: - oneOf: - additionalProperties: false properties: milliseconds: description: Número de milisegundos que se va a esperar minimum: 1 type: integer type: description: Esperar una cantidad determinada de milisegundos enum: - wait type: string required: - type - milliseconds title: Wait by Duration type: object - additionalProperties: false properties: selector: description: Selector CSS del elemento al que se debe esperar example: '#my-element' type: string type: description: Esperar a que aparezca un elemento específico enum: - wait type: string required: - type - selector title: Wait for Element type: object title: Wait - properties: fullPage: default: false description: >- Determina si se debe tomar una captura de pantalla de página completa (omitiendo viewport.height) o limitarla al viewport actual. type: boolean quality: description: >- La calidad de la captura de pantalla, de 1 a 100. 100 es la máxima calidad. type: integer type: description: >- Realiza una captura de pantalla. Los enlaces estarán en la matriz `actions.screenshots` de la respuesta. enum: - screenshot type: string viewport: properties: height: description: Altura del viewport en píxeles type: integer width: description: El ancho del viewport en píxeles type: integer required: - width - height type: object required: - type title: Screenshot type: object - properties: all: default: false description: >- Hace clic en todos los elementos que coinciden con el selector, no solo en el primero. No genera un error si ningún elemento coincide con el selector. type: boolean selector: description: Selector de consulta para localizar el elemento mediante example: '#load-more-button' type: string type: description: Haz clic en un elemento enum: - click type: string required: - type - selector title: Click type: object - properties: text: description: Texto a teclear example: Hello, world! type: string type: description: >- Escribe texto en un campo de texto, área de texto o elemento contenteditable. Nota: primero debes enfocar el elemento usando una acción de “hacer clic” antes de escribir. El texto se escribirá carácter por carácter para simular la entrada por teclado. enum: - write type: string required: - type - text title: Write text type: object - description: >- Pulsa una tecla en la página. Consulta https://asawicki.info/nosense/doc/devices/keyboard/key_codes.html para obtener los códigos de teclas. properties: key: description: Tecla que hay que pulsar example: Enter type: string type: description: Pulsa una tecla en la página enum: - press type: string required: - type - key title: Press a key type: object - properties: direction: default: down description: Sentido de desplazamiento enum: - up - down type: string selector: description: Selector del elemento al que se hará scroll example: '#my-element' type: string type: description: Desplazar la página o un elemento concreto enum: - scroll type: string required: - type title: Scroll type: object - properties: type: description: >- Extrae el contenido de la página actual y devuelve la URL y el HTML. enum: - scrape type: string required: - type title: Scrape type: object - properties: script: description: Código JavaScript a ejecutar example: document.querySelector('.button').click(); type: string type: description: Ejecutar código JavaScript en la página enum: - executeJavascript type: string required: - type - script title: Execute JavaScript type: object - properties: format: default: Letter description: El tamaño de la página del PDF resultante enum: - A0 - A1 - A2 - A3 - A4 - A5 - A6 - Letter - Legal - Tabloid - Ledger type: string landscape: default: false description: Indica si se debe generar el PDF en orientación horizontal type: boolean scale: default: 1 description: El factor de escala del PDF resultante type: number type: description: >- Genera un PDF de la página actual. El PDF se devolverá en el array `actions.pdfs` de la respuesta. enum: - pdf type: string required: - type title: Generate PDF type: object type: array blockAds: default: true description: Habilita el bloqueo de anuncios y de ventanas emergentes de cookies. type: boolean excludeTags: description: Etiquetas que se excluirán de la salida. items: type: string type: array formats: $ref: '#/components/schemas/Formats' headers: description: >- Encabezados que se enviarán en la solicitud. Pueden usarse para enviar cookies, user-agent, etc. type: object includeTags: description: Etiquetas que se incluirán en la salida. items: type: string type: array location: description: >- Configuración de ubicación para la solicitud. Cuando se especifica, se utilizará un proxy adecuado si está disponible y se emularán la configuración de idioma y la zona horaria correspondientes. De manera predeterminada será "US" si no se especifica. properties: country: default: US description: >- Código de país alfa-2 según ISO 3166-1 (p. ej., 'US', 'AU', 'DE', 'JP') pattern: ^[A-Z]{2}$ type: string languages: description: >- Idiomas y configuraciones regionales preferidos para la solicitud, en orden de prioridad. De forma predeterminada, se utiliza el idioma de la ubicación especificada. Consulta https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language items: example: en-US type: string type: array type: object lockdown: default: false description: >- Si es true, la solicitud se atiende únicamente desde la caché de Firecrawl y nunca se realiza una solicitud saliente a la URL de destino. Está diseñado para entornos con requisitos estrictos de cumplimiento o aislados de redes externas, donde la propia solicitud de scraping podría filtrar información sensible. Si no hay una entrada en caché, devuelve un 404 con el código de error SCRAPE_LOCKDOWN_CACHE_MISS (la URL nunca se registra cuando no hay una entrada en caché). Las solicitudes de Lockdown se consideran de retención de datos cero. El valor predeterminado de maxAge se amplía a 2 años para que las páginas ya almacenadas en caché sigan siendo aptas. Se facturan 5 créditos en caso de acierto de caché y 1 crédito en caso de fallo de caché. type: boolean maxAge: default: 172800000 description: >- Devuelve una versión en caché de la página si su antigüedad es menor que este valor en milisegundos. Si la versión en caché de la página es más antigua que este valor, se hará scraping de la página. Si no necesitas datos extremadamente recientes, habilitar esto puede acelerar tus procesos de scraping hasta un 500 %. El valor predeterminado es de 2 días. type: integer minAge: description: |- <[ { "key": "0", "translation": "Cuando se establece, la solicitud solo consulta la caché y nunca inicia una nueva extracción. El valor se expresa en milisegundos y especifica la antigüedad mínima que deben tener los datos almacenados en caché. Si existen datos en caché que coinciden, se devuelven al instante. Si no se encuentran datos en caché, se devuelve un 404 con el código de error SCRAPE_NO_CACHED_DATA. Establécelo en 1 para aceptar cualquier dato en caché, independientemente de su antigüedad." } ] type: integer mobile: default: false description: >- Defínelo en true si quieres emular el scraping desde un dispositivo móvil. Útil para probar páginas responsive y tomar capturas de pantalla móviles. type: boolean onlyCleanContent: default: false description: >- Beta. Ejecuta una pasada adicional basada en LLM sobre el markdown generado para eliminar el contenido repetitivo residual que `onlyMainContent` puede pasar por alto (banners de cookies, bloques de anuncios, widgets para compartir en redes sociales, rutas de navegación, suscripciones a boletines, secciones de comentarios y listas de artículos relacionados). Se conservan los encabezados, las listas, las tablas, los bloques de código, las referencias de imágenes y los enlaces en línea. Puede combinarse con `onlyMainContent` (la configuración más habitual) o usarse por sí solo. Se omite con una advertencia cuando el markdown supera el límite de tokens de salida del modelo de limpieza (se conserva el markdown original). No es compatible con solicitudes con retención cero de datos. type: boolean onlyMainContent: default: true description: >- Devuelve solo el contenido principal de la página, excluyendo encabezados, navegación, pies de página, etc. Es un filtro determinista a nivel de HTML que se aplica antes de generar el markdown; no interviene ningún LLM. type: boolean parsers: default: - pdf description: >- Controla cómo se procesan los archivos durante el scraping. Cuando se incluye "pdf" (valor predeterminado), se extrae el contenido del PDF y se convierte a formato Markdown, con la facturación basada en el número de páginas (1 crédito por página). Cuando se pasa un array vacío, el archivo PDF se devuelve codificado en base64 con una tarifa fija de 1 crédito por todo el PDF. items: oneOf: - additionalProperties: false properties: maxPages: description: >- Número máximo de páginas del PDF que se pueden analizar. Debe ser un número entero positivo de hasta 10 000. maximum: 10000 minimum: 1 type: integer mode: default: auto description: >- Modo de procesamiento de PDF. "fast": solo extracción de texto (usa el texto incrustado; es la opción más rápida). "auto" (predeterminado): primero intenta la extracción rápida y, si es necesario, recurre a OCR. "ocr": fuerza el procesamiento con OCR en todas las páginas. enum: - fast - auto - ocr type: string type: enum: - pdf type: string required: - type type: object type: array profile: description: >- Habilita el almacenamiento persistente del navegador entre sesiones de scraping e interacción. Pasa un perfil al hacer scraping para conservar las cookies, localStorage y los datos de sesión. Las sesiones con el mismo nombre de perfil comparten el estado del navegador. properties: name: description: >- Un nombre para el perfil. Los scraping con el mismo nombre comparten el estado del navegador (cookies, localStorage y sesiones). maxLength: 128 minLength: 1 type: string saveChanges: default: true description: >- Cuando es true, el estado del navegador se vuelve a guardar en el perfil cuando se detiene la sesión de interacción. Establécelo en false para cargar los datos existentes sin escribir. Solo se permite una sesión de guardado a la vez. type: boolean required: - name type: object proxy: default: auto description: |- Especifica el tipo de proxy que se usará. - **basic**: Proxies para hacer scraping de sitios con poca o ninguna protección antibots. Son rápidos y suelen funcionar bien. - **enhanced**: Proxies avanzados para hacer scraping de sitios con soluciones antibots más sofisticadas. Son más lentos, pero más fiables en ciertos sitios. Pueden costar hasta 5 créditos por solicitud. - **auto**: Firecrawl reintentará automáticamente el scraping con proxies mejorados si el proxy básico falla. Si el reintento con **enhanced** tiene éxito, se cobrarán 5 créditos por el scraping. Si el primer intento con **basic** tiene éxito, solo se cobrará el coste normal. enum: - basic - enhanced - auto type: string redactPII: default: false description: >- Redacta la información de identificación personal del markdown devuelto. Pasa `true` para usar la configuración predeterminada, o un objeto para ajustar el modo, las entidades y el estilo de reemplazo. oneOf: - type: boolean - $ref: '#/components/schemas/RedactPIIOptions' removeBase64Images: default: true description: >- Elimina todas las imágenes en base64 de la salida en markdown, que puede ser excesivamente larga. Esto no afecta a los formatos html ni rawHtml. El texto alternativo de la imagen permanece en la salida, pero la URL se sustituye por un marcador de posición. type: boolean skipTlsVerification: default: true description: Omitir la verificación de certificados TLS al realizar solicitudes. type: boolean storeInCache: default: true description: >- Si es true, la página se almacenará en el índice y la caché de Firecrawl. Establecerlo en false es útil si tu actividad de scraping puede plantear problemas relacionados con la protección de datos. El uso de algunos parámetros asociados con scraping de datos sensibles (por ejemplo, acciones, headers) hará que este parámetro sea false. type: boolean threatProtection: $ref: '#/components/schemas/ThreatProtectionOverride' timeout: default: 60000 description: >- Tiempo de espera en milisegundos para la solicitud. El mínimo es 1000 (1 segundo). El valor predeterminado es 60000 (60 segundos). El máximo es 300000 (300 segundos). maximum: 300000 minimum: 1000 type: integer waitFor: default: 0 description: >- Especifica un tiempo de espera en milisegundos antes de obtener el contenido, dando a la página tiempo suficiente para cargarse. Este tiempo de espera es adicional a la función de espera inteligente de Firecrawl. type: integer type: object Formats: default: - markdown description: >- Formatos de salida que se incluirán en la respuesta. Puedes especificar uno o varios formatos, ya sea como cadenas (p. ej., `'markdown'`) o como objetos con opciones adicionales (p. ej., `{ type: 'json', schema: {...} }`). Algunos formatos requieren configurar opciones específicas. Ejemplo: `['markdown', { type: 'json', schema: {...} }]`. items: oneOf: - properties: type: enum: - markdown type: string required: - type title: Markdown type: object - properties: type: enum: - summary type: string required: - type title: Summary type: object - properties: type: enum: - html type: string required: - type title: HTML type: object - properties: type: enum: - rawHtml type: string required: - type title: Raw HTML type: object - properties: type: enum: - links type: string required: - type title: Links type: object - properties: type: enum: - images type: string required: - type title: Images type: object - properties: fullPage: default: false description: >- Determina si se debe tomar una captura de pantalla de página completa (omitiendo viewport.height) o limitarla al viewport actual. type: boolean quality: description: >- La calidad de la captura de pantalla, del 1 al 100. 100 es la calidad más alta. type: integer type: enum: - screenshot type: string viewport: properties: height: description: Altura del viewport en píxeles type: integer width: description: El ancho del viewport en píxeles type: integer required: - width - height type: object required: - type title: Screenshot type: object - properties: prompt: description: El prompt que se utilizará para la salida en formato JSON type: string schema: description: >- El esquema que se utilizará para la salida en formato JSON. Debe ajustarse a [JSON Schema](https://json-schema.org/). type: object type: enum: - json type: string required: - type title: JSON type: object - properties: modes: description: >- El modo que se usará para el seguimiento de cambios. 'git-diff' proporciona un diff detallado y 'json' compara los datos JSON extraídos. items: enum: - git-diff - json type: string type: array prompt: description: >- Prompt que se usará para el seguimiento de cambios cuando se utilice el modo `json`. Si no se proporciona, se usará el prompt predeterminado. type: string schema: description: >- Esquema JSON para la extracción cuando se usa el modo `json`. Define la estructura de los datos que se van a extraer y comparar. Debe ajustarse a [JSON Schema](https://json-schema.org/). type: object tag: default: null description: >- Etiqueta que se utilizará para el seguimiento de cambios. Las etiquetas pueden separar el historial de seguimiento de cambios en “ramas” independientes, donde el seguimiento de cambios con una etiqueta específica solo se comparará con extracciones realizadas con la misma etiqueta. Si no se proporciona, se usará la etiqueta predeterminada (null). nullable: true type: string type: enum: - changeTracking type: string required: - type title: Change Tracking type: object - properties: type: enum: - branding type: string required: - type title: Branding type: object - properties: type: enum: - product type: string required: - type title: Product type: object - properties: type: enum: - menu type: string required: - type title: Menu type: object - description: >- Extrae audio (MP3) de URLs de video compatibles, p. ej., YouTube. Devuelve una URL firmada de GCS. properties: type: enum: - audio type: string required: - type title: Audio type: object - description: >- Extrae video en la mejor calidad de URLs de video compatibles, p. ej., YouTube. Devuelve una URL firmada de GCS. properties: type: enum: - video type: string required: - type title: Video type: object - description: >- Haz una question en lenguaje natural sobre la página. Devuelve la respuesta en el campo `answer` de la respuesta. properties: question: description: >- La question que se debe responder sobre la página. Máximo 10.000 caracteres. maxLength: 10000 type: string type: enum: - question type: string required: - type - question title: Question type: object - description: >- Encuentra texto fuente relevante en la página. Devuelve el texto seleccionado en el campo `highlights` de la respuesta. properties: query: description: >- La consulta de selección de texto que se ejecutará en la página. Máximo 10.000 caracteres. maxLength: 10000 type: string type: enum: - highlights type: string required: - type - query title: Highlights type: object type: array RedactPIIOptions: additionalProperties: false description: Opciones de ajuste para la redacción de IIP. properties: entities: description: >- Restringe la redacción a estas categorías de entidades. Si se omite, se redactan todas las entidades compatibles. items: $ref: '#/components/schemas/RedactPIIEntity' type: array mode: default: accurate description: >- Estrategia de redacción. `accurate` usa solo el modelo y está optimizada para la precisión, `aggressive` aumenta la cobertura con heurísticas adicionales, y `fast` usa heurísticas sin llamar al modelo. enum: - accurate - aggressive - fast type: string replaceStyle: default: tag description: >- `tag` reemplaza los fragmentos por marcadores como ``, `mask` reemplaza los caracteres por `*` y `remove` elimina el texto del fragmento. enum: - tag - mask - remove type: string type: object ThreatProtectionOverride: description: >- Anulación por solicitud de [Protección contra amenazas](https://docs.firecrawl.dev/features/threat-protection). Los campos que proporciones reemplazan los campos correspondientes de la política de tu organización solo para esta solicitud; los campos omitidos conservan sus valores a nivel de organización. Requiere que Protección contra amenazas esté habilitada para tu equipo (función enterprise); de lo contrario, la solicitud se rechaza con un 403. Si tu organización ha deshabilitado las anulaciones por solicitud, cualquier solicitud que incluya este objeto se rechaza con un 403. Si Protección contra amenazas se aplica de forma obligatoria a tu equipo, `mode` no puede establecerse en `off`. properties: blacklist: description: >- Dominios que siempre se deben bloquear, como dominios simples (`example.com`) o patrones con comodines (`*.example.com`). Sin protocolo, ruta ni puerto. items: type: string maxItems: 1000 type: array blockedTlds: description: >- Dominios de nivel superior que se bloquean directamente, en minúsculas y sin el punto inicial (p. ej., `zip`). items: type: string maxItems: 1000 type: array failurePolicy: description: >- Qué hacer cuando no se puede acceder al clasificador: `closed` bloquea la solicitud; `open` la permite. enum: - open - closed type: string mode: description: >- Modo de análisis de dominios para esta solicitud. `normal` comprueba los dominios con Google Web Risk (+2 créditos por cada dominio analizado). enum: - 'off' - normal type: string riskScoreThreshold: description: >- Puntuación de riesgo normalizada (0–100) a partir de la cual un veredicto del clasificador bloquea el dominio. Cuanto más baja sea, más estricta será. example: 75 maximum: 100 minimum: 0 type: integer whitelist: description: >- Dominios que siempre se deben permitir, como dominios simples o patrones con comodines. Tiene prioridad sobre cualquier otra regla. items: type: string maxItems: 1000 type: array title: Threat Protection Override type: object RedactPIIEntity: description: >- Categorías públicas de entidades de IIP compatibles con la redacción de Firecrawl. enum: - PERSON - EMAIL - PHONE - LOCATION - FINANCIAL - SECRET type: string securitySchemes: bearerAuth: scheme: bearer type: http ````