Goo-net Exchange APIScraper i parser
Goo-net Exchange API: oferty aut z Japonii, ceny FOB, raporty z oględzin i zdjęcia. Nowe oferty, zmiany cen i codzienne eksporty. Bez własnego scrapera.
Goo-net Exchange API
Jedno API udostępnia ogłoszenia japońskich dealerów z platformy eksportowej Goo-net Exchange. Otrzymujesz dane pojazdów z cenami FOB, parametrami technicznymi, oceną stanu i zdjęciami. Strumień zmian pomaga aktualizować katalog. Dane przydadzą się przy sprowadzaniu aut na zamówienie, analizie cen i prowadzeniu serwisu z ogłoszeniami. Nie musisz tworzyć ani utrzymywać własnego scrapera.
Nowe oferty Goo-net Exchange trafiają do strumienia zmian w ciągu godziny od publikacji.
Jeden plik dziennie ze wszystkimi aktywnymi ofertami na platformie.
Ceny FOB i wewnętrzne, pierwsza rejestracja, przebieg, silnik i skrzynia biegów, napęd i strona kierownicy, typ nadwozia, kody modelu i silnika, status naprawy, wyposażenie, zdjęcia, wideo i oceny stanu.
Bazowy URL
https://{access_name}.auto-api.com/api/v2/goonet_exchangeAutoryzacja: api_key parametr
Schemat integracji
/filterspobierz dostępne wartości filtrów/offerspobierz ogłoszenia (z filtrami lub bez) - użyj do początkowego ładowania danychDla aktualizacji (utrzymanie aktualności danych po początkowym ładowaniu):
/change_id?date=...pobierz początkowe ID dla strumienia zmian/changes?change_id=...pobierz wszystkie zmiany w bazie danych od podanego ID/offerpobierz szczegóły konkretnego ogłoszenia według inner_idOd czego zacząć:
1. Przed pobraniem ofert wywołaj /change_id dla dzisiejszej daty i zapisz ID (jeśli zwróci 0, spróbuj później), potem pobierz wszystkie strony /offers.
2. Odpytuj /changes od zapisanego ID, a dalej przekazuj next_change_id z każdej odpowiedzi: tak dostaniesz świeże rekordy, nowe ceny i usunięte auta.
3. Do wyszukiwania na własnej stronie odpytuj /offers z potrzebnymi filtrami.
GET/filters
Zwraca wszystkie możliwe wartości do filtrowania
https://{access_name}.auto-api.com/api/v2/goonet_exchange/filters?api_key=YOUR_API_KEYOdpowiedź:
{
"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 ogłoszeń z paginacją i filtrami
Parametry:
page(wymagane) - numer stronymark, model- marka i modeltransmission_type, color, body_type, engine_type, drive_type, rudder- skrzynia biegów, kolor, typ nadwozia, paliwo, napęd i strona kierownicy, bez rozróżniania wielkości literyear_from, year_to- zakres roku pierwszej rejestracjikm_age_from, km_age_to- zakres przebiegu w kmprice_from, price_to- zakres ceny FOB w jenach
https://{access_name}.auto-api.com/api/v2/goonet_exchange/offers?api_key=YOUR_API_KEY&page=1https://{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=4WDOdpowiedź:
{
"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 }
}Pola rekordu
Identyfikatory i linki
- id - kolejny numer rekordu w naszej bazie; do dopasowania z platformą używaj inner_id
- inner_id - 21-cyfrowy identyfikator oferty na platformie, obecny też w adresie oferty: 700080001830141121001
- url - bezpośredni link do oferty na goo-net-exchange.com
- title - nazwa auta w jednej linii, jak w nagłówku oferty: TOYOTA LAND CRUISER 70 ZX
- section - sekcja platformy, zawsze used
Marka, model, nadwozie
- mark, model - marka i model wielkimi literami, jak w adresie oferty: TOYOTA, LAND CRUISER 70
- configuration - fabryczny kod modelu według japońskiej klasyfikacji: KG-HZJ76K
- complectation - grade, czyli wersja wyposażenia: ZX, 240G, X
- year - rok pierwszej rejestracji w Japonii; dla japońskich aut to rok podany w ofercie
- color - kolor nadwozia tak, jak wpisał go dealer: BLACK, GRAY M, PEARL WHITE
- body_type - typ nadwozia: SUV, Minivan, Kei car i inne wartości z /filters
- doors_count - liczba drzwi, dla części aut brak
Silnik, skrzynia, napęd
- engine_type - paliwo: GASOLINE, DIESEL, HYBRID
- displacement - pojemność silnika w centymetrach sześciennych: 4200
- horse_power - moc w koniach mechanicznych; pusty ciąg, gdy platforma nie ma danych
- transmission_type - skrzynia biegów: AT lub MT
- drive_type - napęd: 2WD lub 4WD
- rudder - strona kierownicy: Right lub Left
Cena, przebieg, stan
- price - eksportowa cena FOB w jenach; -1, gdy dealer podaje cenę na zapytanie
- km_age - przebieg z licznika w kilometrach: 99000
- no_accidents - true oznacza status No Repair History: nadwozie nie było naprawiane po wypadku
- condition - co dealer zadeklarował o aucie: jeden właściciel, w aucie nie palono, jest historia serwisowa; może być puste
- owners_count - 1, gdy ustawione jest oznaczenie One Owner, w przeciwnym razie puste
- vin - numer nadwozia z czterema ostatnimi cyframi zamaskowanymi przez platformę: HZJ76K-000****
- equipment - lista wyposażenia jako tablica JSON w ciągu znaków: klimatyzacja, szyberdach, nawigacja i więcej
Sprzedawca, zdjęcia, daty
- is_dealer - zawsze true: na platformie sprzedają wyłącznie dealerzy
- region - prefektura, w której stoi auto: Fukuoka, Hyogo, Gunma
- images - linki do zdjęć jako tablica JSON w ciągu znaków, często kilkadziesiąt ujęć
- offer_created - data ostatniej aktualizacji oferty przez dealera
- city, address, seller_type, seller, salon_id, salon_is_official, full_model, description - platforma nie ujawnia tych danych, pola przychodzą puste
- extra_prep - zagnieżdżony obiekt z pozostałymi danymi, opisany niżej; czego platforma nie ma, przychodzi jako null lub puste
Zawartość extra_prep
Ceny
- is_price_ask - true, gdy cena jest na zapytanie; price wynosi wtedy -1, a price_usd jest puste
- price_usd - ta sama cena FOB przeliczona przez platformę na dolary: 38155
- domestic_price - cena, za jaką to samo auto jest oferowane kupującym w Japonii, w jenach: 6000000
Dane techniczne i kody
- year_month - miesiąc pierwszej rejestracji: 2002-07
- power_kw - moc w kilowatach; null, gdy brak danych
- power_kw_estimated - true, gdy wartość w kW została przeliczona z koni mechanicznych
- engine_code - fabryczny kod silnika: 1HZ, 2AZ-FE
- model_code - ten sam kod modelu co w configuration
- chassis_no - ten sam zamaskowany numer nadwozia co w vin
- stock_number - numer magazynowy auta u dealera
- seating_capacity - liczba miejsc według platformy
Stan i wiarygodność
- repaired - status naprawy w sformułowaniu platformy: No Repair History lub Yes
- evaluation - oceny z raportu z oględzin: wnętrze i nadwozie w skali od 1 do 5, ocena silnika i informacja o naprawach powypadkowych; null bez raportu
- is_certified - true, gdy do oferty dołączono raport z oględzin
- is_trusted_dealer - true, gdy sprzedawca ma na platformie status Trusted Dealer
- is_new - true dla świeżych ofert oznaczonych NEW
Wideo i daty
- has_video - true, gdy dealer nagrał auto na wideo
- videos - bezpośrednie linki do klipów mp4, pusta lista bez wideo
- updated - data aktualizacji zapisana przez platformę: 2026/07/03
GET/change_id
Pobierz pierwsze ID zmiany według daty (do użycia w /changes)
Parametry:
date(wymagane) - data w formacie yyyy-mm-dd
https://{access_name}.auto-api.com/api/v2/goonet_exchange/change_id?api_key=YOUR_API_KEY&date=2026-09-14Odpowiedź:
{ "change_id": 61537 }Użyj zwróconej wartości jako parametru change_id w /changes
GET/changes
Strumień zmian (dodano/zmieniono/usunięto)
Parametry:
change_id(wymagane) - od którego ID zmiany
https://{access_name}.auto-api.com/api/v2/goonet_exchange/changes?api_key=YOUR_API_KEY&change_id=61537Odpowiedź:
{
"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
Pojedyncze ogłoszenie według inner_id
Parametry:
inner_id(wymagane)
https://{access_name}.auto-api.com/api/v2/goonet_exchange/offer?api_key=YOUR_API_KEY&inner_id=700080001830141121001Odpowiedź: obiekt data (taki sam jak w /offers, ale bez wrappera result)
Przechowywanie
Pliki pozostają dostępne przez co najmniej 3 dni
Dostępność
Świeże pliki każdego ranka
Format CSV
Kolumny CSV są rozdzielone znakiem pipe (|)
Struktura URL:
Parametry:
access_name- Twoja osobista subdomenadate- data eksportu w formacie rrrr-mm-dd, np. 2026-09-13file_name- nazwa pliku z rozszerzeniem
Dostępne pliki:
- 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
Przykład żądania 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.csvPrzykład polecenia Wget
wget --method GET \
--header 'Authorization: Basic XXX==' \
'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'Goo-net Exchange to platforma eksportowa grupy Proto Corporation, która prowadzi też goo-net.com, serwis ogłoszeniowy dla kupujących w Japonii. Dealerzy z całej Japonii wystawiają tu auta dla kupujących z zagranicy, od kei carów i minivanów po SUV-y i auta sportowe. Serwis jest po angielsku, ceny podane są w jenach i dolarach.
Cechą charakterystyczną jest cena FOB: obejmuje już dostawę do japońskiego portu i załadunek na statek. Każdy rekord zawiera miesiąc pierwszej rejestracji, przebieg, pojemność silnika, skrzynię biegów, napęd, stronę kierownicy, status naprawy powypadkowej i listę wyposażenia. Część dealerów dodaje wideo, a auta z raportem z oględzin mają oceny wnętrza i nadwozia.
Jeśli sprowadzasz auta z Japonii, te dane pomogą Ci zaoszczędzić czas przy wyborze samochodów. Nowe ogłoszenia otrzymujesz w ciągu godziny od publikacji. Aktualizacje cen docierają tym samym strumieniem. Możesz porównać cenę FOB z ceną na japońskim rynku krajowym, jeśli dealer podał obie, oraz sprawdzić moc silnika w kW, jeśli jest dostępna. Informacje o naprawach powypadkowych i dostępne raporty z oględzin pomagają odrzucić problematyczne auta, zanim skontaktujesz się z dealerem. Dane pojazdów ze zdjęciami są gotowe do publikacji na Twojej stronie lub w katalogu.
Goo-net Exchange API działa całą dobę. Nowe oferty, zmiany cen i usunięcia trafiają do strumienia automatycznie. Wszystko jest dostępne przez REST, własny scraper nie jest potrzebny.
Rozszerz swój zasięg danych motoryzacyjnych na rynki globalne dzięki naszym wszechstronnym interfejsom API dla platform: