Jaká data poskytuje API Goo-net Exchange?

Přímý přístup k inzerátům japonských dealerů na Goo-net Exchange bez stavby scraperu. Běžná volání REST vracejí záznamy vozidel: značku, model, výbavovou verzi, cenu FOB, nájezd, technické údaje, výbavu a fotky. Samostatný feed změn hlásí nové vozy, úpravy cen a odstraněné inzeráty.

Která pole API vrací?

Cenu FOB v jenech s protihodnotou v dolarech a k tomu cenu, za kterou je stejný vůz nabízen uvnitř Japonska. Datum první registrace, nájezd, objem motoru, převodovku, pohon, stranu volantu, typ karoserie, kód modelu a maskované číslo karoserie, stav opravy po nehodě, výbavu a fotky. Výkon, kód motoru, video a zpráva z prohlídky jsou přítomny jen tam, kde je dealer uvedl.

Jak rychle se objeví nové inzeráty?

Nové inzeráty dorazí do API do hodiny od zveřejnění na Goo-net Exchange. Úpravy cen a odstranění přicházejí stejným feedem.

Jaké formáty jsou k dispozici?

REST API s odpověďmi v JSON. Pro denní hromadné načítání jsou k dispozici soubory CSV, JSON a XLSX se stejnou sadou polí, připravené pro Excel nebo import do databáze.

Jaké ceny jsou v datech?

Hlavní cena je FOB: doprava do japonského přístavu a naložení na loď, bez námořní přepravy a pojištění. Platforma ji zobrazuje v jenech a přepočítává na dolary vlastním kurzem; dodáváme obě hodnoty. Zvlášť dostanete cenu, za kterou je stejný vůz nabízen na japonském domácím trhu. Když dealer nechá cenu na dotaz, price je -1, is_price_ask je true a price_usd zůstává prázdné.

Jsou k dispozici údaje o stavu a opravách?

Ano. Data obsahují údaje platformy o opravách po nehodě a dostupné informace od dealera o stavu vozu, například o jediném majiteli, nekuřáckém interiéru a servisní historii. Pokud je k inzerátu přiložena zpráva z prohlídky, získáte také hodnocení interiéru a exteriéru od 1 do 5, hodnocení motoru a údaje o opravách po nehodě.

Kdo na Goo-net Exchange prodává?

Pouze japonští dealeři, soukromé inzeráty tu nejsou. Záznamy obsahují status Trusted Dealer a skladové číslo vozu u dealera. Platforma nezveřejňuje jména ani kontakty prodejců, takže tato pole přicházejí prázdná.

Goo-net Exchange APIScraper a parser

Goo-net Exchange API: inzeráty japonských dealerů s cenami FOB, zprávami o stavu a fotkami. Feed změn s novými inzeráty a úpravami cen, denní exporty. Bez vlastního scraperu.

Oficiální SDK knihovny

Open source klientské knihovny na GitHubu: nainstalujte balíček a stahujte inzeráty Goo-net Exchange do své aplikace bez ručního psaní požadavků.

PHP Node.js Python Go C#Java Ruby Rust

Goo-net Exchange API

Přes jediné API získáte inzeráty japonských dealerů z exportní platformy Goo-net Exchange. Součástí dat jsou ceny FOB, technické údaje, hodnocení stavu a fotografie. Feed změn vám pomůže udržovat katalog aktuální. Data využijete při dovozu aut na objednávku, analýze cen i provozu inzertního webu. Vlastní scraper nemusíte vyvíjet ani udržovat.

API

Nové inzeráty Goo-net Exchange přistanou ve feedu změn do hodiny od zveřejnění.

Denní exporty

Jeden soubor denně se všemi aktivními inzeráty na platformě.

Kompletní data

Ceny FOB a domácí, první registrace, nájezd, motor a převodovka, pohon a strana volantu, karoserie, kódy modelu a motoru, stav opravy, výbava, fotky, video a hodnocení stavu.

Získat přístup k APIPřístup poskytnut do 2 minut

API

Základní URL

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

Autorizace: api_key parametr

Pracovní postup

/filterszískat dostupné hodnoty filtrů

/offerszískat inzeráty (s filtry nebo bez nich) - použít pro počáteční načtení dat

Pro aktualizace (udržování dat aktuálních po počátečním načtení):

/change_id?date=...získat počáteční ID pro stream změn

/changes?change_id=...získat všechny změny v databázi od daného ID

/offerzískat detaily konkrétního inzerátu podle inner_id

Kde začít:

1. Před načtením inzerátů zavolejte /change_id pro dnešní datum a uložte si ID (pokud vrátí 0, zkuste to později), pak stáhněte všechny stránky /offers.

2. Dotazujte /changes od uloženého ID a dál předávejte next_change_id z každé odpovědi: tak získáte nové záznamy, nové ceny a odstraněné vozy.

3. Pro vyhledávání na vlastním webu dotazujte /offers s filtry, které potřebujete.

GET/filters

Vrací všechny možné hodnoty pro filtrování

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

Odpověď:

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

Seznam inzerátů s stránkováním a filtry

Parametry:

page (povinné) - číslo stránky
mark, model - značka a model
transmission_type, color, body_type, engine_type, drive_type, rudder - převodovka, barva, typ karoserie, palivo, pohon a strana volantu, bez rozlišení velikosti písmen
year_from, year_to - rozsah roku první registrace
km_age_from, km_age_to - rozsah nájezdu v km
price_from, price_to - rozsah ceny FOB v jenech

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

Odpověď:

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

Pole záznamu

Identifikátory a odkazy

id - pořadové číslo záznamu v naší databázi; pro párování s platformou použijte inner_id
inner_id - 21místný identifikátor inzerátu na platformě, obsažený i v URL inzerátu: 700080001830141121001
url - přímý odkaz na inzerát na goo-net-exchange.com
title - název vozu na jednom řádku, jako v záhlaví inzerátu: TOYOTA LAND CRUISER 70 ZX
section - sekce platformy, vždy used

Značka, model, karoserie

mark, model - značka a model velkými písmeny, jako v URL inzerátu: TOYOTA, LAND CRUISER 70
configuration - tovární kód modelu podle japonské klasifikace: KG-HZJ76K
complectation - grade, tedy výbavová verze: ZX, 240G, X
year - rok první registrace v Japonsku; u japonských vozů je to rok uvedený v inzerátu
color - barva karoserie tak, jak ji dealer zapsal: BLACK, GRAY M, PEARL WHITE
body_type - typ karoserie: SUV, Minivan, Kei car a další hodnoty z /filters
doors_count - počet dveří, u části vozů chybí

Motor, převodovka, pohon

engine_type - palivo: GASOLINE, DIESEL, HYBRID
displacement - objem motoru v kubických centimetrech: 4200
horse_power - výkon v koních; prázdný řetězec, když platforma údaj nemá
transmission_type - převodovka: AT nebo MT
drive_type - pohon: 2WD nebo 4WD
rudder - strana volantu: Right nebo Left

Cena, nájezd, stav

price - exportní cena FOB v jenech; -1, když dealer nechává cenu na dotaz
km_age - stav tachometru v kilometrech: 99000
no_accidents - true znamená status No Repair History: karoserie nebyla po nehodě opravována
condition - co dealer o voze deklaroval: jeden majitel, nekuřácký interiér, vedená servisní historie; může být prázdné
owners_count - 1, když je nastavena značka One Owner, jinak prázdné
vin - číslo karoserie, jehož poslední čtyři číslice platforma maskuje: HZJ76K-000****
equipment - seznam výbavy jako pole JSON v řetězci: klimatizace, střešní okno, navigace a další

Prodejce, fotky, data

is_dealer - vždy true: na platformě prodávají jen dealeři
region - prefektura, kde vůz stojí: Fukuoka, Hyogo, Gunma
images - odkazy na fotky jako pole JSON v řetězci, často několik desítek snímků
offer_created - datum, kdy dealer inzerát naposledy aktualizoval
city, address, seller_type, seller, salon_id, salon_is_official, full_model, description - tyto údaje platforma nezveřejňuje, pole přicházejí prázdná
extra_prep - vnořený objekt se zbývajícími daty, popsaný níže; co platforma nemá, přichází jako null nebo prázdné

Uvnitř extra_prep

Ceny

is_price_ask - true, když je cena na dotaz; price je pak -1 a price_usd prázdné
price_usd - stejná cena FOB přepočtená platformou na dolary: 38155
domestic_price - cena, za kterou je stejný vůz nabízen kupcům uvnitř Japonska, v jenech: 6000000

Technické údaje a kódy

year_month - měsíc první registrace: 2002-07
power_kw - výkon v kilowattech; null, pokud údaj není k dispozici
power_kw_estimated - true, když byla hodnota v kW přepočtena z koní
engine_code - tovární kód motoru: 1HZ, 2AZ-FE
model_code - stejný kód modelu jako v configuration
chassis_no - stejné maskované číslo karoserie jako ve vin
stock_number - skladové číslo vozu u dealera
seating_capacity - počet míst k sezení podle platformy

Stav a důvěryhodnost

repaired - stav opravy ve formulaci platformy: No Repair History nebo Yes
evaluation - hodnocení ze zprávy z prohlídky: interiér a exteriér od 1 do 5, hodnocení motoru a údaje o opravách po nehodě; null bez zprávy
is_certified - true, když je k inzerátu přiložena zpráva z prohlídky
is_trusted_dealer - true, když prodejce má na platformě status Trusted Dealer
is_new - true u nových přírůstků označených NEW

Video a data

has_video - true, když dealer vůz natočil na video
videos - přímé odkazy na klipy mp4, bez videa prázdný seznam
updated - datum aktualizace, jak jej zaznamenala platforma: 2026/07/03

GET/change_id

Získat první ID změny podle data (pro použití v /changes)

Parametry:

date (povinné) - datum ve formátu yyyy-mm-dd

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

Odpověď:

{ "change_id": 61537 }

Použijte vrácenou hodnotu jako parametr change_id v /changes

GET/changes

Stream změn (přidáno/změněno/odstraněno)

Parametry:

change_id (povinné) - od kterého ID změny

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

Odpověď:

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

Jednotlivý inzerát podle inner_id

Parametry:

inner_id (povinné)

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

Odpověď: objekt data (stejný jako v /offers, ale bez wrapperu result)

Denní exporty

Uchování

Soubory zůstávají dostupné nejméně 3 dny

Dostupnost

Nové soubory každé ráno

Formát CSV

Sloupce CSV jsou odděleny znakem svislítko (|)

Struktura URL:

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

Parametry:

access_name - vaše osobní subdoména
date - datum exportu ve formátu rrrr-mm-dd, např. 2026-09-13
file_name - název souboru s příponou

Dostupné soubory:

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

Příklad požadavku 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

Příklad příkazu 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 je exportní výkladní skříň skupiny Proto Corporation, která provozuje i goo-net.com, japonské domácí tržiště. Dealeři z celého Japonska tu nabízejí vozy zahraničním kupcům, od kei carů a MPV po SUV a sportovní vozy. Web je v angličtině, ceny se zobrazují v jenech a dolarech.

Určujícím rysem je cena FOB: už pokrývá dopravu do japonského přístavu a naložení na loď. Každý záznam obsahuje měsíc první registrace, nájezd, objem motoru, převodovku, pohon, stranu volantu, stav opravy po nehodě a seznam výbavy. Někteří dealeři přidávají video a vozy se zprávou z prohlídky přicházejí s hodnocením interiéru a exteriéru.

Pokud dovážíte auta z Japonska, tato data vám usnadní výběr vozů. Nové inzeráty se k vám dostanou do hodiny od zveřejnění. Aktualizace cen obdržíte prostřednictvím stejného feedu. Můžete porovnat cenu FOB s cenou na japonském domácím trhu, pokud dealer uvedl obě ceny. K dispozici máte také výkon motoru v kW, pokud ho dealer uvádí. Údaje o opravách po nehodě a dostupné zprávy z prohlídky vám pomohou vyřadit problémové vozy ještě před kontaktováním dealera. Záznamy s fotografiemi jsou připravené ke zveřejnění na vašem webu nebo v katalogu.

Goo-net Exchange API běží nepřetržitě. Nové inzeráty, změny cen a odstranění vstupují do feedu automaticky. Vše je dostupné přes REST, vlastní scraper není potřeba.

Další Automobilová Data

Automobilová data z různých světových trhů s našimi platformovými API:

🇦🇪

Dubizzle API

UAE automobilová data API

🇪🇺

AutoScout24 API

Europe automobilová data API

🇩🇪

Mobile.de API

Germany automobilová data API

🇦🇪