O que me dá a Goo-net Exchange API?

Acesso direto aos anúncios de concessionários japoneses no Goo-net Exchange sem desenvolver um scraper. Os pedidos REST devolvem registos de veículos: marca, modelo, versão, preço FOB, quilometragem, especificações, equipamento e fotos. Um feed separado apresenta os novos anúncios, as atualizações de preço e os anúncios removidos.

Que campos a API devolve?

O preço FOB em ienes com o equivalente em dólares, mais o preço a que o mesmo carro está anunciado dentro do Japão. Data da primeira matrícula, quilometragem, cilindrada, caixa de velocidades, tração, lado do volante, tipo de carroçaria, código do modelo e número de chassis mascarado, estado de reparação após acidente, equipamento e fotos. Potência, código do motor, vídeo e relatório de inspeção só aparecem quando o concessionário os forneceu.

Com que rapidez aparecem os anúncios novos?

Os anúncios novos chegam à API no prazo de uma hora após a publicação no Goo-net Exchange. As atualizações de preço e as remoções chegam pelo mesmo feed.

Que formatos estão disponíveis?

API REST com respostas em JSON. Para o carregamento diário em massa há ficheiros CSV, JSON e XLSX com o mesmo conjunto de campos, prontos para o Excel ou para importação numa base de dados.

Que preços estão incluídos?

O preço principal é o FOB: entrega num porto japonês e carregamento a bordo, sem frete nem seguro. A plataforma mostra-o em ienes e converte-o em dólares à sua própria taxa; entregamos ambos os valores. À parte, recebe o preço a que o mesmo carro é oferecido no mercado interno japonês. Quando o concessionário mantém o preço sob consulta, price é -1, is_price_ask é true e price_usd fica vazio.

Há dados sobre estado e reparações?

Sim. Os dados incluem informações da plataforma sobre reparações após acidentes e as indicações do concessionário sobre o estado do carro, quando disponíveis: um só dono, interior de não fumador, registos de manutenção. Se o anúncio tiver um relatório de inspeção, recebe também classificações de 1 a 5 para o interior e o exterior, uma avaliação do motor e informações sobre reparações após acidentes.

Quem vende no Goo-net Exchange?

Apenas concessionários japoneses, não há anúncios de particulares. Os registos incluem o estatuto Trusted Dealer e o número de stock no concessionário. A plataforma não publica nomes nem contactos dos vendedores, por isso esses campos chegam vazios.

Goo-net Exchange APIScraper e parser

Goo-net Exchange API: anúncios de carros do Japão, preços FOB, relatórios e fotos. Novos anúncios, alterações de preço e ficheiros diários. Sem scraper próprio.

Bibliotecas SDK oficiais

Bibliotecas cliente de código aberto no GitHub: instale o pacote e traga os anúncios do Goo-net Exchange para a sua aplicação sem escrever pedidos à mão.

PHP Node.js Python Go C#Java Ruby Rust

Goo-net Exchange API

Uma única API dá acesso aos anúncios dos concessionários japoneses no Goo-net Exchange. Recebe registos dos veículos com preços FOB, especificações, avaliações do estado e fotos. O feed de alterações ajuda a manter o seu catálogo atualizado. Estes dados servem para procurar carros por encomenda, analisar preços e alimentar sites de anúncios. Não precisa de desenvolver nem manter um scraper próprio.

API

Os anúncios novos do Goo-net Exchange entram no feed de alterações no prazo de uma hora após a publicação.

Exportações diárias

Um ficheiro por dia com todos os anúncios ativos na plataforma.

Dados completos

Preços FOB e internos, primeira matrícula, quilometragem, motor e caixa, tração e lado do volante, carroçaria, códigos de modelo e motor, estado de reparação, equipamento, fotos, vídeo e notas de estado.

Obter acesso à APIAcesso fornecido em 2 minutos

API

URL Base

https://{access_name}.auto-api.com/api/v2/goonet_exchange

Autorizaçã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 dados

Para 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_id

Por onde começar:

1. Antes de carregar os anúncios, chame /change_id para a data de hoje e guarde o ID (se devolver 0, tente mais tarde); depois obtenha todas as páginas de /offers.

2. Consulte /changes a partir do ID guardado e passe depois next_change_id de cada resposta: assim recebe registos novos, preços novos e carros removidos.

3. Para a pesquisa no seu próprio site, consulte /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/goonet_exchange/filters?api_key=YOUR_API_KEY

Resposta:

{
  "mark": {
    "NISSAN": {
      "model": ["CIMA", "ELGRAND", "FAIRLADY Z", "MARCH", "MURANO", "NOTE", "SKYLINE", "X-TRAIL"]
    },
    "HONDA": {
      "model": ["ACCORD WAGON", "CIVIC", "FIT", "INSIGHT", "LEGEND", "N-BOX CUSTOM", "NSX", "VAMOS"]
    }
  },
  "transmission_type": ["AT", "MT"],
  "color": ["BLACK", "BLACK M", "BLUE M", "DARK BLUE", "GOLD M", "GRAY M", "GUN M", "LIGHT BLUE", "NAVY", "ORANGE", "PEARL", "PURPLE", "RED", "SILVER", "WHITE", "WINE M"],
  "body_type": ["Convertible", "Coupe", "Hatchback", "Kei RV", "Kei car", "Minivan", "Pickup truck", "SUV", "Sedan", "Station wagon"],
  "engine_type": ["DIESEL", "GASOLINE", "HYBRID"],
  "drive_type": ["2WD", "4WD"],
  "rudder": ["Left", "Right"]
}

GET/offers

Lista de listagens com paginação e filtros

Parâmetros:

page (obrigatório) - número da página
mark, model - marca e modelo
transmission_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úsculas
year_from, year_to - intervalo do ano da primeira matrícula
km_age_from, km_age_to - intervalo de quilometragem, em km
price_from, price_to - intervalo de preço FOB, em ienes

https://{access_name}.auto-api.com/api/v2/goonet_exchange/offers?api_key=YOUR_API_KEY&page=1

https://{access_name}.auto-api.com/api/v2/goonet_exchange/offers?api_key=YOUR_API_KEY&page=1&mark=NISSAN&model=X-TRAIL&year_from=2015&drive_type=4WD

Resposta:

{
  "result": [
    {
      "id": 104,
      "inner_id": "700080001830141121001",
      "change_type": "added",
      "created_at": "2026-09-12T23:35:41.955+03:00",
      "data": {
        "id": "104",
        "inner_id": "700080001830141121001",
        "url": "https://www.goo-net-exchange.com/usedcars/TOYOTA/LAND_CRUISER_70/700080001830141121001/",
        "mark": "TOYOTA",
        "model": "LAND CRUISER 70",
        "configuration": "KG-HZJ76K",
        "complectation": "ZX",
        "year": "2002",
        "price": "5862500",
        "km_age": "99000",
        "color": "GRAY M",
        "engine_type": "DIESEL",
        "body_type": "SUV",
        "transmission_type": "AT",
        "drive_type": "4WD",
        "rudder": "Right",
        "displacement": "4200",
        "doors_count": "5",
        "horse_power": "130",
        "vin": "HZJ76K-000****",
        "condition": "",
        "no_accidents": true,
        "owners_count": "",
        "equipment": "[\"Sun / Moon Roof\", \"Air Conditioner\", \"Power Steering\", \"Power Window\", \"Navigation\", \"Alloy WheelYes\"]",
        "city": "",
        "region": "Fukuoka",
        "address": "",
        "seller_type": "",
        "seller": "",
        "is_dealer": true,
        "salon_id": "",
        "salon_is_official": "",
        "full_model": "",
        "title": "TOYOTA LAND CRUISER 70 ZX",
        "description": "",
        "offer_created": "2026-07-03",
        "images": "[\"https://picture1.goo-net.com/7000800018/30141121/J/70008000183014112100100.jpg\", \"https://picture1.goo-net.com/080/0800018/J/0800018A30141121W00101.jpg\"]",
        "section": "used",
        "extra_prep": {
          "year_month": "2002-07",
          "is_price_ask": false,
          "price_usd": 38155,
          "domestic_price": 6000000,
          "power_kw": 96.0,
          "power_kw_estimated": false,
          "engine_code": "1HZ",
          "stock_number": "0800018A30141121W001",
          "model_code": "KG-HZJ76K",
          "chassis_no": "HZJ76K-000****",
          "repaired": "No Repair History",
          "seating_capacity": 5,
          "is_new": false,
          "is_certified": true,
          "is_trusted_dealer": true,
          "has_video": false,
          "videos": [],
          "evaluation": { "Engine": "Normal", "Exterior": "4", "Interior": "3", "Repaired": "No Repair" },
          "updated": "2026/07/03"
        }
      }
    }
  ],
  "meta": { "page": 1, "next_page": 2, "limit": 20 }
}

Campos do registo

Identificadores e ligações

id - número sequencial do registo na nossa base de dados; para cruzar com a plataforma use inner_id
inner_id - identificador do anúncio com 21 dígitos na plataforma, também presente no URL do anúncio: 700080001830141121001
url - ligação direta para o anúncio em goo-net-exchange.com
title - nome do carro numa linha, como no cabeçalho do anúncio: TOYOTA LAND CRUISER 70 ZX
section - secção da plataforma, sempre used

Marca, modelo, carroçaria

mark, model - marca e modelo em maiúsculas, como no URL do anúncio: TOYOTA, LAND CRUISER 70
configuration - código de modelo de fábrica segundo a classificação japonesa: KG-HZJ76K
complectation - grade, ou seja, o nível de equipamento: ZX, 240G, X
year - ano da primeira matrícula no Japão; para carros japoneses é o ano indicado no anúncio
color - cor da carroçaria tal como o concessionário a escreveu: BLACK, GRAY M, PEARL WHITE
body_type - tipo de carroçaria: SUV, Minivan, Kei car e outros valores de /filters
doors_count - número de portas, em falta em alguns carros

Motor, caixa, tração

engine_type - combustível: GASOLINE, DIESEL, HYBRID
displacement - cilindrada em centímetros cúbicos: 4200
horse_power - potência em cavalos; cadeia vazia quando a plataforma não tem dados
transmission_type - caixa de velocidades: AT ou MT
drive_type - tração: 2WD ou 4WD
rudder - lado do volante: Right ou Left

Preço, quilometragem, estado

price - preço FOB de exportação em ienes; -1 quando o concessionário mantém o preço sob consulta
km_age - quilometragem do conta-quilómetros em quilómetros: 99000
no_accidents - true significa o estado No Repair History: a carroçaria não foi reparada após acidente
condition - o que o concessionário declarou sobre o carro: um só dono, interior de não fumador, registos de manutenção; pode estar vazio
owners_count - 1 quando a menção One Owner está presente, caso contrário vazio
vin - número de chassis com os últimos quatro dígitos mascarados pela plataforma: HZJ76K-000****
equipment - lista de equipamento como array JSON dentro de uma cadeia: ar condicionado, teto de abrir, navegação e mais

Vendedor, fotos, datas

is_dealer - sempre true: na plataforma só vendem concessionários
region - prefeitura onde o carro se encontra: Fukuoka, Hyogo, Gunma
images - ligações das fotos como array JSON dentro de uma cadeia, muitas vezes várias dezenas de imagens
offer_created - data em que o concessionário atualizou o anúncio pela última vez
city, address, seller_type, seller, salon_id, salon_is_official, full_model, description - a plataforma não divulga estes dados, os campos chegam vazios
extra_prep - objeto aninhado com os restantes dados, descrito abaixo; o que a plataforma não tem chega como null ou vazio

Dentro de extra_prep

Preços

is_price_ask - true quando o preço é sob consulta; price fica então -1 e price_usd vazio
price_usd - o mesmo preço FOB convertido em dólares pela plataforma: 38155
domestic_price - preço a que o mesmo carro é oferecido a compradores dentro do Japão, em ienes: 6000000

Dados técnicos e códigos

year_month - mês da primeira matrícula: 2002-07
power_kw - potência em quilowatts; null quando indisponível
power_kw_estimated - true quando o valor em kW foi convertido a partir dos cavalos
engine_code - código de motor de fábrica: 1HZ, 2AZ-FE
model_code - o mesmo código de modelo que em configuration
chassis_no - o mesmo número de chassis mascarado que em vin
stock_number - número de stock do carro no concessionário
seating_capacity - número de lugares segundo a plataforma

Estado e confiança

repaired - estado de reparação nas palavras da plataforma: No Repair History ou Yes
evaluation - avaliações do relatório de inspeção: classificações de 1 a 5 para o interior e o exterior, avaliação do motor e informações sobre reparações após acidentes; null sem relatório
is_certified - true quando o anúncio tem relatório de inspeção anexado
is_trusted_dealer - true quando o vendedor tem o estatuto Trusted Dealer na plataforma
is_new - true para chegadas recentes marcadas como NEW

Vídeo e datas

has_video - true quando o concessionário filmou o carro
videos - ligações diretas para clipes mp4, lista vazia sem vídeo
updated - data de atualização tal como registada pela plataforma: 2026/07/03

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/goonet_exchange/change_id?api_key=YOUR_API_KEY&date=2026-09-14

Resposta:

{ "change_id": 61537 }

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/goonet_exchange/changes?api_key=YOUR_API_KEY&change_id=61537

Resposta:

{
  "result": [
    {
      "id": 61537,
      "inner_id": "700104006720070608004",
      "change_type": "added",    // added - new listing
      "created_at": "2026-09-14T09:03:12.118+03:00",
      "data": { ... }            // full listing data
    },
    {
      "id": 61538,
      "inner_id": "700080001830141121001",
      "change_type": "changed",  // changed - price update, JPY
      "created_at": "2026-09-14T09:47:55.604+03:00",
      "data": { "new_price": 5790000 }
    },
    {
      "id": 61539,
      "inner_id": "700090363730150113003",
      "change_type": "removed",  // removed - listing deleted
      "created_at": "2026-09-14T11:20:08.976+03:00",
      "data": {}
    }
  ],
  "meta": { "cur_change_id": 61537, "next_change_id": 61540, "limit": 20 }
}

GET/offer

Listagem única por inner_id

Parâmetros:

inner_id (obrigatório)

https://{access_name}.auto-api.com/api/v2/goonet_exchange/offer?api_key=YOUR_API_KEY&inner_id=700080001830141121001

Resposta: objeto data (igual a /offers, mas sem o wrapper result)

Exportações diárias

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:

https://{access_name}.auto-api.com/{date}/{file_name}

Parâmetros:

access_name - o seu subdomínio pessoal
date - data da exportação no formato aaaa-mm-dd, por ex. 2026-09-13
file_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.csv

Exemplo de comando Wget

wget --method GET \
  --header 'Authorization: Basic XXX==' \
  'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'

Goo-net Exchange

O Goo-net Exchange é a montra de exportação do grupo Proto Corporation, que também gere o goo-net.com, o mercado interno japonês. Concessionários de todo o Japão anunciam aqui carros para compradores estrangeiros, de kei cars e monovolumes a SUVs e desportivos. O site está em inglês, com preços em ienes e dólares.

A característica que o define é o preço FOB: já cobre a entrega num porto japonês e o carregamento a bordo. Cada registo inclui o mês da primeira matrícula, a quilometragem, a cilindrada, a caixa, a tração, o lado do volante, o estado de reparação após acidente e a lista de equipamento. Alguns concessionários juntam vídeo, e os carros com relatório de inspeção vêm com notas de interior e exterior.

Se importa carros do Japão, estes dados ajudam-no a poupar tempo na escolha dos veículos. Os novos anúncios chegam-lhe no prazo de uma hora após a publicação. As atualizações de preço chegam pelo mesmo feed. Compare o preço FOB com o preço no mercado interno japonês, quando ambos estiverem indicados, e consulte a potência em kW, se o concessionário a tiver fornecido. Os dados sobre reparações e os relatórios de inspeção disponíveis ajudam-no a descartar carros problemáticos antes de contactar o concessionário. Os registos com fotos estão prontos para publicação no seu site ou catálogo.

A Goo-net Exchange API funciona sem interrupção. Anúncios novos, alterações de preço e remoções entram no feed automaticamente. Tudo está disponível via REST, sem necessidade de um scraper seu.

Outros Dados Automotivos

Acesse dados de múltiplos mercados automotivos com APIs especializadas por plataforma:

🇦🇪

Dubizzle API

UAE dados automotivos API

🇪🇺

AutoScout24 API

Europe dados automotivos API

🇩🇪

Mobile.de API

Germany dados automotivos API

🇦🇪