Exemplo 1 — Busca por nome contendo “cimento”

Lista de insumos contendo “cimento”, ordenados por nome:

/insumos/?apikey=SUA_CHAVE&page=1&limit=20&nome=cimento&estado=SP&sort=nome&order=asc
    

Exemplo 2 — Buscar insumo por código

Retorna o insumo código 366 (areia fina) para SP:

/insumos/?apikey=SUA_CHAVE&codigo=366&estado=SP
    

Exemplo 3 — Filtrar por regime desonerado

Lista de insumos desonerados para SP:

/insumos/?apikey=SUA_CHAVE&page=1&limit=20&estado=SP®ime=DESONERADO
    

Exemplo 4 — Busca por nome começando com “areia”

Usa o modo de busca comeca_com:

/insumos/?apikey=SUA_CHAVE&page=1&limit=15&nome=areia&modo_busca=comeca_com
    

Exemplo 5 — Filtrar só materiais

Exibe apenas itens cujo tipo é “material”:

/insumos/?apikey=SUA_CHAVE&page=1&limit=30&tipo=material&sort=codigo&order=asc
    

Exemplo 6 — Forçar saída em XML

Mesmo endpoint, porém com resposta em XML:

/insumos/?apikey=SUA_CHAVE&page=1&limit=10&nome=brita&output=xml
    

Exemplo 7 — Consultar preços de uma data específica

Exemplo usando data de referência:

/insumos/?apikey=SUA_CHAVE&page=1&limit=20&estado=RJ&data_ref=2024-05-01
    

Observações:

Os valores retornados são sempre os mais recentes. Para consultar um mês específico da tabela SINAPI, use o parâmetro data_ref no formato AAAA-MM-01.
Exemplo:

data_ref=2025-03-01

No parâmetro estado, se for informado o valor BR, a API retornará os preços médios nacionais dos insumos.

Se algum preço de insumo não estiver disponível para o estado solicitado, a flag origem_preco, indicará a origem do valor como media, indicando que o preço retornado é a média nacional, caso contrário o valor retornado da flag origem_preco será: principal.

Ao utilizar o parâmetro regime, com o valor todos (ou sem valor), as flags de preços retornadas serão preco_desonerado e preco_naodesonerado. Se especificado o valor desonerado ou nao_desonerado, a flag retornada será preco com o respectivo valor.

Exemplo

Retorna composições de SP, ordenadas por nome (desc):

Exemplo

Retornar a composição código 98460 com preços de SP e seus itens

{
"codigo": 98460,
"nome": "PISO PARA CONSTRUÇÃO TEMPORÁRIA EM MADEIRA, SEM REAPROVEITAMENTO. AF_03/2024",
"unidade": "m²",
"preco_desonerado": "71.13",
"preco_naodesonerado": "73.65",
"data_referencia": "2025-09-01 00:00:00",
"estado": 26,
"itens": [
  {
      "tipo": "COMPOSICAO",
      "codigo": "91693",
      "unidade": "CHI",
      "quantidade": 0.2832,
      "nome": "SERRA CIRCULAR DE BANCADA COM MOTOR ELÉTRICO POTÊNCIA DE 5HP, COM COIFA PARA DISCO 10\" - CHI DIURNO. AF_08/2015",
      "preco_desonerado": "35.65",
      "preco_naodesonerado": "38.94"
  },
  {
      "tipo": "COMPOSICAO",
      "codigo": "91692",
      "unidade": "CHP",
      "quantidade": 0.0705,
      "nome": "SERRA CIRCULAR DE BANCADA COM MOTOR ELÉTRICO POTÊNCIA DE 5HP, COM COIFA PARA DISCO 10\" - CHP DIURNO. AF_08/2015",
      "preco_desonerado": "36.89",
      "preco_naodesonerado": "40.18"
  },
  {
      "tipo": "COMPOSICAO",
      "codigo": "88262",
      "unidade": "h",
      "quantidade": 0.288,
      "nome": "CARPINTEIRO DE FORMAS COM ENCARGOS COMPLEMENTARES",
      "preco_desonerado": "32.31",
      "preco_naodesonerado": "35.11"
  },
  {
      "tipo": "COMPOSICAO",
      "codigo": "88239",
      "unidade": "h",
      "quantidade": 0.216,
      "nome": "AJUDANTE DE CARPINTEIRO COM ENCARGOS COMPLEMENTARES",
      "preco_desonerado": "30.47",
      "preco_naodesonerado": "33.05"
  },
  {
      "tipo": "INSUMO",
      "codigo": "6194",
      "unidade": "m",
      "quantidade": 7.326,
      "nome": "TABUA *2,5 X 15 CM EM PINUS, MISTA OU EQUIVALENTE DA REGIAO - BRUTA",
      "tipo_insumo": "MATERIAL",
      "preco_desonerado": "5.81",
      "preco_naodesonerado": "5.81"
  }
]
}

Exemplo

Retornar composição código 88239, expandida a nível de insumos, com preços de PB, com regime desonerado:

{
        "codigo": 88239,
        "descricao": "AJUDANTE DE CARPINTEIRO COM ENCARGOS COMPLEMENTARES",
        "unidade": "h",
        "valor_total": 20.2,
        "mao_de_obra": 15.1097764,
        "regime": "desonerado",
        "estado": "Paraíba (PB)",
        "data_referencia": "2025-09-01 00:00:00",
        "insumos": [
          {
            "codigo": "6117",
            "nome": "CARPINTEIRO AUXILIAR (HORISTA)",
            "unidade": "h",
            "preco_unitario": 14.89,
            "quantidade": 1.01476,
            "valor_total": 15.1097764,
            "tipo": "MAO DE OBRA"
          },
          {
            "codigo": "43483",
            "nome": "EPI - FAMILIA CARPINTEIRO DE FORMAS - HORISTA (ENCARGOS COMPLEMENTARES - COLETADO CAIXA)",
            "unidade": "h",
            "preco_unitario": 1.43,
            "quantidade": 1,
            "valor_total": 1.43,
            "tipo": "ENCARGOS COMPLEMENTARES"
          },
          {
            "codigo": "37372",
            "nome": "EXAMES - HORISTA (COLETADO CAIXA - ENCARGOS COMPLEMENTARES)",
            "unidade": "h",
            "preco_unitario": 1.43,
            "quantidade": 1,
            "valor_total": 1.43,
            "tipo": "ENCARGOS COMPLEMENTARES"
          },
          {
            "codigo": "37370",
            "nome": "ALIMENTACAO - HORISTA (COLETADO CAIXA - ENCARGOS COMPLEMENTARES)",
            "unidade": "h",
            "preco_unitario": 0.92,
            "quantidade": 1,
            "valor_total": 0.92,
            "tipo": "ENCARGOS COMPLEMENTARES"
          },
          {
            "codigo": "37371",
            "nome": "TRANSPORTE - HORISTA (COLETADO CAIXA - ENCARGOS COMPLEMENTARES)",
            "unidade": "h",
            "preco_unitario": 0.8,
            "quantidade": 1,
            "valor_total": 0.8,
            "tipo": "ENCARGOS COMPLEMENTARES"
          },
          {
            "codigo": "43459",
            "nome": "FERRAMENTAS - FAMILIA CARPINTEIRO DE FORMAS - HORISTA (ENCARGOS COMPLEMENTARES - COLETADO CAIXA)",
            "unidade": "h",
            "preco_unitario": 0.44,
            "quantidade": 1,
            "valor_total": 0.44,
            "tipo": "ENCARGOS COMPLEMENTARES"
          },
          {
            "codigo": "37373",
            "nome": "SEGURO - HORISTA (COLETADO CAIXA - ENCARGOS COMPLEMENTARES)",
            "unidade": "h",
            "preco_unitario": 0.08,
            "quantidade": 1,
            "valor_total": 0.08,
            "tipo": "ENCARGOS COMPLEMENTARES"
          }
        ]
        }

Exemplo

Retorna os preços do insumo código 123 durante os últimos 6 meses para o estado de São Paulo (SP)

{
"nome": "ADITIVO IMPERMEABILIZANTE DE PEGA NORMAL PARA ARGAMASSAS E CONCRETOS SEM ARMACAO, LIQUIDO E ISENTO DE CLORETOS",
"codigo": "123",
"tipo": "insumo",
"estado_id": 26,
"estado": "São Paulo (SP)",
"historico": [
{
  "preco_desonerado": "6.86",
  "preco_naodesonerado": "6.86",
  "data": "2025-06-01"
},
{
  "preco_desonerado": "7.28",
  "preco_naodesonerado": "7.28",
  "data": "2025-07-01"
},
{
  "preco_desonerado": "7.33",
  "preco_naodesonerado": "7.33",
  "data": "2025-08-01"
},
{
  "preco_desonerado": "6.95",
  "preco_naodesonerado": "6.95",
  "data": "2025-09-01"
}
]
}

Exemplo

Retorna os preços da composição código 89282 para os estados do Acre (AC) e Paraíba (PB)

{
    "codigo": "89282",
    "tipo": "composicao",
    "descricao": "ALVENARIA ESTRUTURAL DE BLOCOS CERÂMICOS 14X19X39, (ESPESSURA DE 14 CM), UTILIZANDO PALHETA E ARGAMASSA DE ASSENTAMENTO COM PREPARO EM BETONEIRA. AF_03/2023",
    "data_referencia": "2025-09-01",
    "comparacao": [
    {
      "estado_id": 1,
      "estado": "Acre (AC)",
      "preco_desonerado": "90.80",
      "preco_naodesonerado": "93.16",
      "data_referencia": "2025-09-01 00:00:00"
    },
    {
      "estado_id": 15,
      "estado": "Paraíba (PB)",
      "preco_desonerado": "69.83",
      "preco_naodesonerado": "71.97",
      "data_referencia": "2025-09-01 00:00:00"
    }
    ]
    }

Exemplo

Gera previsão usando regressão linear para a composição 89994 no estado de São Paulo (SP), regime desonerado:

{
  "item": "composicao",
  "nome": "GRAUTEAMENTO DE CINTA INTERMEDIÁRIA OU DE CONTRAVERGA EM ALVENARIA ESTRUTURAL.",
  "codigo": "89994",
  "estado": "São Paulo (SP)",
  "regime": "desonerado",
  "historico": {
    "datas": [
      "2024-08-01",
      "2024-09-01",
      "2024-10-01",
      "2024-11-01",
      "2024-12-01",
      "2025-01-01",
      "2025-02-01",
      "2025-03-01",
      "2025-04-01",
      "2025-05-01",
      "2025-06-01",
      "2025-07-01",
      "2025-08-01",
      "2025-09-01"
    ],
    "precos": [805.92, 802.66, 806.94, 823.28, 808.1, 823.39, 813.14, 818.7, 817.87, 838.06, 857.03, 859.94, 860.08, 870.85],
    "curva_ajustada": [795.74, 800.86, 805.98, 811.09, 816.21, 821.32, 826.44, 831.56, 836.67, 841.79, 846.9, 852.02, 857.13, 862.25]
  },
  "previsoes": {
    "3_meses": {
      "valor": 877.6,
      "intervalo_95": {
        "min": 853.04,
        "max": 902.16
      }
    },
    "6_meses": {
      "valor": 892.95,
      "intervalo_95": {
        "min": 866.07,
        "max": 919.83
      }
    },
    "12_meses": {
      "valor": 923.64,
      "intervalo_95": {
        "min": 891.11,
        "max": 956.18
      }
    }
  },
  "variacao_percentual_prevista": {
    "3_meses": 0.77,
    "6_meses": 2.54,
    "12_meses": 6.06
  },
  "probabilidade_alta": 100,
  "metodo": "Regressão linear simples"
}

Exemplo

Gera orçamento para os insumos: código 123 (quantidade 4.2), código 366 (quantidade 12) e composição: 87777 (quantidade 2) para o estado de SP, com regime não desonerado para a tabela SINAPI mais recente:

{
  "totais": {
    "total_insumos": 968,
    "total_composicoes": 139.68,
    "total_geral": 1107.68,
    "bdi_percentual": 0,
    "total_com_bdi": 1107.68,    
    "regime": "nao_desonerado",
    "estado": "São Paulo (SP)",
    "data_referencia": "2025-09-01"
  },
  "itens": [
    {
      "tipo": "Insumo",
      "codigo": 123,
      "nome": "ADITIVO IMPERMEABILIZANTE DE PEGA NORMAL PARA ARGAMASSAS E CONCRETOS SEM ARMACAO, LIQUIDO E ISENTO DE CLORETOS",
      "unidade": "L",
      "quantidade": 4.2,
      "preco_unit": 7.62,
      "subtotal": 32
    },
    {
      "tipo": "Insumo",
      "codigo": 366,
      "nome": "AREIA FINA - POSTO JAZIDA/FORNECEDOR (RETIRADO NA JAZIDA, SEM TRANSPORTE)",
      "unidade": "m³",
      "quantidade": 12,
      "preco_unit": 78,
      "subtotal": 936
    },
    {
      "tipo": "Composição",
      "codigo": 87777,
      "nome": "EMBOÇO OU MASSA ÚNICA EM ARGAMASSA TRAÇO 1:2:8, PREPARO MANUAL, APLICADA MANUALMENTE EM PANOS DE FACHADA COM PRESENÇA DE VÃOS, ESPESSURA DE 25 MM. AF_08/2022",
      "unidade": "m²",
      "quantidade": 2,
      "preco_unit": 69.84,
      "subtotal": 139.68
    }
  ]
}

Exemplo

Exibe o status de uso da chave informada

{
"hourly": {
"limit": 100,
"used": 23,
"remaining": 77,
"reset_timestamp": 1732224000
},
"monthly": {
"limit": 3000,
"used": 912,
"remaining": 2088,
"reset_day": 1
}
}