> ## 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. # Criar Monitor > Cria um monitor de dados: uma vigilância sempre ativa que traz continuamente os sinais de negócio que importam para você — novas vagas de emprego, notícias, anúncios ou movimentos de expansão de mercado — a partir das empresas e filtros que você define, enriquece cada correspondência com dados de empresa e contato, e a entrega ao seu destino (e-mail ou webhook) na programação escolhida. Configure campo a campo, ou descreva todo o monitor em uma única frase em linguagem natural com `query`, que é interpretada na configuração dentro da mesma requisição. ## OpenAPI ````yaml pt-openapi POST /monitors/create openapi: 3.0.0 info: description: >- A API Pubrio entrega inteligência de expansão de mercado — sinais em tempo real que indicam quando uma empresa entra em um novo mercado — além dos dados de empresas e pessoas por trás desses sinais. Pesquise, consulte e enriqueça contas e contatos, e assine sinais de movimentação tipados e datados em mais de 200 mercados. version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/pt-BR/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/pt-BR/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: Informações do perfil da equipe e estatísticas de uso - name: Enrichment description: Enriqueça registros de pessoas e empresas com dados B2B detalhados - name: Lookalike description: Encontre empresas semelhantes a uma empresa específica - name: Search description: Pesquise pessoas, empresas, vagas, notícias e anúncios com filtros - name: Lookup description: >- Consulte informações detalhadas de pessoas, empresas, vagas, notícias, anúncios e tecnologias específicas - name: LinkedIn description: >- Consulte dados de pessoas e empresas por meio de URLs de perfil do LinkedIn - name: Redeem description: >- Resgate créditos para desbloquear detalhes de contato de pessoas (individual e em lote) - name: Channels description: >- Gerencie templates de canais de outreach (criar, atualizar, excluir, listar) - name: Monitor description: >- Crie e gerencie monitores de dados com webhooks, estatísticas e processamento - name: Filters description: >- Obtenha os valores de filtro disponíveis para os parâmetros de busca (tecnologias, localizações, verticais etc.) - name: API Keys description: >- Liste e inspecione logs de requisições da API e análises de uso das chaves de API - name: Insights description: Insights agregados de sinais para empresas (vagas, notícias, anúncios). - name: Export description: Exportações de dados em massa (consomem créditos). - name: Expansion description: >- Inteligência de expansão de mercado de empresas: sinais, estágios, mercados e exportações. externalDocs: description: >- A API Pubrio é usada para pesquisar, pré-visualizar e enriquecer contatos e contas. O banco de dados Pubrio oferece dados extensos de contatos B2B e inteligência de vendas. url: https://docs.pubrio.com paths: /monitors/create: post: tags: - Monitor summary: Criar um monitor description: >- Cria um monitor de dados: uma vigilância sempre ativa que traz continuamente os sinais de negócio que importam para você — novas vagas de emprego, notícias, anúncios ou movimentos de expansão de mercado — a partir das empresas e filtros que você define, enriquece cada correspondência com dados de empresa e contato, e a entrega ao seu destino (e-mail ou webhook) na programação escolhida. Configure campo a campo, ou descreva todo o monitor em uma única frase em linguagem natural com `query`, que é interpretada na configuração dentro da mesma requisição. operationId: monitors_create parameters: [] requestBody: required: true content: application/json: schema: type: object properties: name: type: string description: Nome do monitor. description: type: string description: Descrição do monitor. status: type: string description: >- Status do ciclo de vida com o qual criar o monitor. O padrão é `active`. Use `draft` para salvar um monitor incompleto: apenas `name` é obrigatório, a validação é adiada até a ativação, e um rascunho nunca é executado. enum: - draft - active - paused - inactive default: active detection_mode: type: string description: >- Como os sinais são detectados. `signal_first` varre o mercado de forma ampla; `company_first` acompanha uma lista de contas nomeadas e exige ao menos uma empresa, domínio ou URL do LinkedIn. **Imutável após a criação** — alterá-lo em um monitor existente retorna `40021`. Crie um novo monitor em vez disso. enum: - company_first - signal_first signal_types: type: array items: type: string enum: - jobs - news - advertisements - expansions description: Tipos de sinais a monitorar. signal_filters: type: array items: type: object required: - signal_type properties: signal_type: type: string enum: - jobs - news - advertisements - expansions description: Qual fluxo esta entrada filtra. filters: type: object description: >- Filtros para este fluxo. `jobs`, `news` e `advertisements` recebem os parâmetros de [Job Search](/pt/api-reference/endpoint/companies/job_search), [News Search](/pt/api-reference/endpoint/companies/news_search) e [Advertisement Search](/pt/api-reference/endpoint/companies/advertisements_search). `expansions` recebe o vocabulário de [Expansion Search](/pt/api-reference/endpoint/expansions/market_lookup): `froms` / `tos`, `window_days`, `stages`, `scopes`, `momentum`, `freshness`, `signal_types`, `signal_subtypes`, `signal_strengths`, `source_types`. Resolva os slugs em [Expansion Reference](/pt/api-reference/endpoint/expansions/types). description: Uma entrada por fluxo de sinal que o monitor observa. example: - signal_type: jobs filters: locations: - US - signal_type: news filters: locations: - US - signal_type: advertisements filters: target_locations: - US - signal_type: expansions filters: tos: - US stages: - expanding - scaling signal_types: - HIRE - EXEC signal_strengths: - high - very_high company_filters: type: object description: >- Filtros globais de empresa aplicados como uma segunda camada em todos os tipos de sinal. Aceita os mesmos parâmetros do endpoint [Company Search](/pt/api-reference/endpoint/companies/search) — localizações, número de funcionários, tecnologias, verticais e mais. example: locations: - US employees: - - 501 - 1000 - - 1001 - 5000 companies: type: array items: type: string format: uuid description: >- Lista de UUIDs de domain_search_id de empresas a monitorar. Usado principalmente no modo company_first para especificar empresas-alvo. Você também pode usar `domains` ou `linkedin_urls` como alternativas — apenas um dos três é obrigatório. domains: type: array items: type: string description: >- Lista de domínios de empresas a monitorar (por exemplo, ["openai.com", "google.com"]). Alternativa a `companies` — a Pubrio resolve esses valores para as empresas correspondentes. Apenas um dos parâmetros `companies`, `domains` ou `linkedin_urls` é obrigatório. linkedin_urls: type: array items: type: string format: uri description: >- Lista de URLs de empresas no LinkedIn a monitorar (por exemplo, ["https://linkedin.com/company/pubrio"]). Alternativa a `companies` — a Pubrio resolve esses valores para as empresas correspondentes. Apenas um dos parâmetros `companies`, `domains` ou `linkedin_urls` é obrigatório. is_company_enrichment: type: boolean description: Se deve enriquecer dados de empresa nos resultados. is_people_enrichment: type: boolean description: Se deve enriquecer dados de pessoas nos resultados. people_enrichment_configs: type: array items: type: object description: >- Array de camadas de enriquecimento de pessoas. Cada camada executa uma busca de pessoas independente. Contém `max_people_to_return` (1-25), `people_contact_types` (array — refere-se aos tipos de contato de [Redeem](/pt/api-reference/endpoint/redeem/people): email-work, email-personal, phone) e `filters` (mesmos parâmetros do endpoint [People Search](/pt/api-reference/endpoint/people/search)). example: - filters: people_locations: - US max_people_to_return: 3 people_contact_types: - email-work destination_type: type: string description: Tipo de destino de entrega. enum: - webhook - email - sequences destination_config: type: object description: >- Configuração do destino. Para webhook: exige `webhook_url` (string), com `headers` (objeto) e `body` (objeto) opcionais. Para email: aceita `email` (string) ou `emails` (array de strings). Para sequences: exige `sequence_identifier` (string) mais ao menos um de `is_people_search_enrolled` / `is_company_contact_enrolled` definido como true. example: webhook_url: https://your-webhook.com/endpoint headers: Authorization: Bearer token body: pipeline: my-webhook frequency_minute: type: integer description: >- Frequência de acionamento em minutos. Mín: 0, Máx: 10080, Padrão: 0. minimum: 0 maximum: 10080 default: 0 max_failure_trigger: type: integer description: >- Número máximo de falhas consecutivas antes de pausar o monitor. Mín: 1, Máx: 10, Padrão: 5. minimum: 1 maximum: 10 default: 5 max_daily_trigger: type: integer description: >- Número máximo de acionamentos por dia. Mín: 0, Máx: 86400, Padrão: 500. minimum: 0 maximum: 86400 default: 500 max_records_per_trigger: type: integer description: >- Controla o número máximo de registros entregues por acionamento. Valores menores reduzem o tamanho do payload por entrega, o que é recomendado para conjuntos de resultados grandes ou integrações com limite de taxa. Mín: 1, Máx: 100, Padrão: 25. Veja [Setting up Webhooks](/pt/developer-guides/setting-up-webhooks) para orientações. minimum: 1 maximum: 100 default: 25 notification_email: type: string format: email description: Endereço de e-mail para notificações de falha do monitor. max_retry_per_trigger: type: integer description: >- Número máximo de novas tentativas por acionamento. Mín: 0, Máx: 3, Padrão: 1. minimum: 0 maximum: 3 default: 1 retry_delay_second: type: integer description: >- Intervalo entre novas tentativas, em segundos. Mín: 1, Máx: 5, Padrão: 1. minimum: 1 maximum: 5 default: 1 query: type: string maxLength: 2000 description: >- Uma descrição em linguagem natural do monitor (em qualquer idioma), por exemplo "monitor companies expanding into Japan, get C-level people with their work email, and email alerts to me@company.com in real time". É interpretada nos campos abaixo (detection_mode, signal_types, signal_filters, people_enrichment_configs, destination_type/destination_config, frequency_minute) na mesma requisição. Qualquer campo também passado explicitamente substitui o valor interpretado. Se o texto não for um pedido de monitor, a chamada retorna 400. Limitado a 2000 caracteres. deep: type: boolean description: >- Opcional, usado apenas com `query`. Executa a passagem de reflexão para maior precisão de interpretação (padrão true; aproximadamente dobra a latência de interpretação). Defina false para uma única passagem mais rápida. anyOf: - title: Natural language required: - query - title: Structured fields required: - name - detection_mode - signal_types - destination_type - destination_config - title: Draft required: - name - status responses: '200': description: Resposta bem-sucedida contendo os detalhes do monitor recém-criado. content: application/json: schema: type: object properties: data: type: object properties: monitor_id: type: string format: uuid description: Identificador único do monitor recém-criado. name: type: string description: Nome do monitor. description: type: string description: Descrição do monitor. detection_mode: type: string description: 'Modo de detecção: ''company_first'' ou ''signal_first''.' signal_types: type: array items: type: string description: Tipos de sinais que este monitor observa. signal_filters: type: array items: type: object description: >- Filtros por tipo de sinal, conforme armazenados. Ao criar com `query`, isto é o que sua frase foi interpretada como — confira para confirmar que o monitor observa o que você pretendia. company_filters: type: object description: >- Filtros de perfil de empresa aplicados a cada sinal correspondente. companies: type: array items: type: string description: Empresas observadas (company_first). is_company_enrichment: type: boolean description: >- Se as correspondências são enriquecidas com detalhes de empresa. is_people_enrichment: type: boolean description: >- Se as correspondências são enriquecidas com pessoas e contatos. people_enrichment_configs: type: array items: type: object description: >- Configurações de enriquecimento de pessoas, conforme armazenadas. destination_type: type: string description: Tipo de destino de entrega. destination_config: type: object description: >- Detalhes do destino de entrega (e-mails, ou URL de webhook). frequency_minute: type: integer description: Frequência de execução do monitor, em minutos. notification_email: type: string nullable: true description: Endereço notificado sobre o próprio monitor. max_retry_per_trigger: type: integer description: Novas tentativas permitidas por acionamento. retry_delay_second: type: integer description: Intervalo entre novas tentativas, em segundos. max_records_per_trigger: type: integer description: Número máximo de registros entregues por acionamento. max_daily_trigger: type: integer description: Número máximo de acionamentos por dia. max_failure_trigger: type: integer description: Falhas consecutivas até o monitor parar. status: type: string enum: - draft - active - paused - inactive description: >- Status do ciclo de vida com o qual o monitor foi criado. masked_signature: type: string description: Assinatura de webhook mascarada para exibição. created_at: type: string format: date-time description: Timestamp de criação do monitor. signature: type: string format: uuid description: >- Assinatura de webhook para verificar payloads. Retornada apenas na criação. example: data: monitor_id: c9cd5421-b327-4243-9cd7-8b341b3da8bd name: Expansion signals → JP description: null detection_mode: signal_first signal_types: - expansions signal_filters: - signal_type: expansions filters: tos: - JP 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 destination_type: email destination_config: emails: - me@company.com frequency_minute: 5 notification_email: null max_retry_per_trigger: 3 retry_delay_second: 60 max_records_per_trigger: 100 max_daily_trigger: 24 max_failure_trigger: 5 status: active masked_signature: 5••••••••••••••8b8 created_at: '2026-07-16T10:27:40.469Z' signature: 52209a0d-f1c8-4111-a685-ac86edc678b8 '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: responses: general_error: description: >- Requisição inválida. A requisição estava malformada ou continha parâmetros inválidos. Verifique o código de erro e a mensagem para mais detalhes. content: application/json: schema: required: - code - message - details type: object properties: code: example: 40001 type: integer message: example: >- Os erros e códigos variam de acordo com o cenário; consulte a documentação para mais informações. type: string details: type: object rate_limit_error: description: >- Limite de requisições excedido. Foram feitas requisições em excesso em um determinado período de tempo. Tente novamente após a janela do limite de requisições ser reiniciada. content: application/json: schema: required: - error type: object properties: error: example: >- Limite de requisições excedido. Aguarde e tente novamente mais tarde. type: string server_error: description: >- Erro interno do servidor. Ocorreu um erro inesperado no servidor. Entre em contato com o suporte caso o erro persista. content: application/json: schema: required: - error type: object properties: error: example: Ocorreu um erro inesperado no servidor. type: string securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- Um token de API exclusivo que representa as ações que você realiza por meio da API e as permissões e operações correspondentes. Você pode criá-lo na seção [Configurações](https://dashboard.pubrio.com/#/settings/). in: header ````