Autor: Se gere um stand em Portugal, escreve sobre carros ou trata das contas de uma pequena empresa, já ouviu a palavra "API" e provavelmente pensou que era coisa só para programadores. Não tem de ser. Neste artigo explicamos, em linguagem simples, o que é a API gratuita de impostos automóveis da Clara Carros, para que serve e como a pode usar mesmo sem saber programar.
O que é uma API, em palavras simples
Uma API é apenas uma forma de um site ou aplicação pedir dados a outro, de forma automática. Pense num restaurante: o empregado de mesa leva o seu pedido à cozinha e traz-lhe o prato. Você não entra na cozinha nem precisa de saber cozinhar. A API é esse empregado de mesa: o seu site faz um pedido ("quanto é o ISV deste carro?"), a nossa API vai buscar a resposta e devolve-lha, em segundos, sem ninguém ter de escrever o cálculo à mão.
O que a nossa API dá, gratuitamente e sem registo, em Portugal
A API da Clara Carros é gratuita, não exige registo nem chave de acesso, e permite cerca de 60 pedidos de imposto por minuto — mais do que suficiente para a maioria dos usos. Devolve dados pensados para o mercado português:
- Imposto de importação (ISV) — o Imposto Sobre Veículos que se paga ao trazer um carro para Portugal. Endereço:
/api/public/isv. - Avaliações de mercado — uma estimativa do valor de um carro. Endereço:
/api/public/valuation. - O nosso catálogo de viaturas — os carros que temos disponíveis. Endereço:
/api/public/cars. - Listas oficiais de marcas e modelos — nomes normalizados, sempre escritos da mesma forma. Endereço:
/api/public/car_refs.
Também disponibilizamos o cálculo do imposto anual de circulação (IUC) através das nossas calculadoras. Pode ver as ferramentas prontas a usar nas páginas de cálculo de ISV e de cálculo de IUC.
Quem quer isto e porquê
A API não é para toda a gente — é para quem precisa dos mesmos números, de forma repetida e sempre certa. Alguns exemplos reais:
- Um stand ou importador que quer mostrar, ao lado de cada anúncio, quanto ficaria o ISV daquele carro — sem ter de calcular manualmente para cada viatura.
- Um blogueiro ou um contabilista que precisa de puxar valores de imposto para uma folha de cálculo ou para um artigo, em vez de os copiar um a um.
- Uma pequena aplicação ou ferramenta que ajuda pessoas a decidir se vale a pena importar um carro, mostrando o custo do imposto no momento.
E se eu não sei programar? As opções sem código
A boa notícia: na maior parte dos casos não precisa de tocar na API diretamente. Temos alternativas prontas:
- Um widget de calculadora para incorporar (iframe) — cola-se um pequeno bloco de código no seu site e a calculadora aparece lá, a funcionar. É a forma mais simples.
- Uma versão em JavaScript amiga do SEO — parecida com o widget, mas com o conteúdo visível para o Google, o que ajuda o seu site a ser encontrado.
- O plugin oficial para WordPress — se o seu site é feito em WordPress, instala-se o plugin e usa-se um atalho simples,
[claracars_isv], para colocar a calculadora em qualquer página. Pode obter o plugin oficial no diretório do WordPress.
Para quem é mais técnico, ou trabalha com um programador, disponibilizamos ainda a especificação OpenAPI 3.1, uma coleção Postman pronta a testar, e as calculadoras em Python de código aberto (licença MIT) no GitHub. Tudo isto está reunido na nossa página de API para programadores.
Nota honesta
Sim, é mesmo gratuito. Em troca, pedimos apenas uma coisa: quando usar o widget no seu site, mantenha a atribuição à Clara Carros visível. E queremos ser claros sobre quem somos — a Clara Carros é um importador e comerciante de automóveis em Portugal. Construímos estas ferramentas gratuitas porque nos são úteis e porque acreditamos que números claros ajudam toda a gente a decidir melhor.
A calculadora e as ferramentas dão-lhe os números. Se preferir que sejamos nós a encontrar, verificar, importar e entregar o carro, veja o nosso serviço de importação chave na mão e o nosso serviço de procura de carros.
Perguntas frequentes
Preciso mesmo de me registar ou pagar?
Não. A API é gratuita e sem chave de acesso. Pode começar a usá-la de imediato, dentro do limite de cerca de 60 pedidos de imposto por minuto.
Não sei programar. Consigo usar isto na mesma?
Sim. Use o widget para incorporar, a versão JavaScript ou o plugin de WordPress. Nenhum destes exige saber programar — basta colar um pequeno bloco de código ou usar o atalho [claracars_isv].
Onde fico a saber mais?
Temos artigos irmãos sobre o nosso servidor MCP para o ChatGPT e outros assistentes de IA, sobre o plugin de WordPress e sobre a extensão de Chrome que mostra o ISV diretamente no mobile.de.