What does the Goo-net Exchange API give me?

Direct access to listings from Japanese dealers on Goo-net Exchange without building a scraper. Standard REST calls return vehicle records: make, model, grade, FOB price, mileage, specifications, equipment and photos. A separate change feed reports new listings, price updates and removed listings.

Which fields does the API return?

The FOB price in yen with its USD equivalent, plus the price the same car is listed at inside Japan. First registration date, mileage, engine displacement, transmission, drivetrain, steering side, body type, model code and a masked chassis number, accident repair status, equipment and photos. Power output, engine code, video and the inspection report are present only where the dealer provided them.

How fast do new listings show up?

New listings reach the API within an hour of going live on Goo-net Exchange. Price updates and removals arrive through the same feed.

Which formats are available?

REST API with JSON responses. For daily bulk loading there are CSV, JSON and XLSX files with the same set of fields, ready for Excel or a database import.

Which prices are included?

The main price is FOB: delivery to a Japanese port and loading on board, freight and insurance excluded. The marketplace shows it in yen and converts it to dollars at its own rate; we deliver both values. Separately you get the price the same car is offered at on the Japanese domestic market. When a dealer keeps the price on request, price is -1, is_price_ask is true and price_usd is empty.

Is there condition and repair data?

Yes. Each record carries the marketplace's accident repair status and the condition notes the dealer declared: one owner, non-smoking interior, service records available. Cars with an inspection report also return interior and exterior scores from 1 to 5, an engine verdict and a repair verdict.

Who sells on Goo-net Exchange?

Japanese dealers only, there are no private listings. Records include the Trusted Dealer status and the dealer's stock number. The marketplace does not publish seller names or contacts, so those fields arrive empty.

Goo-net Exchange APIScraper & Parser

Goo-net Exchange API: Japanese dealer listings with FOB prices, reports and photos. New listings, price updates and daily exports. No scraper needed.

Official SDK Libraries

Open-source client libraries on GitHub: install the package and pull Goo-net Exchange listings into your application without hand-written request code.

PHP Node.js Python Go C#Java Ruby Rust

Goo-net Exchange API

Listings from Japan's dealer export marketplace through a single API. You get vehicle records with FOB prices, specifications, condition scores and photos, and a change feed that keeps your catalog current. Built for sourcing cars to order, price analytics and aggregator sites. No scraper to write or maintain.

API

New Goo-net Exchange listings land in the change feed within an hour of publication.

Daily Exports

One file a day with every active listing on the marketplace.

Complete Data

FOB and domestic prices, first registration, mileage, engine and transmission, drivetrain and steering side, body type, model and engine codes, repair status, equipment, photos, video and condition scores.

Get API AccessAccess provided within 2 minutes

API

Base URL

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

Authorization: api_key parameter

Workflow

/filtersget available filter values

/offersget listings (with or without filters) - use for initial data load

For updates (to keep data up-to-date after initial load):

/change_id?date=...get starting ID for changes feed

/changes?change_id=...get all changes in the database starting from ID

/offerget details of a specific listing by inner_id

Where to start:

1. Before loading listings, call /change_id for today's date and store the ID (if it returns 0, retry later), then fetch every page of /offers.

2. Poll /changes starting from the stored ID and then pass next_change_id from each response: this gives you fresh records, new prices and removed cars.

3. For search on your own site, query /offers with the filters you need.

GET/filters

Returns all possible values for filtering

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

Response:

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

List of listings with pagination and filters

Parameters:

page (required) - page number
mark, model - make and model
transmission_type, color, body_type, engine_type, drive_type, rudder - transmission, color, body type, fuel, drivetrain and steering side, case-insensitive
year_from, year_to - first registration year range
km_age_from, km_age_to - mileage range, km
price_from, price_to - FOB price range, yen

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

Response:

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

Record fields

Identifiers and links

id - sequential record number in our database; use inner_id to match with the marketplace
inner_id - 21-digit listing identifier at the marketplace, also part of the listing URL: 700080001830141121001
url - direct link to the listing on goo-net-exchange.com
title - car name in one line, as in the listing header: TOYOTA LAND CRUISER 70 ZX
section - marketplace section, always used

Make, model, body

mark, model - make and model in upper case, as in the listing URL: TOYOTA, LAND CRUISER 70
configuration - factory model code under the Japanese classification: KG-HZJ76K
complectation - grade, i.e. the trim level: ZX, 240G, X
year - year of first registration in Japan; for Japanese cars this is the year shown in the listing
color - body color as the dealer wrote it: BLACK, GRAY M, PEARL WHITE
body_type - body type: SUV, Minivan, Kei car and other values from /filters
doors_count - number of doors, missing for some cars

Engine, transmission, drivetrain

engine_type - fuel: GASOLINE, DIESEL, HYBRID
displacement - engine displacement in cubic centimeters: 4200
horse_power - power in horsepower; an empty string when the marketplace has no data
transmission_type - gearbox: AT or MT
drive_type - drivetrain: 2WD or 4WD
rudder - steering side: Right or Left

Price, mileage, condition

price - export FOB price in yen; -1 when the dealer keeps the price on request
km_age - odometer reading in kilometers: 99000
no_accidents - true means the No Repair History status: the body was not repaired after an accident
condition - what the dealer declared about the car: one owner, non-smoking interior, service records kept; may be empty
owners_count - 1 when the One Owner mark is set, otherwise empty
vin - chassis number with the last four digits masked by the marketplace: HZJ76K-000****
equipment - equipment list as a JSON array inside a string: air conditioning, sunroof, navigation and more

Seller, photos, dates

is_dealer - always true: only dealers sell on the marketplace
region - prefecture where the car is located: Fukuoka, Hyogo, Gunma
images - photo links as a JSON array inside a string, often several dozen shots
offer_created - date the dealer last updated the listing
city, address, seller_type, seller, salon_id, salon_is_official, full_model, description - the marketplace does not disclose these, they arrive empty
extra_prep - nested object with the remaining data, described below; anything the marketplace lacks arrives as null or empty

Inside extra_prep

Prices

is_price_ask - true when the price is on request; price is then -1 and price_usd is empty
price_usd - the same FOB price converted to dollars by the marketplace: 38155
domestic_price - the price the same car is offered at to buyers inside Japan, in yen: 6000000

Technical data and codes

year_month - month of first registration: 2002-07
power_kw - power in kilowatts; null when unavailable
power_kw_estimated - true when the kilowatt figure was converted from horsepower
engine_code - factory engine code: 1HZ, 2AZ-FE
model_code - the same model code as in configuration
chassis_no - the same masked chassis number as in vin
stock_number - the car's stock number at the dealer
seating_capacity - number of seats according to the marketplace

Condition and trust

repaired - repair status in the marketplace's own wording: No Repair History or Yes
evaluation - inspection report scores: interior and exterior from 1 to 5, engine and repair verdicts; null without a report
is_certified - true when an inspection report is attached to the listing
is_trusted_dealer - true when the seller holds the marketplace's Trusted Dealer status
is_new - true for fresh arrivals marked NEW

Video and dates

has_video - true when the dealer filmed the car
videos - direct links to mp4 clips, an empty list without video
updated - update date as recorded by the marketplace: 2026/07/03

GET/change_id

Get first change ID by date (for use in /changes)

Parameters:

date (required) - date in yyyy-mm-dd format

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

Response:

{ "change_id": 61537 }

Use the returned value as the change_id parameter in /changes

GET/changes

Changes feed (added/changed/removed)

Parameters:

change_id (required) - starting from which change ID

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

Response:

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

Single listing by inner_id

Parameters:

inner_id (required)

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

Response: data object (same as in /offers, but without result wrapper)

Daily Exports

Retention

Files stay available for at least 3 days

Availability

Fresh files every morning

CSV Format

CSV columns are separated by the pipe character (|)

URL structure:

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

Parameters:

access_name - your personal subdomain
date - export date in yyyy-mm-dd format, e.g. 2026-09-13
file_name - file name with extension

Available files:

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

cURL request example

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

Wget command example

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 is the export storefront of the Proto Corporation group, which also runs goo-net.com, the domestic Japanese marketplace. Dealers from all over Japan list cars here for overseas buyers, from kei cars and minivans to SUVs and sports cars. The site is in English, with prices shown in yen and dollars.

The defining feature is the FOB price: it already covers delivery to a Japanese port and loading on board. Each record includes the first registration month, mileage, engine displacement, transmission, drivetrain, steering side, accident repair status and the equipment list. Some dealers add video, and cars with an inspection report come with interior and exterior scores.

If you import cars from Japan, this data saves you time when picking vehicles. New listings reach you within the hour of publication, and price updates come through the same feed. Compare the FOB price with the Japanese domestic price where the dealer lists both, and check the engine power in kW where it is available. Repair status and inspection reports help you drop problem cars before you even contact the dealer. Records with photos are ready to publish on your website or in your catalog.

The Goo-net Exchange API runs around the clock. New listings, price changes and removals enter the feed automatically. Everything is available over REST, no scraper of your own required.

Other Automotive Data

Expand your automotive data coverage across global markets with our platform APIs:

🇦🇪

Dubizzle API

UAE automotive data API

🇪🇺

AutoScout24 API

Europe automotive data API

🇩🇪

Mobile.de API

Germany automotive data API

🇦🇪