Carsensor APIScraper e parser
Carsensor API: preços de concessionários japoneses com e sem custos de registo, quilometragem, inspeção, ficha técnica e fotos. Eventos por carro, stock diário.
Carsensor API
O parser e o scraper do Carsensor funcionam do nosso lado. Recebe pela API os anúncios dos concessionários japoneses já prontos a usar. Cada registo traz o preço do carro e o total a pagar no concessionário, a quilometragem, as especificações, os dados de inspeção e as fotos, e o feed de alterações avisa quando surge um anúncio novo, quando muda o preço do carro e quando o carro é retirado de venda.
O feed de alterações avisa de cada anúncio novo no Carsensor, de cada novo preço e de cada carro retirado de venda.
Um ficheiro por dia com todo o stock atual do Carsensor.
Preço do carro e total a pagar no concessionário, ano de matrícula, quilometragem, códigos de modelo e de motor, potência, caixa, tração e lado do volante, indicações de estado e de reparações, ficha de inspeção, equipamento, concessionário e fotos.
URL Base
https://{access_name}.auto-api.com/api/v2/carsensorAutorização: api_key parâmetro
Fluxo de Trabalho
/filtersobter valores de filtro disponíveis/offersobter listagens (com ou sem filtros) - usar para carregamento inicial de dadosPara atualizações (manter dados atualizados após o carregamento inicial):
/change_id?date=...obter ID inicial para o feed de alterações/changes?change_id=...obter todas as alterações no banco de dados a partir do ID/offerobter detalhes de uma listagem específica por inner_idPor onde começar:
1. Antes do primeiro carregamento, chame /change_id com a data de hoje e guarde a resposta; se vier zero, tente novamente um pouco mais tarde. Depois descarregue /offers página a página, até à última.
2. A seguir, consulte /changes a partir desse ID, passando sempre o next_change_id da resposta: assim recebe os novos anúncios, os novos preços e os anúncios retirados. Se next_change_id vier null, ainda não há eventos novos: repita o pedido mais tarde com o mesmo ID.
3. Para os seus próprios critérios de pesquisa, chame /offers com os filtros de que precisa.
GET/filters
Retorna todos os valores possíveis para filtragem
https://{access_name}.auto-api.com/api/v2/carsensor/filters?api_key=YOUR_API_KEYResposta:
{
"mark": {
"Toyota": {
"model": ["Alphard", "Aqua", "Crown", "Harrier", "Hiace Van", "Land Cruiser Prado", "Noah", "Prius", "Sienta", "Voxy"]
},
"Honda": {
"model": ["Fit", "Freed", "N-BOX", "Vezel"]
}
},
"transmission_type": ["Automatic", "CVT", "Manual", "Other"],
"color": ["Black", "Blue", "Brown", "Gold", "Gray", "Green", "Navy", "Orange", "Other", "Pearl", "Pink", "Purple", "Red", "Silver", "White", "Yellow"],
"body_type": ["Bus", "Camper", "Convertible", "Coupe", "Hatchback", "Minivan", "Other", "Pickup truck", "SUV", "Sedan", "Station wagon", "Truck"],
"engine_type": ["Diesel", "Electric", "Gasoline", "Hybrid", "Plug-in hybrid"],
"drive_type": ["2WD", "4WD"],
"rudder": ["Left", "Right", "Unknown"]
}GET/offers
Lista de listagens com paginação e filtros
Parâmetros:
page(obrigatório) - número da páginamark, model- marca e modelo, escritos como em /filterstransmission_type, color, body_type, engine_type, drive_type, rudder- caixa, cor, tipo de carroçaria, combustível, tração e lado do volante, sem distinção de maiúsculasyear_from, year_to- intervalo do ano da primeira matrículakm_age_from, km_age_to- intervalo de quilometragem, em kmprice_from, price_to- intervalo do preço do carro, em ienes
https://{access_name}.auto-api.com/api/v2/carsensor/offers?api_key=YOUR_API_KEY&page=1https://{access_name}.auto-api.com/api/v2/carsensor/offers?api_key=YOUR_API_KEY&page=1&mark=Honda&model=Freed&year_from=2020&km_age_to=50000&engine_type=GasolineResposta:
{
"result": [
{
"id": 3,
"inner_id": "AU7363661281",
"change_type": "added",
"created_at": "2026-09-29T01:24:02.000+03:00",
"data": {
"id": "3",
"inner_id": "AU7363661281",
"url": "https://www.carsensor.net/usedcar/detail/AU7363661281/index.html",
"mark": "Honda",
"model": "Freed",
"generation": "2025.07 -",
"configuration": "5BA-GT1",
"complectation": "1.5 エアー EX",
"year": "2025",
"price": "3090000",
"km_age": "9000",
"color": "Navy",
"engine_type": "Gasoline",
"body_type": "Minivan",
"transmission_type": "CVT",
"drive_type": "2WD",
"rudder": "Right",
"displacement": "1500",
"doors_count": "5",
"horse_power": "118",
"condition": "Non-smoking car",
"no_accidents": true,
"owners_count": "",
"equipment": "[\"Power steering\", \"ABS\", \"Automatic emergency braking\", \"Adaptive cruise control\", \"Lane keeping assist\", \"Camera: rear\", \"Electronic stability control\"]",
"region": "Saitama",
"city": "幸手市",
"address": "埼玉県幸手市北２－６－１６",
"seller": "ネクステージ 幸手店",
"seller_url": "https://www.carsensor.net/shop/saitama/206339416/",
"salon_id": "206339416",
"section": "used",
"title": "フリード 1.5 エアー EX 両側電動スライドドア 純正11.4型ナビ バックカメラ 衝突軽減",
"offer_created": "2026-09-28",
"images": "[\"https://ccsrpcma.carsensor.net/CSphoto/bkkn/308/423/UZ0054308423/UZ0054308423_001.JPG?ver=detail001&impolicy=car_002\", \"https://ccsrpcml.carsensor.net/CSphoto/ml/308/423/UZ0054308423/UZ0054308423_1_001.jpg?ver=detail001&impolicy=car_002\"]",
"extra_prep": {
"total_price": 3212000,
"plan_prices": { "A": 3228000, "B": 3229000 },
"is_price_ask": false,
"monthly_loan": 25600,
"monthly_loan_type": "regular",
"is_mileage_unknown": false,
"is_mileage_tampered": false,
"is_meter_replaced": false,
"year_raw": "2025(R07)",
"chassis_no_tail": "064",
"seats": 6,
"power_kw": 86.79,
"power_kw_estimated": true,
"engine_code": "L15D",
"displacement_exact": 1496,
"catalog_path": "honda/freed/F003/M003G013",
"maker_code": "HO",
"model_code_site": "S083",
"is_new": true,
"is_maker_certified": false
// ... other extra_prep fields, including the ais inspection sheet
}
}
}
],
"meta": { "page": 1, "next_page": 2, "limit": 20 }
}Campos do registo
- id - número do registo na nossa base de dados; para associar ao anúncio na plataforma, use inner_id
- inner_id - identificador do anúncio no Carsensor, que também aparece no URL do anúncio: AU7363661281
- url - ligação para o anúncio em carsensor.net
- title - título do anúncio escrito pelo concessionário
- section - secção: used para carros usados, new para carros novos
- mark, model - marca e modelo, por exemplo Honda e Freed
- generation - período de produção desta versão do modelo, no formato 2017.04 - 2018.03; se o modelo ainda estiver em produção, não há data de fim
- configuration - código do modelo que consta dos documentos de registo japoneses, por exemplo 5BA-GT1
- complectation - versão indicada pelo concessionário
- year - ano em que o carro foi matriculado pela primeira vez; nos carros de importação paralela, a plataforma indica o ano de fabrico
- color - cor da carroçaria, valores de /filters
- body_type - tipo de carroçaria, valores de /filters
- doors_count - número de portas
- engine_type - tipo de combustível, valores de /filters
- displacement - cilindrada do motor, em cm³
- horse_power - potência de fábrica em cv; nos híbridos só conta o motor de combustão, nos elétricos é a do motor elétrico; sem dados, o campo fica vazio
- transmission_type - tipo de caixa: automática, manual, CVT ou outra
- drive_type - 4WD ou 2WD; num 2WD, drive_catalog mostra quais são as rodas motrizes
- rudder - lado do volante
- price - preço do carro em ienes, já com o imposto japonês sobre o consumo, sem as despesas de registo; -1 quando o preço é sob consulta
- km_age - quilometragem em km tal como a plataforma a arredonda, normalmente aos milhares; o campo fica vazio se a quilometragem for desconhecida ou adulterada
- no_accidents - true significa que os elementos estruturais da carroçaria não foram reparados nem substituídos; false, que houve intervenções desse tipo
- condition - notas do concessionário numa lista separada por vírgulas, por exemplo um só dono, interior de não fumador, livro de revisões
- owners_count - 1 quando o concessionário indica um só dono; nos outros casos, vazio
- equipment - lista de equipamento como array JSON dentro de uma cadeia
- seller - nome do concessionário
- seller_url - ligação para o perfil do concessionário em carsensor.net
- salon_id - identificador do concessionário no Carsensor
- region - prefeitura onde o carro se encontra
- city - cidade ou distrito
- address - morada do concessionário
- images - ligações das fotos como array JSON dentro de uma cadeia; muitos carros têm várias dezenas de fotos
- offer_created - data em que o anúncio apareceu, segundo a etiqueta NEW; vazio se a data não for conhecida
- extra_prep - objeto aninhado com dados adicionais, descrito abaixo; quando falta um valor, vem null
Dentro de extra_prep
- total_price - total a pagar em ienes: o carro mais as despesas obrigatórias de registo, se for comprado a este concessionário e registado na zona dele
- plan_prices - total a pagar nos pacotes A e B do concessionário, por exemplo com garantia alargada; nem todos os carros os têm
- is_price_ask - true quando o concessionário não indicou o preço e price é -1
- monthly_loan - prestação mensal do crédito do concessionário, em ienes
- monthly_loan_type - tipo de crédito: regular para um crédito normal, residual para crédito com um pagamento residual no fim
- mileage_raw - quilometragem tal como está escrita no anúncio, com as respetivas notas
- is_mileage_unknown - true quando a quilometragem real é desconhecida
- is_mileage_tampered - true quando está confirmada a adulteração do conta-quilómetros
- is_meter_replaced - true quando o conta-quilómetros foi substituído
- year_raw - ano tal como aparece no anúncio, com a indicação da era japonesa: 2025(R07)
- shaken - validade da inspeção técnica japonesa (ano e mês) ou uma nota a indicar se o concessionário trata da inspeção na venda
- warranty - se tem garantia
- maintenance - revisão obrigatória antes da venda: incluída no preço, paga à parte ou não realizada
- recycle_fee - situação da taxa de reciclagem japonesa: se está paga e se está incluída no preço
- transmission_raw - designação original da caixa: onde fica o seletor, número de velocidades e se tem modo manual
- color_name - cor nas palavras do concessionário
- color_factory - nome de fábrica da cor
- chassis_no_tail - os três últimos dígitos do número de chassis; o Carsensor não publica o número completo
- seats - número de lugares
- fuel - combustível recomendado pelo fabricante: gasolina normal, gasolina de alta octanagem ou gasóleo
- drive_catalog - tipo de tração segundo a especificação de fábrica, por exemplo FF (rodas dianteiras), FR (traseiras) ou 4WD (as quatro rodas)
- power_kw - potência de horse_power convertida em kW
- power_kw_estimated - true quando os kW foram convertidos a partir dos cv
- engine_kind - arquitetura do motor: número e disposição dos cilindros, tipo de distribuição; nos elétricos, o motor elétrico
- engine_code - código do motor: L15D
- displacement_exact - cilindrada segundo os dados de fábrica, com precisão ao centímetro cúbico: 1496
- grade_name - nome completo da versão segundo os dados de fábrica
- catalog_path - identificador da versão em carsensor.net: é igual em todos os carros da mesma versão
- maker_code - código da marca usado internamente pelo Carsensor
- model_code_site - código do modelo usado internamente pelo Carsensor
- is_new - true com a etiqueta NEW: o anúncio foi publicado ou republicado na última semana
- labels - etiquetas do anúncio, por exemplo garantia do concessionário, fotos 360°, consulta online, relatório de avaliação
- is_maker_certified - true nos carros com certificação do fabricante
- evaluation - resultado da inspeção por um avaliador: quem inspecionou, nota global e data; a nota R é atribuída aos carros cujos elementos estruturais da carroçaria foram reparados
- ais - ficha de inspeção detalhada do Carsensor: nota global, classificações em letras do interior e do exterior, código do modelo, leitura do conta-quilómetros no dia da inspeção, se houve pintura integral e substituição do conta-quilómetros, lista de defeitos e ligação para a imagem com os danos assinalados
GET/change_id
Obter primeiro ID de alteração por data (para usar em /changes)
Parâmetros:
date(obrigatório) - data no formato yyyy-mm-dd
https://{access_name}.auto-api.com/api/v2/carsensor/change_id?api_key=YOUR_API_KEY&date=2026-09-29Resposta:
{ "change_id": 1254 }Use o valor retornado como parâmetro change_id em /changes
GET/changes
Feed de alterações (adicionado/alterado/removido)
Parâmetros:
change_id(obrigatório) - a partir de qual ID de alteração
https://{access_name}.auto-api.com/api/v2/carsensor/changes?api_key=YOUR_API_KEY&change_id=1254Resposta:
{
"result": [
{
"id": 1254,
"inner_id": "AU7305608350",
"change_type": "added", // added - new listing
"created_at": "2026-09-29T19:12:40.512+03:00",
"data": { ... } // full listing data
},
{
"id": 1255,
"inner_id": "AU7363661281",
"change_type": "changed", // changed - new car price, JPY
"created_at": "2026-09-29T20:05:17.208+03:00",
"data": { "new_price": 2990000 }
},
{
"id": 1256,
"inner_id": "AU6927774389",
"change_type": "removed", // removed - listing deleted
"created_at": "2026-09-29T21:48:02.331+03:00",
"data": {}
}
],
"meta": { "cur_change_id": 1254, "next_change_id": 1257, "limit": 20 }
}GET/offer
Listagem única por inner_id
Parâmetros:
inner_id(obrigatório)
https://{access_name}.auto-api.com/api/v2/carsensor/offer?api_key=YOUR_API_KEY&inner_id=AU7363661281Resposta: objeto data (igual a /offers, mas sem o wrapper result)
Retenção
Os ficheiros ficam disponíveis pelo menos 3 dias
Disponibilidade
Ficheiros novos todas as manhãs
Formato CSV
As colunas do CSV são separadas pelo caráter pipe (|)
Estrutura do URL:
Parâmetros:
access_name- o seu subdomínio pessoaldate- data da exportação no formato aaaa-mm-dd, por ex. 2026-09-29file_name- nome do ficheiro com extensão
Ficheiros disponíveis:
- CSV - all_active.csv, new_daily.csv, removed_daily.csv
- JSON - all_active.json, new_daily.json, removed_daily.json
- Excel - all_active.xlsx, new_daily.xlsx, removed_daily.xlsx
Exemplo de pedido cURL
curl -L -X GET 'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv' \
-H 'Authorization: Basic XXX' \
-o daily_car_data.csvExemplo de comando Wget
wget --method GET \
--header 'Authorization: Basic XXX==' \
'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'O Carsensor (carsensor.net) pertence à empresa japonesa Recruit e é um dos maiores sites de carros usados do país. Os anúncios são publicados apenas por concessionários, desde pequenos stands até representantes oficiais das marcas, e vende-se ali quase tudo, incluindo kei cars, camiões e autocaravanas.
No Carsensor, os preços estão em ienes e o preço do carro aparece separado do total com despesas de registo no concessionário. O anúncio mostra se houve reparação ou substituição de elementos estruturais da carroçaria, se há garantia e até que mês é válida a inspeção técnica. Alguns carros são inspecionados por um avaliador do Carsensor e, nesse caso, o anúncio inclui uma ficha com as notas e os defeitos.
Para um importador, é uma forma de encontrar depressa a versão pretendida em concessionários de todo o Japão, sem deixar escapar os anúncios mais recentes. Os mesmos dados mostram quanto custa um modelo no mercado japonês e como evolui o seu preço, e com o código do modelo e os dados do motor é fácil estimar de antemão os impostos e taxas de importação.
Através de /changes recebe os novos anúncios, os novos preços dos carros e os carros retirados de venda. Não precisa de um parser próprio para isso.
Acesse dados de múltiplos mercados automotivos com APIs especializadas por plataforma: