TransparentJá ouviu a palavra «API» e acenou com a cabeça sem que ninguém alguma vez lhe explicasse o que é. Aqui fica a versão simples, com a nossa própria API de carros gratuita para Portugal como exemplo — sem precisar de curso de informática.
O que é, afinal, uma API
Imagine um restaurante. Está sentado à mesa (o seu site, a sua folha de cálculo, uma app no telemóvel). Não entra pela cozinha a cozinhar — diz ao empregado o que quer e ele traz-lhe o prato da cozinha. Uma API é esse empregado de mesa. É um programa a pedir educadamente uma coisa a outro programa e a receber uma resposta arrumada, de forma automática, sem ninguém a copiar e colar à mão.
Portanto, quando dizemos «a API da TransparentCars», queremos dizer isto: os nossos sistemas entregam dados de carros diretamente aos seus sistemas. Pergunta «qual é o preço justo de um Renault Clio de 2015 com 118 000 km?» e recebe um número numa fração de segundo — o mesmo número que o nosso próprio site usa.
O que a API gratuita da TransparentCars lhe dá em Portugal
A TransparentCars é um vendedor local português de carros usados. Construímos o nosso site sobre um pequeno serviço de dados honesto e abrimos esse mesmo serviço a toda a gente. É gratuito e não precisa de chave — sem registo, sem token, sem fatura. Basta chamá-lo. Eis o que lhe consegue dizer:
- O preço justo de um carro. Dê-lhe marca, modelo, ano e quilómetros e devolve uma faixa de preço justo — mínimo, médio e máximo — construída a partir de carros comparáveis à venda em Portugal neste momento. É o mesmo motor por trás da nossa ferramenta de preço justo. Responde honestamente a uma pergunta: este preço pedido é razoável ou não?
- Imposto de circulação e custo anual. Dê-lhe cilindrada, CO₂, combustível e ano da primeira matrícula e devolve o IUC anual em euros — o que o carro custa só para o manter legalmente na estrada. Os elétricos vêm marcados como isentos. É a mesma conta da nossa calculadora pública de imposto.
- O catálogo de usados. Os carros que temos mesmo à venda — marca, modelo, ano, quilómetros, preço, fotos — os mesmos anúncios que vê no site, disponíveis como dados limpos para puxar para a sua página ou folha de cálculo.
- A lista de marcas e modelos que a ferramenta de preço justo reconhece, para perguntar sempre com a grafia certa.
Cada resposta são números simples ou dados públicos de anúncios — sem qualquer informação pessoal pelo meio.
Quem havia de querer isto, e porquê
Dois exemplos do dia a dia tornam a coisa concreta.
Um pequeno stand local. Imagine que gere um stand pequeno com quinze carros. Podia mostrar um pequeno selo de «preço justo» em cada anúncio — «dentro da faixa justa para Portugal» — puxado ao vivo dos nossos dados de avaliação. Diz a um comprador nervoso, num relance, que não está a pôr o preço a olho. Não precisa de um grande departamento de informática; um programador liga isto uma vez.
Um blogger, contabilista ou pequeno empresário. Talvez escreva sobre carros, ou ajude clientes a fazer contas para comprar um. Em vez de consultar o imposto à mão para vinte carros diferentes, pode fazer os números fluírem diretamente para uma folha de cálculo. Pergunta uma vez e o IUC anual de cada carro preenche-se sozinho. O mesmo para uma coluna de preço justo ao lado de uma lista de carros que está a comparar.
Preciso de ser programador? A via sem código
Na maioria das vezes, sim — alguém com jeito técnico faz a primeira ligação — mas nem sempre. As folhas de cálculo modernas (o Google Sheets, por exemplo) conseguem puxar dados diretamente de um endereço web, por isso um não-programador cuidadoso consegue meter um valor de imposto ou de preço justo numa célula sem escrever código a sério. Ainda não oferecemos um widget do tipo «cole esta caixa no seu site»; se é disso que precisa, a resposta honesta hoje é que um programador gasta uma hora, não uma semana. Se preferir que tratemos nós do lado do preço justo, o caminho mais simples é vender o seu carro ou anunciar connosco diretamente.
A parte técnica, em poucas palavras
Para o programador a quem entregar isto: existe uma página de API para programadores completa, com uma descrição OpenAPI legível por máquina em transparent.pt/openapi.yaml, para que as ferramentas dele percebam cada endpoint automaticamente. Os endereços têm este aspeto: transparent.pt/api/public/valuation e transparent.pt/api/public/cars. O código é open-source no GitHub (os repositórios api e mcp em transparentpt). Há um limite generoso de uso justo por visitante — mais do que suficiente para um site normal ou uma folha de cálculo — e, se o ultrapassar, o serviço apenas lhe pede que espere um instante. Se preferir que as suas ferramentas ou um assistente de IA falem connosco em conversa, também temos um servidor MCP — isso é outra história, contada no nosso artigo sobre o MCP.
As letras miudinhas, com honestidade
Não somos um serviço neutro a fingir que não tem interesse nenhum no jogo. A TransparentCars vende carros usados em Portugal, e esta API gratuita corre sobre os mesmos dados que nós próprios usamos. É de uso gratuito ao abrigo de uma licença Creative Commons, que apenas pede que credite «TransparentCars» como fonte onde mostrar os números. A faixa de preço justo é construída a partir de preços pedidos reais, não é uma avaliação oficial, e o valor do imposto é uma estimativa bem mantida para planear — não é uma nota de cobrança das Finanças. Use para tomar uma decisão sensata, não para ganhar um caso em tribunal.
Perguntas frequentes
A API da TransparentCars é mesmo gratuita e sem chave?
Sim. Sem conta, sem chave de API, sem custo. Você (ou o seu programador) chama o endereço web e recebe JSON de volta. O único limite é um teto de uso justo por visitante, para que ninguém a martele — o uso normal nunca lá chega.
Tenho de creditar a TransparentCars?
Onde mostrar os nossos números, sim — um simples «fonte: TransparentCars» chega, como pede a licença Creative Commons. Mantém as coisas honestas para quem lê a sua página.
Os dados são fiáveis?
São os mesmos dados sobre os quais corre o nosso próprio site português, por isso temos todo o interesse em mantê-los certos. Trate a faixa de preço justo como um guia bem informado e o imposto como uma estimativa sólida para orçamentar, não como uma avaliação oficial nem uma liquidação de imposto.