Que m'apporte l'API Goo-net Exchange ?

Un accès direct aux annonces des concessionnaires japonais sur Goo-net Exchange sans développer de scraper. Des appels REST classiques renvoient des fiches véhicule : marque, modèle, finition, prix FOB, kilométrage, caractéristiques, équipements et photos. Un flux de changements séparé signale les nouvelles voitures, les mises à jour de prix et les annonces retirées.

Quels champs l'API renvoie-t-elle ?

Le prix FOB en yens avec son équivalent en dollars, plus le prix auquel la même voiture est affichée au Japon. Date de première immatriculation, kilométrage, cylindrée, boîte de vitesses, transmission, côté du volant, type de carrosserie, code modèle et numéro de châssis masqué, statut de réparation après accident, équipements et photos. La puissance, le code moteur, la vidéo et le rapport d'inspection ne sont présents que si le concessionnaire les a fournis.

En combien de temps les nouvelles annonces apparaissent-elles ?

Les nouvelles annonces arrivent dans l'API dans l'heure qui suit leur publication sur Goo-net Exchange. Les mises à jour de prix et les retraits passent par le même flux.

Quels formats sont disponibles ?

Une API REST avec des réponses en JSON. Pour le chargement quotidien en masse, des fichiers CSV, JSON et XLSX avec le même jeu de champs, prêts pour Excel ou un import en base de données.

Quels prix sont inclus ?

Le prix principal est le prix FOB : il comprend la livraison jusqu'à un port japonais et le chargement à bord, hors fret maritime et assurance. La plateforme l'affiche en yens et le convertit en dollars à son propre taux ; nous fournissons les deux valeurs. Vous recevez également le prix auquel la même voiture est proposée sur le marché intérieur japonais. Si le concessionnaire ne communique le prix que sur demande, price vaut -1, is_price_ask est true et price_usd reste vide.

Y a-t-il des données sur l'état et les réparations ?

Oui. Les données indiquent les réparations après accident signalées par la plateforme ainsi que les précisions du concessionnaire sur l'état du véhicule, lorsqu'elles sont disponibles : un seul propriétaire, habitacle non-fumeur, historique d'entretien. Si l'annonce comporte un rapport d'inspection, vous recevez aussi des notes de 1 à 5 pour l'habitacle et l'extérieur, une appréciation du moteur et des informations sur les réparations après accident.

Qui vend sur Goo-net Exchange ?

Uniquement des concessionnaires japonais, il n'y a pas d'annonces de particuliers. Les fiches incluent le statut Trusted Dealer et le numéro de stock chez le concessionnaire. La plateforme ne publie ni le nom ni les contacts des vendeurs, ces champs arrivent donc vides.

Goo-net Exchange APIScraper et parser

Goo-net Exchange API : annonces auto du Japon, prix FOB, rapports d'inspection et photos. Suivi des annonces et des prix, exports quotidiens. Sans scraper.

Bibliothèques SDK officielles

Bibliothèques clientes open source sur GitHub : installez le paquet et récupérez les annonces Goo-net Exchange dans votre application sans écrire les requêtes à la main.

PHP Node.js Python Go C#Java Ruby Rust

Goo-net Exchange API

Une seule API donne accès aux annonces des concessionnaires japonais sur Goo-net Exchange. Vous recevez les fiches des véhicules avec les prix FOB, les caractéristiques, les évaluations de l'état et les photos. Un flux de changements vous aide à tenir votre catalogue à jour. Ces données servent à rechercher des voitures sur commande, à analyser les prix et à alimenter un site d'annonces. Vous n'avez aucun scraper à développer ni à maintenir.

API

Les nouvelles annonces Goo-net Exchange arrivent dans le flux de changements dans l'heure qui suit leur publication.

Exports quotidiens

Un fichier par jour avec toutes les annonces actives de la plateforme.

Données complètes

Prix FOB et prix intérieur, première immatriculation, kilométrage, moteur et boîte, transmission et côté du volant, carrosserie, codes modèle et moteur, statut de réparation, équipements, photos, vidéo et notes d'état.

Obtenir un accès APIAccès accordé sous 2 minutes

API

URL de base

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

Autorisation : api_key paramètre

Flux de travail

/filtersobtenir les valeurs de filtre disponibles

/offersobtenir les annonces (avec ou sans filtres) - utiliser pour le chargement initial des données

Pour les mises à jour (maintenir les données à jour après le chargement initial) :

/change_id?date=...obtenir l'ID de départ pour le flux de changements

/changes?change_id=...obtenir tous les changements dans la base de données à partir de l'ID

/offerobtenir les détails d'une annonce spécifique par inner_id

Par où commencer :

1. Avant de charger les annonces, appelez /change_id pour la date du jour et conservez l'ID (s'il renvoie 0, réessayez plus tard), puis récupérez toutes les pages de /offers.

2. Interrogez /changes à partir de l'ID conservé, puis transmettez next_change_id de chaque réponse : vous obtenez ainsi les nouvelles fiches, les nouveaux prix et les voitures retirées.

3. Pour la recherche sur votre propre site, interrogez /offers avec les filtres dont vous avez besoin.

GET/filters

Retourne toutes les valeurs possibles pour le filtrage

https://{access_name}.auto-api.com/api/v2/goonet_exchange/filters?api_key=YOUR_API_KEY

Réponse :

{
  "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

Liste des annonces avec pagination et filtres

Paramètres :

page (requis) - numéro de page
mark, model - marque et modèle
transmission_type, color, body_type, engine_type, drive_type, rudder - boîte, couleur, type de carrosserie, carburant, transmission et côté du volant, sans distinction de casse
year_from, year_to - plage d'années de première immatriculation
km_age_from, km_age_to - plage de kilométrage, en km
price_from, price_to - plage de prix FOB, en yens

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

Réponse :

{
  "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 }
}

Champs de la fiche

Identifiants et liens

id - numéro séquentiel de la fiche dans notre base ; pour la faire correspondre à la plateforme, utilisez inner_id
inner_id - identifiant d'annonce à 21 chiffres sur la plateforme, présent aussi dans l'URL de l'annonce : 700080001830141121001
url - lien direct vers l'annonce sur goo-net-exchange.com
title - nom de la voiture sur une ligne, comme dans l'en-tête de l'annonce : TOYOTA LAND CRUISER 70 ZX
section - section de la plateforme, toujours used

Marque, modèle, carrosserie

mark, model - marque et modèle en majuscules, comme dans l'URL de l'annonce : TOYOTA, LAND CRUISER 70
configuration - code modèle constructeur selon la classification japonaise : KG-HZJ76K
complectation - grade, c'est-à-dire le niveau de finition : ZX, 240G, X
year - année de première immatriculation au Japon ; pour les voitures japonaises, c'est l'année indiquée dans l'annonce
color - couleur de carrosserie telle que le concessionnaire l'a écrite : BLACK, GRAY M, PEARL WHITE
body_type - type de carrosserie : SUV, Minivan, Kei car et autres valeurs de /filters
doors_count - nombre de portes, absent pour certaines voitures

Moteur, boîte, transmission

engine_type - carburant : GASOLINE, DIESEL, HYBRID
displacement - cylindrée en centimètres cubes : 4200
horse_power - puissance en chevaux ; chaîne vide quand la plateforme n'a pas de donnée
transmission_type - boîte de vitesses : AT ou MT
drive_type - transmission : 2WD ou 4WD
rudder - côté du volant : Right ou Left

Prix, kilométrage, état

price - prix FOB à l'exportation en yens ; -1 si le concessionnaire ne communique le prix que sur demande
km_age - kilométrage au compteur en kilomètres : 99000
no_accidents - true signifie le statut No Repair History : la carrosserie n'a pas été réparée après un accident
condition - ce que le concessionnaire a déclaré sur la voiture : un seul propriétaire, habitacle non-fumeur, historique d'entretien tenu ; peut être vide
owners_count - 1 quand la mention One Owner est présente, sinon vide
vin - numéro de châssis dont la plateforme masque les quatre derniers chiffres : HZJ76K-000****
equipment - liste des équipements sous forme de tableau JSON dans une chaîne : climatisation, toit ouvrant, navigation et plus

Vendeur, photos, dates

is_dealer - toujours true : seuls des concessionnaires vendent sur la plateforme
region - préfecture où se trouve la voiture : Fukuoka, Hyogo, Gunma
images - liens des photos sous forme de tableau JSON dans une chaîne, souvent plusieurs dizaines de clichés
offer_created - date de la dernière mise à jour de l'annonce par le concessionnaire
city, address, seller_type, seller, salon_id, salon_is_official, full_model, description - la plateforme ne divulgue pas ces informations, les champs arrivent vides
extra_prep - objet imbriqué avec le reste des données, décrit ci-dessous ; ce que la plateforme n'a pas arrive en null ou vide

Contenu de extra_prep

Prix

is_price_ask - true quand le prix est sur demande ; price vaut alors -1 et price_usd est vide
price_usd - le même prix FOB converti en dollars par la plateforme : 38155
domestic_price - prix auquel la même voiture est proposée aux acheteurs au Japon, en yens : 6000000

Données techniques et codes

year_month - mois de première immatriculation : 2002-07
power_kw - puissance en kilowatts ; null si indisponible
power_kw_estimated - true quand la valeur en kW a été convertie depuis les chevaux
engine_code - code moteur constructeur : 1HZ, 2AZ-FE
model_code - le même code modèle que dans configuration
chassis_no - le même numéro de châssis masqué que dans vin
stock_number - numéro de stock de la voiture chez le concessionnaire
seating_capacity - nombre de places selon la plateforme

État et confiance

repaired - statut de réparation dans les termes de la plateforme : No Repair History ou Yes
evaluation - évaluations du rapport d'inspection : notes de 1 à 5 pour l'habitacle et l'extérieur, appréciation du moteur et informations sur les réparations après accident ; null sans rapport
is_certified - true quand un rapport d'inspection est joint à l'annonce
is_trusted_dealer - true quand le vendeur a le statut Trusted Dealer sur la plateforme
is_new - true pour les nouvelles arrivées marquées NEW

Vidéo et dates

has_video - true quand le concessionnaire a filmé la voiture
videos - liens directs vers les clips mp4, liste vide sans vidéo
updated - date de mise à jour telle qu'enregistrée par la plateforme : 2026/07/03

GET/change_id

Obtenir le premier ID de changement par date (pour utiliser dans /changes)

Paramètres :

date (requis) - date au format yyyy-mm-dd

https://{access_name}.auto-api.com/api/v2/goonet_exchange/change_id?api_key=YOUR_API_KEY&date=2026-09-14

Réponse :

{ "change_id": 61537 }

Utilisez la valeur retournée comme paramètre change_id dans /changes

GET/changes

Flux de changements (ajouté/modifié/supprimé)

Paramètres :

change_id (requis) - à partir de quel ID de changement

https://{access_name}.auto-api.com/api/v2/goonet_exchange/changes?api_key=YOUR_API_KEY&change_id=61537

Réponse :

{
  "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

Annonce unique par inner_id

Paramètres :

inner_id (requis)

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

Réponse : objet data (identique à /offers, mais sans l'enveloppe result)

Exports quotidiens

Conservation

Les fichiers restent disponibles au moins 3 jours

Disponibilité

De nouveaux fichiers chaque matin

Format CSV

Les colonnes CSV sont séparées par le caractère pipe (|)

Structure de l'URL :

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

Paramètres :

access_name - votre sous-domaine personnel
date - date de l'export au format aaaa-mm-jj, par ex. 2026-09-13
file_name - nom du fichier avec extension

Fichiers disponibles :

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

Exemple de requête 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

Exemple de commande Wget

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

Goo-net Exchange

Goo-net Exchange est la vitrine export du groupe Proto Corporation, qui gère aussi goo-net.com, la place de marché intérieure japonaise. Des concessionnaires de tout le Japon y proposent des voitures aux acheteurs étrangers, des kei cars et monospaces aux SUV et voitures de sport. Le site est en anglais, les prix sont affichés en yens et en dollars.

Sa particularité, c'est le prix FOB : il couvre déjà la livraison jusqu'à un port japonais et le chargement à bord. Chaque fiche indique le mois de première immatriculation, le kilométrage, la cylindrée, la boîte, la transmission, le côté du volant, le statut de réparation après accident et la liste des équipements. Certains concessionnaires ajoutent une vidéo, et les voitures avec rapport d'inspection arrivent avec des notes intérieur et extérieur.

Si vous importez des voitures du Japon, ces données vous font gagner du temps dans la sélection des véhicules. Les nouvelles annonces vous parviennent dans l'heure qui suit leur publication. Les mises à jour de prix passent par le même flux. Comparez le prix FOB et le prix du marché intérieur japonais lorsque le concessionnaire les a renseignés, et consultez la puissance en kW lorsqu'elle est disponible. Les informations sur les réparations et les rapports d'inspection disponibles vous aident à écarter les voitures à problèmes avant même de contacter le concessionnaire. Les fiches avec photos sont prêtes à être publiées sur votre site ou dans votre catalogue.

L'API Goo-net Exchange fonctionne en continu. Nouvelles annonces, changements de prix et retraits entrent automatiquement dans le flux. Tout est disponible via REST, aucun scraper de votre côté n'est nécessaire.

Autres données automobiles

Étendez votre accès aux données automobiles sur les marchés mondiaux avec nos API de plateforme complètes :

🇦🇪

Dubizzle API

UAE données automobiles API

🇪🇺

AutoScout24 API

Europe données automobiles API

🇩🇪

Mobile.de API

Germany données automobiles API

🇦🇪