{"como_usar":"adicione ao menos um filtro, ex.: /screener?roic_min=0.15","operadores":["<indicador>_min","<indicador>_max"],"indicadores":["cresc_receita_1a","cresc_receita_5a_cagr","dl_ebitda","margem_bruta","margem_ebit","margem_liquida","piotroski","roe","roic"],"multiplos":["pl","pl_ttm"],"parametros":{"ano":"EXERCÍCIO alvo (padrão: o último de cada empresa)","recibo":"recibo=1 congela a resposta num endereço permanente (/recibo/{id}) com a pergunta, a versão do dado e o sha256 do resultado — para citar e para conferir depois que a base mudar. Mesma pergunta na mesma versão = mesmo recibo.","as_of":"DATA DE DISPONIBILIDADE (AAAA-MM-DD): filtra com o que existia naquele dia, não com o exercício. O balanço de 2018 só chegou à CVM em 2019; `ano=2018` usa o exercício, `as_of=2019-06-30` usa o que estava público naquele dia. Não combine os dois.","pl / pl_ttm":"P/L anual (`pl_min`/`pl_max`, da DFP) e P/L dos últimos 12 meses (`pl_ttm_min`/`pl_ttm_max`, do ITR ou DFP mais recente). Com `as_of`, o documento mais recente já recebido na data, com o preço de um pregão que já existia; sem `as_of`, o mais recente. P/L de lucro negativo ou zero, acima de 200 ou ausente não passa. A linha traz `multiplos` com `dt_receb` e `data_preco` do valor usado.","rigor":"só para os filtros de P/L. `padrao` (o padrão) aceita P/L com ajuste já feito ou ressalva leve, listada em `ressalvas` de cada linha, e nunca aceita ressalva grave nem flag desconhecida; `estrito` só aceita P/L sem nenhuma ressalva. Com filtro de P/L, `fora_do_filtro` explica quantas empresas ficaram de fora e por quê.","limite":"máximo de empresas na resposta"},"exemplos":["https://dadosb3.com/screener?roic_min=0.15","https://dadosb3.com/screener?dl_ebitda_max=2&roe_min=0.15","https://dadosb3.com/screener?margem_liquida_min=0.10&ano=2024","https://dadosb3.com/screener?roic_min=0.15&as_of=2019-06-30","https://dadosb3.com/screener?pl_max=10&as_of=2023-06-30"],"dicionario":"https://dadosb3.com/dicionario","chave":"filtrar exige chave — crie grátis (sem cartão) em https://dadosb3.com/chave-gratis?de=api ou assine em https://dadosb3.com/assinar. Este cardápio é aberto."}