> ## Documentation Index > Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt > Use this file to discover all available pages before exploring further. # Interpretar monitor > Obtén una vista previa de un monitor antes de crearlo: convierte una solicitud en lenguaje sencillo (en cualquier idioma) en una configuración de **borrador** validada que puedes inspeccionar, ajustar y luego enviar a [Create Monitor](/es/api-reference/endpoint/monitors/create). Es seguro llamarlo tantas veces como necesites: solo genera borradores y nunca persiste un monitor, envía alertas ni gasta créditos. Usa `intent` para elegir la acción; si se omite, se aplica una heurística de palabras clave en inglés y las entradas no reconocidas usan `create_monitor` de forma predeterminada. ## OpenAPI ````yaml es-openapi POST /monitors/interpret openapi: 3.0.0 info: description: >- La API de Pubrio ofrece inteligencia de expansión de mercado —señales en tiempo real que indican cuándo una empresa entra en un nuevo mercado— junto con los datos de empresas y personas que las respaldan. Busca, consulta y enriquece cuentas y contactos, y suscríbete a señales de movimiento tipadas y fechadas en más de 200 mercados. version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/es/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/es/get-in-touch license: name: Apache 2.0 url: http://www.apache.org/licenses/LICENSE-2.0.html servers: - url: https://api.pubrio.com security: - pubrio_api_key: [] tags: - name: Profile description: Información del perfil del espacio de trabajo y estadísticas de uso - name: Enrichment description: Enriquece registros de personas y empresas con datos B2B detallados - name: Lookalike description: Encuentra empresas similares a una empresa determinada - name: Search description: Busca personas, empresas, empleos, noticias y anuncios con filtros - name: Lookup description: >- Consulta información detallada de personas, empresas, empleos, noticias, anuncios y tecnologías específicos - name: LinkedIn description: Consulta datos de personas y empresas mediante URL de perfil de LinkedIn - name: Redeem description: >- Canjea créditos para desbloquear datos de contacto de personas (individual y por lotes) - name: Channels description: >- Gestiona plantillas de canales de contacto (crear, actualizar, eliminar, listar) - name: Monitor description: >- Crea y gestiona monitores de datos con webhooks, estadísticas y procesamiento - name: Filters description: >- Obtén los valores de filtro disponibles para los parámetros de búsqueda (tecnologías, ubicaciones, verticales, etc.) - name: API Keys description: >- Lista e inspecciona los registros de solicitudes a la API y las analíticas de uso de las claves de API - name: Insights description: >- Información agregada de señales para empresas (empleos, noticias, anuncios). - name: Export description: Exportaciones de datos masivas (sujetas a créditos). - name: Expansion description: >- Inteligencia de expansión de mercado de empresas: señales, etapas, mercados y exportaciones. externalDocs: description: >- La API de Pubrio se utiliza para buscar, previsualizar y enriquecer contactos y cuentas. La base de datos de Pubrio ofrece amplios datos de contactos B2B e inteligencia de ventas. url: https://docs.pubrio.com paths: /monitors/interpret: post: tags: - Monitor summary: Interpretar un monitor a partir de lenguaje natural description: >- Obtén una vista previa de un monitor antes de crearlo: convierte una solicitud en lenguaje sencillo (en cualquier idioma) en una configuración de **borrador** validada que puedes inspeccionar, ajustar y luego enviar a [Create Monitor](/es/api-reference/endpoint/monitors/create). Es seguro llamarlo tantas veces como necesites: solo genera borradores y nunca persiste un monitor, envía alertas ni gasta créditos. Usa `intent` para elegir la acción; si se omite, se aplica una heurística de palabras clave en inglés y las entradas no reconocidas usan `create_monitor` de forma predeterminada. operationId: interpretMonitor parameters: [] requestBody: required: true content: application/json: schema: type: object required: - query properties: query: type: string maxLength: 2000 description: >- La solicitud en lenguaje natural (en cualquier idioma), por ejemplo: "monitorea empresas que se están expandiendo a Japón, obtén personas de nivel C con su correo laboral, y envíame alertas por correo a me@company.com en tiempo real". Limitado a 2000 caracteres. intent: type: string enum: - create_monitor - dry_test - execute - analyze description: >- Qué acción realizar (independiente del idioma). `create_monitor` (predeterminado): devuelve una configuración de borrador. `dry_test`: borrador más un recuento de solo lectura de las señales que coinciden actualmente. `execute`: borrador más vista previa, marcado para confirmación (nunca se activa automáticamente). `analyze` (por ejemplo, "¿qué mercado, SG o JP?"): lo responde el agente analítico de expansión en lugar de crear un monitor. Si se omite, se usa una heurística de palabras clave en inglés; las entradas no reconocidas usan `create_monitor` de forma predeterminada. deep: type: boolean description: >- Ejecuta la pasada de reflexión para obtener mayor precisión (el valor predeterminado es true; aproximadamente duplica la latencia). Configúralo en false para una interpretación de una sola pasada más rápida. example: query: >- monitor companies expanding into Japan, get C-level people with their work email, and email alerts to me@company.com in real time responses: '200': description: El borrador interpretado. No se persiste nada. content: application/json: schema: type: object properties: data: type: object properties: intent: type: string enum: - create_monitor - dry_test - execute - analyze description: >- La acción resuelta (create_monitor / dry_test / execute / analyze). no_intent: type: boolean description: >- true cuando la solicitud no era una configuración de monitor (un saludo, algo fuera de tema o sin sentido); en ese caso `config` es null. config: type: object nullable: true description: >- La configuración de borrador del monitor, con la misma forma que el cuerpo de la solicitud de [Create Monitor](/es/api-reference/endpoint/monitors/create) (detection_mode, signal_types, signal_filters, people_enrichment_configs, destination_type/destination_config, frequency_minute, status "draft", etc.). Envíala a Create Monitor para activarla. También puede incluir `domains`/`linkedin_urls`/`company_names`, que Create Monitor resuelve a empresas. Es null cuando `no_intent` es true. missing_fields: type: array items: type: string description: >- Campos que aún se requieren antes de poder activar el monitor (por ejemplo, "destination", "signal_types", "companies"). Recopílalos en tu interfaz antes de enviarlos a Create Monitor. requires_confirmation: type: boolean description: >- true para la intención `execute`: la configuración está lista, pero el usuario debe confirmar antes de que la actives. preview: type: object nullable: true description: >- Presente para `dry_test` y `execute`: una estimación de solo lectura de cuántas señales coinciden actualmente, por tipo de señal, en los últimos 30 días (muestreado). No se gastan créditos. interpretation: type: object description: >- Eco de los campos sin procesar extraídos de la consulta, para visualización o depuración. example: data: intent: create_monitor no_intent: false config: detection_mode: signal_first signal_types: - expansions signal_filters: - signal_type: expansions filters: tos: - JP stages: - exploring - committing company_filters: {} companies: [] is_company_enrichment: false is_people_enrichment: true people_enrichment_configs: - max_people_to_return: 5 filters: management_levels: - c_suite people_contact_types: - email-work name: Expansion signals → JP destination_type: email destination_config: emails: - me@company.com frequency_minute: 5 status: draft missing_fields: [] requires_confirmation: false preview: null interpretation: signal_types: - expansions tos: - JP management_levels: - c_suite people_contact_types: - email-work destination_email: me@company.com is_realtime: true '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: responses: general_error: description: >- Solicitud incorrecta. La solicitud estaba mal formada o contenía parámetros no válidos. Consulta el código de error y el mensaje para más detalles. content: application/json: schema: required: - code - message - details type: object properties: code: example: 40001 type: integer message: example: >- Errors and codes will vary depending on the scenario, please see the documentation for information. type: string details: type: object rate_limit_error: description: >- Límite de tasa excedido. Se realizaron demasiadas solicitudes en un período de tiempo determinado. Vuelve a intentarlo después de que se restablezca la ventana de límite de tasa. content: application/json: schema: required: - error type: object properties: error: example: Request rate limit exceeded. Please wait and try again later. type: string server_error: description: >- Error interno del servidor. Se produjo un error inesperado en el servidor. Contacta con soporte si el error persiste. content: application/json: schema: required: - error type: object properties: error: example: An unexpected error occurred on the server. type: string securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- Un token de API único que representa las acciones que realizas a través de la API, junto con los permisos y operaciones correspondientes. Puedes crearlo en la sección [Configuración](https://dashboard.pubrio.com/#/settings/). in: header ````