{"openapi":"3.1.0","info":{"title":"API do Captário","version":"1.0.0","summary":"Sinais de compra de empresas brasileiras, com a prova da fonte oficial, e a base completa da Receita Federal.","description":"Sinais são fatos públicos e datados que costumam vir antes de uma compra (licitação ganha, contrato assinado ou vencendo, empresa ou filial nova, aumento de capital, obra nova e outros), cada um com o link do registro oficial.\n\nPlanos Pro, Equipe e Agro Equipe. A chave é criada em https://captario.com.br/integracoes e vai no cabeçalho Authorization: Bearer <chave>. Uma resposta nunca mostra mais do que o plano mostraria; cada linha de sinal, de base e cada ficha com contato contam na cota mensal de exportação.\n\nRegras de dados: CPF nunca aparece; sócios só com nome e qualificação; MEI e empresário individual ficam fora; empresas que pediram para sair não aparecem.\n\nTambém há um servidor MCP em https://captario.com.br/api/mcp para assistentes de IA (https://captario.com.br/mcp).","contact":{"name":"Captário","email":"contato@captario.com.br","url":"https://captario.com.br/api-e-ia"},"termsOfService":"https://captario.com.br/termos"},"servers":[{"url":"https://captario.com.br/api/v1"}],"security":[{"chave":[]}],"externalDocs":{"url":"https://captario.com.br/api-e-ia","description":"API e IA no Captário"},"paths":{"/sinais":{"get":{"operationId":"buscarSinais","summary":"Buscar sinais","description":"Empresas com sinal de compra recente, com os mesmos filtros do feed do app. Cada linha traz a data, o valor, o órgão e o link da fonte oficial.","parameters":[{"name":"descricao","in":"query","required":false,"schema":{"type":"string"},"description":"O público em texto livre, como \"construtoras de Goiás que ganharam licitação acima de 1 milhão\". Os outros filtros têm prioridade."},{"name":"tipos","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["HOMOLOGADO","CONTRATO_ASSINADO","ATA_ASSINADA","PRIMEIRA_VITORIA","CONTRATO_PERTO_DO_FIM","DIARIO_CONTRATO","SANCAO","EMPRESA_NOVA","MUDOU_PORTE","MUDOU_CNAE","MUDOU_ENDERECO","ENTROU_SIMPLES","SAIU_SIMPLES","AUMENTO_CAPITAL","MUDOU_SOCIOS","REATIVADA","NOVA_FILIAL","DIVIDA_ATIVA","LEILAO_BENS","PAGAMENTO_PUBLICO","LICITANTE","FORNECEDOR_CAMPANHA","OBRA_NOVA","ENERGIA_SOLAR","MERCADO_LIVRE_ENERGIA","ATIVIDADE_AMBIENTAL","LICENCA_AMBIENTAL","ALVARA_FUNCIONAMENTO","AUTORIZACAO_ANP","HABILITOU_COMEX","FINANCIAMENTO_BNDES","CAPTACAO_MERCADO","INCENTIVO_FISCAL","OUTORGA_TELECOM","REGISTRO_PRODUTO","NOVO_REGISTRO","MARCA_DEPOSITADA","PATENTE_PUBLICADA","SOFTWARE_REGISTRADO","CONTRATO_TECNOLOGIA","DESENHO_INDUSTRIAL","MARCA_VENCENDO","FATO_RELEVANTE","RECEITA_EM_ALTA","FUNDO_LANCADO","CORRESPONDENTE_BANCARIO","OUTORGA_AGUA","RECUPERACAO_JUDICIAL","FALENCIA","NOTICIA","VAGA_ABERTA","ADOTOU_TECNOLOGIA"]},"description":"Tipos de sinal. Aceita valores repetidos ou separados por vírgula."},"style":"form","explode":false},{"name":"ufs","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["AC","AL","AP","AM","BA","CE","DF","ES","GO","MA","MT","MS","MG","PA","PB","PR","PE","PI","RJ","RN","RS","RO","RR","SC","SP","SE","TO"]},"description":"UF onde o fato aconteceu (o órgão comprador, nas compras públicas). Aceita valores repetidos ou separados por vírgula."},"style":"form","explode":false},{"name":"ufsEmpresa","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["AC","AL","AP","AM","BA","CE","DF","ES","GO","MA","MT","MS","MG","PA","PB","PR","PE","PI","RJ","RN","RS","RO","RR","SC","SP","SE","TO"]},"description":"UF da empresa. Aceita valores repetidos ou separados por vírgula."},"style":"form","explode":false},{"name":"municipios","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"},"description":"Códigos IBGE de 7 dígitos. Aceita valores repetidos ou separados por vírgula."},"style":"form","explode":false},{"name":"valorMin","in":"query","required":false,"schema":{"type":"number"},"description":"Valor mínimo em reais."},{"name":"valorMax","in":"query","required":false,"schema":{"type":"number"},"description":"Valor máximo em reais."},{"name":"palavras","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"},"description":"Palavras no objeto da compra (qualquer uma). Aceita valores repetidos ou separados por vírgula."},"style":"form","explode":false},{"name":"cnaes","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"},"description":"Prefixos de CNAE da empresa (2 a 7 dígitos). Aceita valores repetidos ou separados por vírgula."},"style":"form","explode":false},{"name":"portes","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["ME","EPP","DEMAIS"]},"description":"Porte da empresa. Aceita valores repetidos ou separados por vírgula."},"style":"form","explode":false},{"name":"esferas","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["F","E","M","D"]},"description":"Esfera do órgão: Federal, Estadual, Municipal, Distrital. Aceita valores repetidos ou separados por vírgula."},"style":"form","explode":false},{"name":"dias","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":365},"description":"Janela em dias até hoje (padrão 30, limitada pela janela do plano)."},{"name":"ordem","in":"query","required":false,"schema":{"type":"string","enum":["recentes","valor","detectados"]}},{"name":"pagina","in":"query","required":false,"schema":{"type":"integer","minimum":1}},{"name":"porPagina","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100},"description":"Padrão 25."}],"responses":{"200":{"description":"Sinais encontrados.","content":{"application/json":{"schema":{"type":"object","properties":{"filtros":{"type":"object","description":"Os filtros aplicados."},"sinais":{"type":"array","items":{"$ref":"#/components/schemas/Sinal"}},"total":{"type":"integer"},"totalLimitado":{"type":"boolean","description":"O total passou do teto de contagem."},"pagina":{"type":"integer"},"cotaRestante":{"type":"integer","description":"Linhas que ainda cabem na cota do mês."}}}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"O plano ou o escopo da chave não libera a operação.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Cota mensal de linhas esgotada ou limite de chamadas.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/sinais/{id}":{"get":{"operationId":"lerSinal","summary":"Um sinal","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"O sinal, com a prova.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"O plano ou o escopo da chave não libera a operação.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"404":{"description":"Sinal não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Cota mensal de linhas esgotada ou limite de chamadas.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/empresas/{cnpj}":{"get":{"operationId":"fichaEmpresa","summary":"Ficha da empresa","description":"Cadastro público (Receita), compras públicas dos últimos 12 meses, sócios (só nome e qualificação), contato conforme o plano e os sinais recentes.","parameters":[{"name":"cnpj","in":"path","required":true,"schema":{"type":"string"},"description":"CNPJ com ou sem máscara (numérico ou alfanumérico)."}],"responses":{"200":{"description":"A ficha.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ficha"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"O plano ou o escopo da chave não libera a operação.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"404":{"description":"Empresa não encontrada.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Cota mensal de linhas esgotada ou limite de chamadas.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/fazendas/{codigo}":{"get":{"operationId":"fichaFazenda","summary":"Ficha do imóvel rural (Captário Agro)","description":"Pelo código do CAR: cadastro (SICAR, SIGEF, área e limites), áreas protegidas (embargos do IBAMA, terras indígenas, assentamentos, unidades de conservação), monitoramento (PRODES, focos de calor, área queimada, embargos do ICMBio, autos de infração, SINAFLOR), solo e clima (solo, relevo, pastagem, chuva, temperatura, veranicos, Monitor de Secas, NDVI), água e infraestrutura (outorgas, pivôs, rios, barragens, energia, aeródromos) e produção (safras, mineração, florestas públicas, sítios arqueológicos, quilombos, usinas, SIF, faixa de fronteira): 51 camadas em seis grupos, cada uma com estado (ok, indisponivel, sem_fonte), itens e GeoJSON das feições. Planos Pro, Equipe e Agro Equipe; 30 consultas por minuto. Nome de titular só quando é empresa.","parameters":[{"name":"codigo","in":"path","required":true,"schema":{"type":"string"},"description":"Código do CAR (UF-1234567-hash de 32 caracteres).","example":"GO-5208004-E072FF3B994D4DCFAC9A7E4B85F8871C"},{"name":"geojson","in":"query","required":false,"schema":{"type":"string","enum":["0","1"]},"description":"0 tira as feições das camadas (resposta menor)."}],"responses":{"200":{"description":"A ficha.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FichaFazenda"}}}},"400":{"description":"Código do CAR inválido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"Plano sem a consulta de fazendas.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"404":{"description":"Imóvel não encontrado no SICAR.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Muitas consultas por minuto.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"O SICAR não respondeu.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/fazendas":{"get":{"operationId":"fazendasNoPonto","summary":"Imóveis rurais num ponto","description":"Os imóveis com CAR que contêm a coordenada (código, município, área, situação), para achar o código e pedir a ficha. Planos Pro, Equipe e Agro Equipe.","parameters":[{"name":"lat","in":"query","required":true,"schema":{"type":"number"},"example":-15.54},{"name":"lon","in":"query","required":true,"schema":{"type":"number"},"example":-47.33}],"responses":{"200":{"description":"Os imóveis do ponto.","content":{"application/json":{"schema":{"type":"object","properties":{"imoveis":{"type":"array","items":{"type":"object","properties":{"codigo":{"type":"string"},"uf":{"type":"string"},"municipio":{"type":"string","nullable":true},"areaHa":{"type":"number","nullable":true},"status":{"type":"string","nullable":true},"condicao":{"type":"string","nullable":true},"tipo":{"type":"string","nullable":true}}}}}}}}},"400":{"description":"lat e lon fora do Brasil.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"Plano sem a consulta de fazendas.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/dominio/{dominio}":{"get":{"operationId":"empresasDoDominio","summary":"Empresas de um domínio","description":"Empresas cujo site conferido ou e-mail cadastrado na Receita usa o domínio. Provedor de e-mail gratuito não casa nada. Não conta na cota.","parameters":[{"name":"dominio","in":"path","required":true,"schema":{"type":"string"},"example":"exemplo.com.br"}],"responses":{"200":{"description":"Até 10 empresas.","content":{"application/json":{"schema":{"type":"object","properties":{"dominio":{"type":"string"},"empresas":{"type":"array","items":{"type":"object"}}}}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"O plano ou o escopo da chave não libera a operação.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Cota mensal de linhas esgotada ou limite de chamadas.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/base":{"get":{"operationId":"buscarBase","summary":"Base completa da Receita","description":"Empresas da base completa (não só as que têm sinal), com os filtros da aba \"Base completa\" do app.","parameters":[{"name":"texto","in":"query","required":false,"schema":{"type":"string"},"description":"Pedaço da razão social ou do nome fantasia."},{"name":"cnaes","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"},"description":"Prefixos de CNAE principal (2 a 7 dígitos). Aceita valores repetidos ou separados por vírgula."},"style":"form","explode":false},{"name":"ufs","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["AC","AL","AP","AM","BA","CE","DF","ES","GO","MA","MT","MS","MG","PA","PB","PR","PE","PI","RJ","RN","RS","RO","RR","SC","SP","SE","TO"]},"description":"Siglas de UF. Aceita valores repetidos ou separados por vírgula."},"style":"form","explode":false},{"name":"municipios","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"},"description":"Códigos IBGE de 7 dígitos. Aceita valores repetidos ou separados por vírgula."},"style":"form","explode":false},{"name":"portes","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["ME","EPP","DEMAIS"]},"description":"Porte. Aceita valores repetidos ou separados por vírgula."},"style":"form","explode":false},{"name":"aberturaDe","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"Aberta a partir de (AAAA-MM-DD)."},{"name":"aberturaAte","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"Aberta até (AAAA-MM-DD)."},{"name":"capitalMin","in":"query","required":false,"schema":{"type":"number"}},{"name":"capitalMax","in":"query","required":false,"schema":{"type":"number"}},{"name":"simples","in":"query","required":false,"schema":{"type":"string","enum":["sim","nao"]},"description":"Optante pelo Simples Nacional."},{"name":"comTelefone","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"comEmail","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"estabelecimento","in":"query","required":false,"schema":{"type":"string","enum":["matriz","filial"]}},{"name":"raiz","in":"query","required":false,"schema":{"type":"string"},"description":"Raiz do CNPJ (8 posições)."},{"name":"pi","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["marca","marca_vigor","marca_recente","marca_vencendo","patente","software","desenho"]},"description":"Propriedade intelectual no INPI (todas valem juntas). Aceita valores repetidos ou separados por vírgula."},"style":"form","explode":false},{"name":"classesNice","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"},"description":"Classes de Nice (1 a 45) de marca viva da empresa. Aceita valores repetidos ou separados por vírgula."},"style":"form","explode":false},{"name":"empregadosMin","in":"query","required":false,"schema":{"type":"integer","minimum":1},"description":"Empregados declarados à CVM a partir de (só companhias abertas)."},{"name":"sancao","in":"query","required":false,"schema":{"type":"boolean"},"description":"Sanção vigente no CEIS, CNEP, CEPIM ou leniência (CGU)."},{"name":"tcuIrregular","in":"query","required":false,"schema":{"type":"boolean"},"description":"Contas julgadas irregulares pelo TCU."},{"name":"sancionador","in":"query","required":false,"schema":{"type":"boolean"},"description":"Processo sancionador do Banco Central, ANAC, ANEEL ou ANP."},{"name":"emenda","in":"query","required":false,"schema":{"type":"boolean"},"description":"Recebeu emenda parlamentar."},{"name":"creditoFundos","in":"query","required":false,"schema":{"type":"boolean"},"description":"Emitiu dívida que está na carteira de fundos."},{"name":"ordem","in":"query","required":false,"schema":{"type":"string","enum":["capital","abertura","nome"]}},{"name":"pagina","in":"query","required":false,"schema":{"type":"integer","minimum":1}},{"name":"porPagina","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100},"description":"Padrão 25."}],"responses":{"200":{"description":"Empresas encontradas.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"O plano ou o escopo da chave não libera a operação.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Cota mensal de linhas esgotada ou limite de chamadas.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}}},"components":{"securitySchemes":{"chave":{"type":"http","scheme":"bearer","description":"Chave da conta (cp_…), criada em https://captario.com.br/integracoes."}},"schemas":{"FichaFazenda":{"type":"object","description":"Ficha do imóvel rural: imóvel (código, município, áreas, situação, centro, caixa), geometria (GeoJSON do perímetro), biomas, camadas (46, cada uma com id, grupo, rótulo, fonte, estado, modo, itens, resumo, nota, alerta e geojson) e consultadoEm.","properties":{"imovel":{"type":"object"},"geometria":{"type":"object"},"biomas":{"type":"array","items":{"type":"string"}},"camadas":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"grupo":{"type":"string","enum":["cadastro","protegidas","monitoramento","solo_clima","hidrico_infra","producao"]},"rotulo":{"type":"string"},"fonte":{"type":"string"},"estado":{"type":"string","enum":["ok","indisponivel","sem_fonte","em_breve"]},"modo":{"type":"string"},"itens":{"type":"array","items":{"type":"object"}},"resumo":{"type":"string","nullable":true},"alerta":{"type":"boolean"},"geojson":{"type":"object","nullable":true}}}},"indisponiveis":{"type":"array","items":{"type":"string"}},"consultadoEm":{"type":"string","format":"date-time"}}},"Erro":{"type":"object","properties":{"erro":{"type":"string"}},"required":["erro"]},"Sinal":{"type":"object","properties":{"id":{"type":"string"},"tipo":{"type":"string","enum":["HOMOLOGADO","CONTRATO_ASSINADO","ATA_ASSINADA","PRIMEIRA_VITORIA","CONTRATO_PERTO_DO_FIM","DIARIO_CONTRATO","SANCAO","EMPRESA_NOVA","MUDOU_PORTE","MUDOU_CNAE","MUDOU_ENDERECO","ENTROU_SIMPLES","SAIU_SIMPLES","AUMENTO_CAPITAL","MUDOU_SOCIOS","REATIVADA","NOVA_FILIAL","DIVIDA_ATIVA","LEILAO_BENS","PAGAMENTO_PUBLICO","LICITANTE","FORNECEDOR_CAMPANHA","OBRA_NOVA","ENERGIA_SOLAR","MERCADO_LIVRE_ENERGIA","ATIVIDADE_AMBIENTAL","LICENCA_AMBIENTAL","ALVARA_FUNCIONAMENTO","AUTORIZACAO_ANP","HABILITOU_COMEX","FINANCIAMENTO_BNDES","CAPTACAO_MERCADO","INCENTIVO_FISCAL","OUTORGA_TELECOM","REGISTRO_PRODUTO","NOVO_REGISTRO","MARCA_DEPOSITADA","PATENTE_PUBLICADA","SOFTWARE_REGISTRADO","CONTRATO_TECNOLOGIA","DESENHO_INDUSTRIAL","MARCA_VENCENDO","FATO_RELEVANTE","RECEITA_EM_ALTA","FUNDO_LANCADO","CORRESPONDENTE_BANCARIO","OUTORGA_AGUA","RECUPERACAO_JUDICIAL","FALENCIA","NOTICIA","VAGA_ABERTA","ADOTOU_TECNOLOGIA"]},"rotulo":{"type":"string"},"titulo":{"type":"string"},"ocorridoEm":{"type":"string","format":"date-time"},"empresa":{"type":"object","properties":{"cnpj":{"type":"string"},"razaoSocial":{"type":"string"},"uf":{"type":["string","null"]},"municipio":{"type":["string","null"]},"porte":{"type":["string","null"]},"telefones":{"type":"array","items":{"type":"string"},"description":"Só nos planos que mostram contato."},"email":{"type":["string","null"],"description":"Só nos planos que mostram contato."}}},"orgao":{"type":["string","null"]},"uf":{"type":["string","null"]},"municipio":{"type":["string","null"]},"valor":{"type":["number","null"]},"objeto":{"type":["string","null"]},"processo":{"type":["string","null"]},"garantiaPercentual":{"type":["number","null"],"description":"Percentual de garantia contratual lido do edital, quando há."},"fonte":{"type":"string"},"urlFonte":{"type":"string","format":"uri","description":"O registro oficial."},"url":{"type":"string","format":"uri","description":"A página do sinal no Captário."},"marcacao":{"type":["string","null"]}}},"Ficha":{"type":"object","properties":{"cnpj":{"type":"string"},"razaoSocial":{"type":"string"},"nomeFantasia":{"type":["string","null"]},"situacao":{"type":["string","null"]},"abertura":{"type":["string","null"],"format":"date"},"porte":{"type":["string","null"]},"naturezaJuridica":{"type":["string","null"]},"cnae":{"type":["string","null"]},"atividade":{"type":["string","null"]},"capitalSocial":{"type":["number","null"]},"uf":{"type":["string","null"]},"municipio":{"type":["string","null"]},"contato":{"type":["object","null"],"description":"Telefones e e-mail cadastrados, conforme o plano."},"contatoOculto":{"type":["string","null"],"description":"Por que o contato não veio."},"socios":{"type":["array","null"],"items":{"type":"object","properties":{"nome":{"type":"string"},"qualificacao":{"type":"string"}}}},"comprasPublicas12m":{"type":"object"},"sinais":{"type":"array","items":{"type":"object"}},"fonteCadastro":{"type":"string"},"url":{"type":"string","format":"uri"}}}}}}