Какво ми дава Goo-net Exchange API?

Директен достъп до обявите на японски дилъри в Goo-net Exchange, без да разработвате скрейпър. Стандартни REST извиквания връщат записи за автомобили: марка, модел, ниво на оборудване, FOB цена, пробег, технически характеристики, оборудване и снимки. Отделен поток от промени съобщава за нови обяви, обновени цени и премахнати обяви.

Кои полета връща API-то?

FOB цената в йени с равностойността ѝ в USD, както и цената, на която същият автомобил е обявен за продажба в самата Япония. Дата на първа регистрация, пробег, обем на двигателя, скоростна кутия, задвижване, разположение на волана, тип каросерия, код на модела и номер на шасито със скрити цифри, статус на ремонта след произшествие, оборудване и снимки. Мощността, кодът на двигателя, видеото и докладът от проверката са налични само там, където дилърът ги е предоставил.

Колко бързо се появяват новите обяви?

Новите обяви постъпват в API-то до един час след публикуването им в Goo-net Exchange. Обновените цени и премахнатите обяви пристигат чрез същия поток.

Кои формати са налични?

REST API с JSON отговори. За ежедневно масово зареждане има CSV, JSON и XLSX файлове със същия набор от полета, готови за Excel или за импорт в база данни.

Кои цени са включени?

Основната цена е FOB: доставка до японско пристанище и натоварване на борда, без навло и застраховка. Платформата я показва в йени и я преизчислява в долари по собствен курс; доставяме и двете стойности. Отделно получавате цената, на която същият автомобил се предлага на вътрешния пазар на Япония. Когато дилърът дава цената при запитване, полето price е -1, is_price_ask е true, а price_usd е празно.

Има ли данни за състоянието и ремонтите?

Да. Всеки запис съдържа статуса на ремонта след произшествие според платформата и бележките за състоянието, посочени от дилъра: един собственик, в салона не е пушено, има сервизна документация. За автомобилите с доклад от проверката се връщат и оценки за интериора и екстериора от 1 до 5, заключение за двигателя и заключение за ремонта.

Кой продава в Goo-net Exchange?

Само японски дилъри, няма обяви от частни лица. Записите включват статуса Trusted Dealer и складовия номер при дилъра. Платформата не публикува имената на продавачите и данните им за контакт, затова тези полета пристигат празни.

Goo-net Exchange APIScraper & Parser

Goo-net Exchange API: обяви на японски дилъри с FOB цени, доклади и снимки. Нови обяви, обновени цени и ежедневни експорти. Не е нужен скрейпър.

Официални SDK библиотеки

Клиентски библиотеки с отворен код в GitHub: инсталирайте пакета и извличайте обяви от Goo-net Exchange в приложението си, без да пишете на ръка код за заявките.

PHP Node.js Python Go C#Java Ruby Rust

Goo-net Exchange API

Обяви от онлайн пазара на японски дилъри за износ - чрез едно API. Получавате записи за автомобили с FOB цени, технически характеристики, оценки на състоянието и снимки, както и поток от промени, който поддържа каталога ви актуален. Създадено за подбор на автомобили по поръчка, анализи на цените и сайтове агрегатори. Не е нужно да пишете или поддържате скрейпър.

API

Новите обяви в Goo-net Exchange попадат в потока от промени до един час след публикуването.

Ежедневни експорти

Един файл на ден с всички активни обяви в платформата.

Пълни данни

FOB цени и цени за вътрешния пазар, първа регистрация, пробег, двигател и скоростна кутия, задвижване и разположение на волана, тип каросерия, кодове на модела и двигателя, статус на ремонта, оборудване, снимки, видео и оценки на състоянието.

Получете достъп до APIДостъпът се предоставя до 2 минути

API

Базов URL

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

Оторизация: api_key параметър

Ред на работа

/filtersполучаване на наличните стойности на филтрите

/offersполучаване на обяви (с филтри или без) - използвайте за първоначално зареждане на данните

За обновявания (за да поддържате данните актуални след първоначалното зареждане):

/change_id?date=...получаване на началното ID за потока от промени

/changes?change_id=...получаване на всички промени в базата данни, като се започне от ID

/offerполучаване на данни за конкретна обява по inner_id

Откъде да започнете:

1. Преди да заредите обявите, извикайте /change_id за днешната дата и запазете полученото ID (ако върне 0, повторете заявката по-късно), а след това изтеглете всички страници от /offers.

2. Извиквайте /changes периодично, като започнете от запазеното ID, а след това подавайте next_change_id от всеки отговор: така получавате нови записи, нови цени и свалени от продажба автомобили.

3. За търсене в собствения си сайт извиквайте /offers с нужните ви филтри.

GET/filters

Връща всички възможни стойности за филтриране

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

Отговор:

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

Списък с обяви със страниране и филтри

Параметри:

page (задължително) - номер на страницата
mark, model - марка и модел
transmission_type, color, body_type, engine_type, drive_type, rudder - скоростна кутия, цвят, тип каросерия, гориво, задвижване и разположение на волана, без разлика между главни и малки букви
year_from, year_to - диапазон от години на първа регистрация
km_age_from, km_age_to - диапазон на пробега, км
price_from, price_to - диапазон на FOB цената, йени

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

Отговор:

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

Полета на записа

Идентификатори и връзки

id - пореден номер на записа в нашата база данни; използвайте полето inner_id, за да съпоставите записа с платформата
inner_id - 21-цифрен идентификатор на обявата в платформата, който е и част от URL адреса на обявата: 700080001830141121001
url - директна връзка към обявата в goo-net-exchange.com
title - име на автомобила на един ред, както е в заглавието на обявата: TOYOTA LAND CRUISER 70 ZX
section - раздел на платформата, винаги used

Марка, модел, каросерия

mark, model - марка и модел с главни букви, както са в URL адреса на обявата: TOYOTA, LAND CRUISER 70
configuration - фабричен код на модела по японската класификация: KG-HZJ76K
complectation - grade, т.е. ниво на оборудване: ZX, 240G, X
year - година на първа регистрация в Япония; при автомобилите от Япония това е годината, показана в обявата
color - цвят на каросерията, както го е написал дилърът: BLACK, GRAY M, PEARL WHITE
body_type - тип каросерия: SUV, Minivan, Kei car и други стойности от /filters
doors_count - брой врати, при някои автомобили липсва

Двигател, скоростна кутия, задвижване

engine_type - гориво: GASOLINE, DIESEL, HYBRID
displacement - обем на двигателя в кубически сантиметри: 4200
horse_power - мощност в конски сили; празен низ, когато платформата няма данни
transmission_type - скоростна кутия: AT или MT
drive_type - задвижване: 2WD или 4WD
rudder - разположение на волана: Right или Left

Цена, пробег, състояние

price - FOB цена за износ в йени; -1, когато дилърът дава цената при запитване
km_age - показание на одометъра в километри: 99000
no_accidents - true означава статус No Repair History: каросерията не е ремонтирана след произшествие
condition - това, което дилърът е посочил за автомобила: един собственик, в салона не е пушено, води се сервизна документация; може да е празно
owners_count - 1, когато е поставен етикетът One Owner, иначе празно
vin - номер на шасито, в който последните четири цифри са скрити от платформата: HZJ76K-000****
equipment - списък с оборудване като JSON масив в низ: климатик, шибидах, навигация и други

Продавач, снимки, дати

is_dealer - винаги true: в платформата продават само дилъри
region - префектура, в която се намира автомобилът: Fukuoka, Hyogo, Gunma
images - връзки към снимките като JSON масив в низ, често няколко десетки снимки
offer_created - дата, на която дилърът последно е обновил обявата
city, address, seller_type, seller, salon_id, salon_is_official, full_model, description - платформата не разкрива тези полета, те пристигат празни
extra_prep - вложен обект с останалите данни, описан по-долу; това, което липсва в платформата, пристига като null или празно

В обекта extra_prep

Цени

is_price_ask - true, когато цената е при запитване; тогава полето price е -1, а price_usd е празно
price_usd - същата FOB цена, преизчислена в долари от платформата: 38155
domestic_price - цената, на която същият автомобил се предлага на купувачи в самата Япония, в йени: 6000000

Технически данни и кодове

year_month - месец на първа регистрация: 2002-07
power_kw - мощност в киловати; null, когато не е налична
power_kw_estimated - true, когато стойността в киловати е преизчислена от конски сили
engine_code - фабричен код на двигателя: 1HZ, 2AZ-FE
model_code - същият код на модела като в полето configuration
chassis_no - същият номер на шасито със скрити цифри като в полето vin
stock_number - складов номер на автомобила при дилъра
seating_capacity - брой места според платформата

Състояние и доверие

repaired - статус на ремонта с думите на платформата: No Repair History или Yes
evaluation - оценки в доклада от проверката: интериор и екстериор от 1 до 5, заключения за двигателя и ремонта; null, когато няма доклад
is_certified - true, когато към обявата е приложен доклад от проверката
is_trusted_dealer - true, когато продавачът има статуса Trusted Dealer на платформата
is_new - true за новопостъпили автомобили с етикет NEW

Видео и дати

has_video - true, когато дилърът е заснел автомобила на видео
videos - директни връзки към mp4 клипове, а когато няма видео, празен списък
updated - дата на обновяване, както е записана от платформата: 2026/07/03

GET/change_id

Получаване на първото ID на промяна по дата (за използване в /changes)

Параметри:

date (задължително) - дата във формат yyyy-mm-dd

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

Отговор:

{ "change_id": 61537 }

Използвайте върнатата стойност като параметър change_id в /changes

GET/changes

Поток от промени (добавени/променени/премахнати)

Параметри:

change_id (задължително) - от кое ID на промяна да се започне

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

Отговор:

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

Една обява по inner_id

Параметри:

inner_id (задължително)

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

Отговор: обект data (същият като в /offers, но без обвивката result)

Ежедневни експорти

Съхранение

Файловете остават достъпни поне 3 дни

Достъпност

Нови файлове всяка сутрин

CSV формат

Колоните в CSV са разделени с вертикална черта (|)

Структура на URL адреса:

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

Параметри:

access_name - вашият личен поддомейн
date - дата на експорта във формат yyyy-mm-dd, напр. 2026-09-13
file_name - име на файла с разширението

Налични файлове:

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

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

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 е витрината на групата Proto Corporation за износ. Групата управлява и goo-net.com, японската платформа за вътрешния пазар. Дилъри от цяла Япония обявяват тук автомобили за продажба на купувачи от чужбина - от кей карове и миниванове до SUV и спортни автомобили. Сайтът е на английски, а цените са показани в йени и долари.

Отличителната черта е FOB цената: тя вече включва доставката до японско пристанище и натоварването на борда. Всеки запис съдържа месеца на първа регистрация, пробега, обема на двигателя, скоростната кутия, задвижването, разположението на волана, статуса на ремонта след произшествие и списъка с оборудване. Някои дилъри добавят видео, а автомобилите с доклад от проверката идват с оценки за интериора и екстериора.

Ако внасяте автомобили от Япония, тези данни ви спестяват време при избора на автомобили. Новите обяви пристигат при вас до един час след публикуването, а обновените цени идват чрез същия поток. Сравнявайте FOB цената с цената за вътрешния пазар на Япония там, където дилърът е посочил и двете, и проверявайте мощността на двигателя в kW, където е налична. Статусът на ремонта и докладите от проверката помагат да отсеете проблемните автомобили още преди да се свържете с дилъра. Записите със снимки са готови за публикуване на сайта ви или в каталога ви.

Goo-net Exchange API работи денонощно. Новите обяви, промените в цените и премахнатите обяви постъпват в потока автоматично. Всичко е достъпно чрез REST, без нужда от собствен скрейпър.

Други автомобилни данни

Разширете покритието на автомобилните си данни по световните пазари с нашите API за отделните платформи:

🇫🇷

Alcopa Auction API

API за автомобили от Франция

🇯🇵

Carsensor API

API за автомобили от Япония

🇦🇪

Dubizzle API

API за автомобили от ОАЕ

🇪🇺