{
  "openapi": "3.0.1",
  "info": {
    "title": "Brazil New Business Leads",
    "description": "Discover newly opened Brazilian companies before your competitors. Filter by company age, location, CNAE, and size, with structured CNPJ data and available contact information for B2B prospecting.",
    "version": "1.0",
    "x-build-id": "Nry4uJs4wxXkjuqZy"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/basta_compilar~brazil-fresh-business-leads/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-basta_compilar-brazil-fresh-business-leads",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/basta_compilar~brazil-fresh-business-leads/runs": {
      "post": {
        "operationId": "runs-sync-basta_compilar-brazil-fresh-business-leads",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/basta_compilar~brazil-fresh-business-leads/run-sync": {
      "post": {
        "operationId": "run-sync-basta_compilar-brazil-fresh-business-leads",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "maxCompanyAgeDaysPreset": {
            "title": "Maximum company age",
            "enum": [
              "7",
              "15",
              "30",
              "60",
              "90",
              "180",
              "365",
              "custom"
            ],
            "type": "string",
            "description": "Only return companies opened within this period. This is the main freshness control for the Actor."
          },
          "maxCompanyAgeDays": {
            "title": "Custom maximum company age (days)",
            "minimum": 1,
            "maximum": 3650,
            "type": "integer",
            "description": "Used when Maximum company age is Custom, or when set directly in JSON input. Exact day count between opening date and run date. Default: 30."
          },
          "openedAfter": {
            "title": "Opened after",
            "type": "string",
            "description": "Optional lower bound for opening date (YYYY-MM-DD). Combined with maxCompanyAgeDays — both must match."
          },
          "openedBefore": {
            "title": "Opened before",
            "type": "string",
            "description": "Optional upper bound for opening date (YYYY-MM-DD). Combined with maxCompanyAgeDays — both must match."
          },
          "states": {
            "title": "States (UF)",
            "uniqueItems": true,
            "type": "array",
            "description": "Brazilian state codes, e.g. SP, RJ, MG. Empty array or omitted = search all Brazil (no state filter).",
            "items": {
              "type": "string",
              "minLength": 2,
              "maxLength": 2
            }
          },
          "cities": {
            "title": "Cities",
            "uniqueItems": true,
            "type": "array",
            "description": "City names (without UF), e.g. Campinas, Hortolândia. Empty array or omitted = no city filter (Actor may auto-shard mid-size cities for better matriz discovery).",
            "items": {
              "type": "string",
              "minLength": 2,
              "maxLength": 80
            }
          },
          "segments": {
            "title": "Business segments",
            "uniqueItems": true,
            "type": "array",
            "description": "Filter by industry segment. Includes Orzu service niches, popular shortcuts, and all IBGE CNAE divisions. Empty = any segment.",
            "items": {
              "type": "string",
              "enum": [
                "ar_condicionado_refrigeracao",
                "eletricistas_instaladores",
                "energia_solar",
                "reformas_empreiteiros",
                "serralherias_vidracarias",
                "seguranca_eletronica",
                "pintores",
                "marcenaria_moveis_planejados",
                "encanadores",
                "montadores_moveis",
                "dedetizadoras",
                "limpeza_residencial_comercial",
                "jardinagem_paisagismo",
                "manutencao_piscinas",
                "manutencao_predial",
                "instalacao_redes_automacao",
                "mecanicos_oficinas",
                "funilaria_estetica_automotiva",
                "fotografos_videomakers",
                "designers_social_media",
                "agencias_marketing",
                "assistencia_tecnica_ti",
                "buffets_eventos",
                "djs_musicos_eventos",
                "chaveiros",
                "profissionais_independentes",
                "restaurantes_bares",
                "alimentacao_padarias",
                "beleza_estetica",
                "saude_clinicas",
                "farmacias",
                "construcao_reformas",
                "imobiliarias",
                "educacao_cursos",
                "academias_esportes",
                "pet_veterinaria",
                "marketing_publicidade",
                "contabilidade_advocacia",
                "transporte_logistica",
                "limpeza_conservacao",
                "varejo_moda",
                "varejo_geral",
                "automotivo",
                "hotelaria_turismo",
                "agricultura",
                "producao_florestal",
                "pesca_aquicultura",
                "extracao_carvao",
                "extracao_petroleo_gas",
                "extracao_minerais_metalicos",
                "extracao_minerais_nao_metalicos",
                "apoio_extracao",
                "fabricacao_alimentos",
                "fabricacao_bebidas",
                "fabricacao_fumo",
                "fabricacao_texteis",
                "confeccao_vestuario",
                "fabricacao_couro_calcados",
                "fabricacao_madeira",
                "fabricacao_papel",
                "impressao_reproducao",
                "coque_petroleo_biocombustiveis",
                "fabricacao_quimicos",
                "fabricacao_farmoquimicos",
                "fabricacao_borracha_plastico",
                "fabricacao_minerais_nao_metalicos",
                "metalurgia",
                "produtos_de_metal",
                "equipamentos_informaticos_eletronicos",
                "maquinas_aparelhos_eletricos",
                "maquinas_equipamentos",
                "veiculos_automotores",
                "outros_equipamentos_transporte",
                "fabricacao_moveis",
                "produtos_diversos",
                "manutencao_maquinas_equipamentos",
                "eletricidade_gas",
                "captacao_agua",
                "esgoto",
                "coleta_residuos",
                "descontaminacao",
                "construcao_edificios",
                "obras_infraestrutura",
                "servicos_especializados_construcao",
                "comercio_reparacao_veiculos",
                "comercio_atacadista",
                "comercio_varejista",
                "transporte_terrestre",
                "transporte_aquaviario",
                "transporte_aereo",
                "armazenagem_transporte_apoio",
                "correio_entregas",
                "alojamento_hoteis",
                "alimentacao_restaurantes",
                "edicao",
                "cinema_musica_video",
                "radio_tv",
                "telecomunicacoes",
                "tecnologia_software",
                "servicos_informacao",
                "servicos_financeiros",
                "seguros_previdencia",
                "atividades_auxiliares_financeiras",
                "atividades_imobiliarias",
                "juridica_contabil",
                "consultoria_gestao",
                "arquitetura_engenharia",
                "pesquisa_desenvolvimento",
                "publicidade_market_research",
                "outras_atividades_profissionais",
                "veterinaria",
                "alugueis_nao_imobiliarios",
                "selecao_locacao_mao_de_obra",
                "agencias_viagem_turismo",
                "vigilancia_seguranca",
                "servicos_para_edificios",
                "servicos_escritorio_apoio",
                "administracao_publica",
                "educacao",
                "saude_humana",
                "assistencia_internacao",
                "assistencia_social_sem_internacao",
                "artes_espetaculos",
                "patrimonio_cultural_museus",
                "jogos_de_azar",
                "esportes_recreacao",
                "organizacoes_associativas",
                "reparacao_objetos_pessoais",
                "outros_servicos_pessoais",
                "servicos_domesticos",
                "organismos_internacionais"
              ],
              "enumTitles": [
                "Ar-condicionado e refrigeração",
                "Eletricistas e instaladores",
                "Energia solar",
                "Pedreiros, reformas e empreiteiros",
                "Serralherias e vidraçarias",
                "Câmeras, alarmes e segurança eletrônica",
                "Pintores",
                "Marcenaria e móveis planejados",
                "Encanadores",
                "Montadores de móveis",
                "Dedetizadoras",
                "Limpeza residencial e comercial",
                "Jardinagem e paisagismo",
                "Manutenção de piscinas",
                "Manutenção predial",
                "Instalação de internet, redes e automação residencial",
                "Mecânicos e oficinas",
                "Funilaria, estética automotiva e detailers",
                "Fotógrafos e videomakers",
                "Designers e social media",
                "Agências de marketing",
                "Técnicos de informática e assistência técnica",
                "Buffets, decoradores e profissionais de eventos",
                "DJs, músicos e serviços para eventos",
                "Chaveiros",
                "Personal trainers, consultores e profissionais independentes",
                "Restaurantes, bares e lanchonetes",
                "Padarias, confeitarias e comércio de alimentos",
                "Beleza, estética e barbearia",
                "Clínicas e consultórios de saúde",
                "Farmácias e drogarias",
                "Construção, reformas e instalações",
                "Imobiliárias e corretagem",
                "Educação e cursos",
                "Academias e esportes",
                "Pet shops e veterinária",
                "Marketing e publicidade",
                "Contabilidade e advocacia",
                "Transporte e logística",
                "Limpeza e conservação",
                "Varejo de moda e calçados",
                "Varejo geral e e-commerce",
                "Automotivo (comércio e oficinas)",
                "Hotelaria e turismo",
                "Agricultura, pecuária e serviços relacionados",
                "Produção florestal",
                "Pesca e aquicultura",
                "Extração de carvão mineral",
                "Extração de petróleo e gás natural",
                "Extração de minerais metálicos",
                "Extração de minerais não metálicos",
                "Atividades de apoio à extração de minerais",
                "Fabricação de produtos alimentícios",
                "Fabricação de bebidas",
                "Fabricação de produtos do fumo",
                "Fabricação de produtos têxteis",
                "Confecção de artigos do vestuário e acessórios",
                "Preparação de couros e fabricação de calçados",
                "Fabricação de produtos de madeira",
                "Fabricação de celulose, papel e produtos de papel",
                "Impressão e reprodução de gravações",
                "Coque, derivados de petróleo e biocombustíveis",
                "Fabricação de produtos químicos",
                "Fabricação de produtos farmoquímicos e farmacêuticos",
                "Fabricação de produtos de borracha e de material plástico",
                "Fabricação de produtos de minerais não metálicos",
                "Metalurgia",
                "Fabricação de produtos de metal (exceto máquinas)",
                "Equipamentos de informática, produtos eletrônicos e ópticos",
                "Máquinas, aparelhos e materiais elétricos",
                "Máquinas e equipamentos",
                "Veículos automotores, reboques e carrocerias",
                "Outros equipamentos de transporte",
                "Fabricação de móveis",
                "Fabricação de produtos diversos",
                "Manutenção, reparação e instalação de máquinas e equipamentos",
                "Eletricidade, gás e outras utilidades",
                "Captação, tratamento e distribuição de água",
                "Esgoto e atividades relacionadas",
                "Coleta, tratamento e disposição de resíduos",
                "Descontaminação e outros serviços de gestão de resíduos",
                "Construção de edifícios",
                "Obras de infraestrutura",
                "Serviços especializados para construção (elétrica, hidráulica, acabamento)",
                "Comércio e reparação de veículos automotores e motocicletas",
                "Comércio atacadista (exceto veículos)",
                "Comércio varejista (exceto veículos)",
                "Transporte terrestre",
                "Transporte aquaviário",
                "Transporte aéreo",
                "Armazenagem e atividades auxiliares dos transportes",
                "Correio e outras atividades de entrega",
                "Alojamento (hotéis, pousadas, hostels)",
                "Alimentação (restaurantes, bares, lanchonetes, catering)",
                "Edição e edição integrada à impressão",
                "Atividades cinematográficas, produção de vídeos e de música",
                "Atividades de rádio e de televisão",
                "Telecomunicações",
                "Tecnologia da informação (software, consultoria em TI)",
                "Serviços de informação (portais, hospedagem, agências de notícias)",
                "Atividades de serviços financeiros",
                "Seguros, resseguros, previdência complementar e planos de saúde",
                "Atividades auxiliares dos serviços financeiros e seguros",
                "Atividades imobiliárias",
                "Atividades jurídicas, de contabilidade e auditoria",
                "Sedes de empresas e consultoria em gestão empresarial",
                "Serviços de arquitetura e engenharia; testes e análises técnicas",
                "Pesquisa e desenvolvimento científico",
                "Publicidade e pesquisa de mercado",
                "Outras atividades profissionais, científicas e técnicas",
                "Atividades veterinárias",
                "Aluguéis não imobiliários e gestão de ativos intangíveis",
                "Seleção, agenciamento e locação de mão de obra",
                "Agências de viagens, operadores turísticos e reservações",
                "Atividades de vigilância, segurança e investigação",
                "Serviços para edifícios e atividades paisagísticas (limpeza)",
                "Serviços de escritório e apoio administrativo",
                "Administração pública, defesa e seguridade social",
                "Educação",
                "Atividades de atenção à saúde humana",
                "Atividades de atenção à saúde humana integradas com assistência social (internação)",
                "Serviços de assistência social sem alojamento",
                "Atividades artísticas, criativas e de espetáculos",
                "Atividades ligadas ao patrimônio cultural e museus",
                "Atividades de exploração de jogos de azar e apostas",
                "Atividades esportivas e de recreação e lazer",
                "Atividades de organizações associativas",
                "Reparação de equipamentos de informática e objetos pessoais/domésticos",
                "Outras atividades de serviços pessoais (beleza, lavanderia, funerárias)",
                "Serviços domésticos",
                "Organismos internacionais e outras instituições extraterritoriais"
              ]
            }
          },
          "cnaes": {
            "title": "CNAE codes",
            "uniqueItems": true,
            "type": "array",
            "description": "Primary CNAE codes (7 digits or formatted, e.g. 4321500 or 4321-5/00). Merged with selected segments. Empty array or omitted = no CNAE filter.",
            "items": {
              "type": "string",
              "minLength": 4,
              "maxLength": 20
            }
          },
          "keywords": {
            "title": "Keywords",
            "uniqueItems": true,
            "type": "array",
            "description": "Match against legal name, trade name, and CNAE description (e.g. eletricista, construção). Empty array or omitted = no textual filter.",
            "items": {
              "type": "string",
              "minLength": 2,
              "maxLength": 80
            }
          },
          "companySizes": {
            "title": "Company sizes",
            "uniqueItems": true,
            "type": "array",
            "description": "Porte da empresa. Empty array or omitted = any size (no porte filter).",
            "items": {
              "type": "string",
              "enum": [
                "MEI",
                "ME",
                "EPP",
                "DEMAIS",
                "MICRO",
                "PEQUENO",
                "MEDIO",
                "GRANDE"
              ],
              "enumTitles": [
                "MEI",
                "ME",
                "EPP",
                "Demais",
                "Micro",
                "Pequeno",
                "Médio",
                "Grande"
              ]
            }
          },
          "legalNature": {
            "title": "Legal nature codes",
            "uniqueItems": true,
            "type": "array",
            "description": "Natureza jurídica codes (e.g. 2062 for LTDA). Empty = any.",
            "items": {
              "type": "string",
              "minLength": 3,
              "maxLength": 10
            }
          },
          "onlyActive": {
            "title": "Only active companies",
            "type": "boolean",
            "description": "Keep only companies with status ATIVA.",
            "default": true
          },
          "onlyHeadquarters": {
            "title": "Only headquarters (matriz)",
            "type": "boolean",
            "description": "Keep only CNPJ matriz (/0001). Tip: leave **Cities** empty — the Actor auto-shards mid-size cities (Campinas, Guarulhos…). Statewide SP without cities returns mostly chain filiais and yields 0 leads.",
            "default": true
          },
          "onlyWithPhone": {
            "title": "Require phone",
            "type": "boolean",
            "description": "Only keep leads that have at least one phone after processing.",
            "default": false
          },
          "onlyWithEmail": {
            "title": "Require email",
            "type": "boolean",
            "description": "Only keep leads that have at least one email after processing.",
            "default": false
          },
          "onlyWithWhatsapp": {
            "title": "Require confirmed WhatsApp",
            "type": "boolean",
            "description": "Only keep leads with WhatsApp status **CONFIRMED** (explicit wa.me / send / labeled WhatsApp text). Mobile registry numbers alone are LIKELY, not confirmed.",
            "default": false
          },
          "onlyWithWebsite": {
            "title": "Require website",
            "type": "boolean",
            "description": "Only keep leads that have a website.",
            "default": false
          },
          "enrichmentMode": {
            "title": "Enrichment mode",
            "enum": [
              "none",
              "smart",
              "deep"
            ],
            "type": "string",
            "description": "**none** (default / Store auto-test) — cheapest & fastest: registry / CNPJ data only; no websites, Google, Maps, social, or browser.\n**smart** — may discover publicly available contact information (website, Instagram, contact pages, link-in-bio; HTTP only).\n**deep** — more pages and deeper public contact search (higher cost).",
            "default": "none"
          },
          "whatsappDiscovery": {
            "title": "WhatsApp discovery",
            "enum": [
              "none",
              "smart",
              "deep"
            ],
            "type": "string",
            "description": "**none** (default / Store auto-test) — skip dedicated contact-channel discovery.\n**smart** — registry + Instagram/site + website/contact pages + link-in-bio when public (HTTP only).\n**deep** — also dedicated public search for contact links (higher cost). Availability is never guaranteed.",
            "default": "none"
          },
          "maxResults": {
            "title": "Maximum results",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Maximum number of leads written to the dataset (and basic-lead events charged). Default 10 keeps Store auto-tests fast and cheap — raise this for production runs.",
            "default": 10
          },
          "discoveryConcurrency": {
            "title": "Discovery concurrency",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "Parallel requests for company discovery / registry lookups.",
            "default": 5
          },
          "enrichmentConcurrency": {
            "title": "Enrichment concurrency",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "Parallel website enrichment requests (smart/deep modes).",
            "default": 3
          },
          "debug": {
            "title": "Debug mode",
            "type": "boolean",
            "description": "Emit detailed pipeline logs (discovery, age filter, enrichment, early stop). Never logs secrets.",
            "default": false
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}