Ir para o conteúdo

API · v1 · REST / JSON

O Índice TEM na operação da sua empresa.

Valor de referência, faixa de preço e nível de confiança por chamada, para bancos, seguradoras, locadoras e revendas. Mesma base e mesma metodologia da consulta pública.

Chaves test e live · HTTPS

POST /v1/avaliacoesHost: [domínio da API]X-API-Key: tem_test_••••_••••••••Content-Type: application/json{  "categoria": "escavadeira",  "marca": "Caterpillar",  "modelo": "320",  "ano": 2008,  "horas": 2000,  "uf": null}

Casos de uso

Para banco, seguradora, locadora e revenda

  • Garantia de crédito

    Valor de referência da máquina dada em garantia, com faixa e confiança no momento da análise.

  • Sinistro

    Base objetiva para indenização integral ou parcial, com comparáveis auditáveis e data de referência.

  • Avaliação de frota

    Marcação a mercado de dezenas ou milhares de ativos em lote, por categoria, ano e UF.

  • Precificação de estoque

    Preço de compra e de venda do estoque de usados alinhado ao mercado da região.

O que a API devolve

Uma avaliação por chamada, em POST /v1/avaliacoes. Valores em reais inteiros.

Você envia

categoriamarcamodeloano
Obrigatórios. Marca e modelo aceitam grafias comuns, como “jhon deere”.
horasufpotencia_cv
Opcionais. Sem UF, o preço vale para a média do Brasil.
referencia_cliente
Opcional. O código do pedido no seu sistema, sem dado pessoal.

Você recebe

estimativa
Preço de referência em reais, arredondado a R$ 500.
faixa
p10 e p90: piso e teto da faixa onde ficam 8 em cada 10 anúncios parecidos.
confianca
Nível (alta, media, baixa ou indicativa) e quantos anúncios do modelo sustentam o número.
comparaveis
Os anúncios usados na comparação, com site, link, data da coleta, ano, horas, UF e preço. 10 por padrão, até 50.
decomposicao
Os fatores de idade, horas e região que levam ao valor.
modelo
Versão do cálculo e data da coleta. O tipo de preço é sempre “anunciado”.
avisos
Por exemplo: horas não informadas, modelo não reconhecido, ano fora do observado.
tendencia
Série de preço da categoria. Fica indisponível até haver coletas suficientes.

Também na API

Catálogo
Categorias, marcas e modelos cobertos.GET /v1/catalogo/modelos
Avaliação gravada
Uma avaliação já feita, devolvida como saiu.GET /v1/avaliacoes/{id}
Evidência
A evidência de cada anúncio, para auditoria.GET /v1/anuncios/{anuncio_id}/evidencia
Resposta201 Created
{  "id": "[uuid]",  "estimativa": 311000,  "moeda": "BRL",  "faixa": {    "p10": 246500,    "p90": 388500,    "cobertura_nominal": 0.8  },  "confianca": {    "nivel": "media",    "n_anuncios_modelo": 87  },  "modelo": {    "versao": "[versão do modelo]",    "data_snapshot": "2026-11-04",    "tipo_preco": "anunciado"  },  …}

Trecho, com os valores da consulta pública do Caterpillar 320 (2008, 2.000 h, Brasil todo). A resposta completa também traz comparáveis, decomposição, tendência, fontes e avisos.

É o preço pedido nos anúncios, não o valor de uma venda fechada nem laudo de avaliação.

Cobertura e atualização

A base é a coleta de 04/11/2026, com 8.816 anúncios no preço. Não há recálculo semanal neste conjunto.

tipos de máquina
12
modelos na base
596
anúncios no preço, com fonte e UF quando o anúncio traz
8.816
coleta mais recente · ainda sem série mensal do modelo
04/11/2026

Tipos de máquina na base

  • Tratores186
  • Colheitadeiras86
  • Escavadeiras98
  • Pás carregadeiras84
  • Rolos compactadores35
  • Motoniveladoras31
  • Mini escavadeiras23
  • Minicarregadeiras23
  • Plataformas elevatórias tesoura10
  • Plataformas articuladas9
  • Vibroacabadoras7
  • Guindastes4

Planos sob consulta

Preço por volume de chamadas, com ambiente de testes gratuito.

Suporte técnico e relatórios de uso. As chaves de teste e de produção são emitidas pela equipe do Índice TEM.

Como calculamos

Fale com vendas

Conte quem é a empresa, o uso e quantas chamadas por mês. A resposta vai para o e-mail que você informar.

Falar com vendas

Pelo formulário de contato, no assunto “API para empresas”.