Çfarë më jep Goo-net Exchange API?

Qasje të drejtpërdrejtë në shpalljet e tregtarëve japonezë në Goo-net Exchange, pa ndërtuar scraper. Thirrjet standarde REST kthejnë rekorde automjetesh: marka, modeli, varianti, çmimi FOB, kilometrazhi, specifikimet, pajisjet dhe fotot. Një fluks i veçantë ndryshimesh njofton për shpalljet e reja, përditësimet e çmimeve dhe shpalljet e hequra.

Cilat fusha kthen API-ja?

Çmimin FOB në jen me ekuivalentin e tij në USD, si dhe çmimin me të cilin e njëjta makinë është nxjerrë në shitje brenda Japonisë. Datën e regjistrimit të parë, kilometrazhin, vëllimin e motorit, transmisionin, tërheqjen, anën e timonit, llojin e karrocerisë, kodin e modelit dhe një numër shasie të maskuar, statusin e riparimit pas aksidentit, pajisjet dhe fotot. Fuqia, kodi i motorit, videoja dhe raporti i inspektimit gjenden vetëm aty ku i ka dhënë tregtari.

Sa shpejt shfaqen shpalljet e reja?

Shpalljet e reja arrijnë në API brenda një ore nga publikimi në Goo-net Exchange. Përditësimet e çmimeve dhe heqjet nga shitja vijnë përmes të njëjtit fluks.

Cilat formate janë të disponueshme?

REST API me përgjigje JSON. Për ngarkimin masiv ditor ka skedarë CSV, JSON dhe XLSX me të njëjtin set fushash, gati për Excel ose për importim në një bazë të dhënash.

Cilat çmime përfshihen?

Çmimi kryesor është FOB: me dorëzim në një port japonez dhe ngarkim në anije, pa transport detar dhe sigurim. Platforma e tregon në jen dhe e konverton në dollarë me kursin e vet; ne i japim të dyja vlerat. Veçmas merrni çmimin me të cilin e njëjta makinë ofrohet në tregun e brendshëm japonez. Kur tregtari e jep çmimin sipas kërkesës, fusha price është -1, fusha is_price_ask është true dhe fusha price_usd është bosh.

A ka të dhëna për gjendjen dhe riparimet?

Po. Çdo rekord mban statusin e riparimit pas aksidentit sipas platformës dhe shënimet për gjendjen që ka deklaruar tregtari: një pronar, brendësi ku nuk është pirë duhan, evidencë e servisit e disponueshme. Për makinat me raport inspektimi kthehen edhe nota për brendësinë dhe pjesën e jashtme nga 1 deri në 5, një vlerësim për motorin dhe një vlerësim për riparimet.

Kush shet në Goo-net Exchange?

Vetëm tregtarë japonezë, nuk ka shpallje nga shitës privatë. Rekordet përfshijnë statusin Trusted Dealer dhe numrin e stokut të makinës te tregtari. Platforma nuk publikon emrat ose të dhënat e kontaktit të shitësve, prandaj këto fusha vijnë bosh.

Goo-net Exchange APIScraper & Parser

Goo-net Exchange API: shpallje të tregtarëve japonezë me çmime FOB, raporte dhe foto. Shpallje të reja, përditësime çmimesh dhe eksportime ditore. Pa scraper.

Biblioteka zyrtare SDK

Biblioteka klienti me kod të hapur në GitHub: instaloni paketën dhe tërhiqni shpallje nga Goo-net Exchange në aplikacionin tuaj, pa shkruar me dorë kodin e kërkesave.

PHP Node.js Python Go C#Java Ruby Rust

Goo-net Exchange API

Shpallje nga platforma e eksportit e tregtarëve japonezë, me një API të vetme. Merrni rekorde automjetesh me çmime FOB, specifikime, nota të gjendjes dhe foto, si dhe një fluks ndryshimesh që e mban katalogun tuaj të përditësuar. Ndërtuar për gjetje makinash me porosi, analitikë çmimesh dhe faqe interneti agregatore. Pa scraper për të shkruar apo për të mirëmbajtur.

API

Shpalljet e reja në Goo-net Exchange mbërrijnë në fluksin e ndryshimeve brenda një ore nga publikimi.

Eksportime ditore

Një skedar në ditë me çdo shpallje aktive në platformë.

Të dhëna të plota

Çmimet FOB dhe ato të tregut të brendshëm, regjistrimi i parë, kilometrazhi, motori dhe transmisioni, tërheqja dhe ana e timonit, lloji i karrocerisë, kodet e modelit dhe të motorit, statusi i riparimit, pajisjet, fotot, videot dhe notat e gjendjes.

Merrni qasje në APIQasja jepet brenda 2 minutash

API

URL bazë

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

Autorizimi: api_key parametër

Rrjedha e punës

/filtersmerrni vlerat e disponueshme të filtrave

/offersmerrni shpallje (me ose pa filtra) - përdoreni për ngarkimin fillestar të të dhënave

Për përditësime (që t'i mbani të dhënat të përditësuara pas ngarkimit fillestar):

/change_id?date=...merrni ID-në fillestare për fluksin e ndryshimeve

/changes?change_id=...merrni të gjitha ndryshimet në bazën e të dhënave duke filluar nga ID-ja

/offermerrni të dhënat e një shpalljeje të caktuar sipas inner_id

Nga të filloni:

1. Para se të ngarkoni shpalljet, thirrni /change_id për datën e sotme dhe ruani ID-në (nëse kthen 0, provoni sërish më vonë), pastaj merrni çdo faqe të /offers.

2. Thirrni rregullisht /changes duke filluar nga ID-ja e ruajtur dhe më pas dërgoni next_change_id nga çdo përgjigje: kështu merrni rekordet e reja, çmimet e reja dhe makinat e hequra.

3. Për kërkim në faqen tuaj të internetit, bëni kërkesë te /offers me filtrat që ju duhen.

GET/filters

Kthen të gjitha vlerat e mundshme për filtrim

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

Përgjigjja:

{
  "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 e shpalljeve me faqosje dhe filtra

Parametrat:

page (i detyrueshëm) - numri i faqes
mark, model - marka dhe modeli
transmission_type, color, body_type, engine_type, drive_type, rudder - transmisioni, ngjyra, lloji i karrocerisë, karburanti, tërheqja dhe ana e timonit, pa dallim midis shkronjave të mëdha dhe të vogla
year_from, year_to - intervali i vitit të regjistrimit të parë
km_age_from, km_age_to - intervali i kilometrazhit, km
price_from, price_to - intervali i çmimit FOB, jen

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

Përgjigjja:

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

Fushat e rekordit

Identifikuesit dhe lidhjet

id - numri rendor i rekordit në bazën tonë të të dhënave; përdorni inner_id për ta lidhur me platformën
inner_id - identifikuesi me 21 shifra i shpalljes në platformë, që është edhe pjesë e URL-së së shpalljes: 700080001830141121001
url - lidhja e drejtpërdrejtë e shpalljes në goo-net-exchange.com
title - emri i makinës në një rresht, si në kreun e shpalljes: TOYOTA LAND CRUISER 70 ZX
section - seksioni i platformës, gjithmonë used

Marka, modeli, karroceria

mark, model - marka dhe modeli me shkronja të mëdha, si në URL-në e shpalljes: TOYOTA, LAND CRUISER 70
configuration - kodi i modelit sipas fabrikës, në klasifikimin japonez: KG-HZJ76K
complectation - grade, d.m.th. varianti: ZX, 240G, X
year - viti i regjistrimit të parë në Japoni; për makinat nga Japonia ky është viti që shfaqet në shpallje
color - ngjyra e karrocerisë, siç e ka shkruar tregtari: BLACK, GRAY M, PEARL WHITE
body_type - lloji i karrocerisë: SUV, Minivan, Kei car dhe vlera të tjera nga /filters
doors_count - numri i dyerve, mungon te disa makina

Motori, transmisioni, tërheqja

engine_type - karburanti: GASOLINE, DIESEL, HYBRID
displacement - vëllimi i motorit në centimetra kub: 4200
horse_power - fuqia në kuaj-fuqi; string bosh kur platforma nuk ka të dhëna
transmission_type - transmisioni: AT ose MT
drive_type - tërheqja: 2WD ose 4WD
rudder - ana e timonit: Right ose Left

Çmimi, kilometrazhi, gjendja

price - çmimi i eksportit FOB në jen; -1 kur tregtari e jep çmimin sipas kërkesës
km_age - leximi i odometrit në kilometra: 99000
no_accidents - true do të thotë statusi No Repair History: karroceria nuk është riparuar pas një aksidenti
condition - çfarë ka deklaruar tregtari për makinën: një pronar, brendësi ku nuk është pirë duhan, mbahet evidencë e servisit; mund të jetë bosh
owners_count - 1 kur është vendosur shenja One Owner, përndryshe bosh
vin - numri i shasisë, me katër shifrat e fundit të maskuara nga platforma: HZJ76K-000****
equipment - lista e pajisjeve si varg JSON brenda një string-u: kondicioner, tavan i hapshëm, navigacion e të tjera

Shitësi, fotot, datat

is_dealer - gjithmonë true: në platformë shesin vetëm tregtarë
region - prefektura ku ndodhet makina: Fukuoka, Hyogo, Gunma
images - lidhjet e fotove si varg JSON brenda një string-u, shpesh disa dhjetëra foto
offer_created - data kur tregtari e ka përditësuar shpalljen për herë të fundit
city, address, seller_type, seller, salon_id, salon_is_official, full_model, description - platforma nuk i bën të ditura këto të dhëna, fushat vijnë bosh
extra_prep - objekt i ndërfutur me pjesën tjetër të të dhënave, përshkruar më poshtë; gjithçka që platforma nuk e ka vjen si null ose bosh

Brenda extra_prep

Çmimet

is_price_ask - true kur çmimi është sipas kërkesës; atëherë fusha price është -1 dhe fusha price_usd është bosh
price_usd - i njëjti çmim FOB, i konvertuar në dollarë nga platforma: 38155
domestic_price - çmimi me të cilin e njëjta makinë u ofrohet blerësve brenda Japonisë, në jen: 6000000

Të dhënat teknike dhe kodet

year_month - muaji i regjistrimit të parë: 2002-07
power_kw - fuqia në kilovat; null kur nuk është e disponueshme
power_kw_estimated - true kur shifra në kilovat është konvertuar nga kuaj-fuqi
engine_code - kodi i motorit sipas fabrikës: 1HZ, 2AZ-FE
model_code - i njëjti kod modeli si në fushën configuration
chassis_no - i njëjti numër shasie i maskuar si në fushën vin
stock_number - numri i stokut i makinës te tregtari
seating_capacity - numri i vendeve sipas platformës

Gjendja dhe besimi

repaired - statusi i riparimit me fjalët e vetë platformës: No Repair History ose Yes
evaluation - notat e raportit të inspektimit: brendësia dhe pjesa e jashtme nga 1 deri në 5, vlerësimet për motorin dhe riparimet; null kur nuk ka raport
is_certified - true kur shpalljes i është bashkëngjitur një raport inspektimi
is_trusted_dealer - true kur shitësi ka statusin Trusted Dealer të platformës
is_new - true për makinat e sapodala në shitje me shenjën NEW

Videot dhe datat

has_video - true kur tregtari e ka filmuar makinën
videos - lidhjet e drejtpërdrejta te klipet mp4, listë bosh kur nuk ka video
updated - data e përditësimit, siç e ka regjistruar platforma: 2026/07/03

GET/change_id

Merrni ID-në e parë të ndryshimit sipas datës (për përdorim në /changes)

Parametrat:

date (i detyrueshëm) - data në formatin yyyy-mm-dd

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

Përgjigjja:

{ "change_id": 61537 }

Përdorni vlerën e kthyer si parametrin change_id në /changes

GET/changes

Fluksi i ndryshimeve (të shtuara/të ndryshuara/të hequra)

Parametrat:

change_id (i detyrueshëm) - nga cila ID ndryshimi të fillohet

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

Përgjigjja:

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

Një shpallje e vetme sipas inner_id

Parametrat:

inner_id (i detyrueshëm)

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

Përgjigjja: objekti data (i njëjtë si në /offers, por pa mbështjellësin result)

Eksportime ditore

Ruajtja

Skedarët mbeten të disponueshëm të paktën 3 ditë

Disponueshmëria

Skedarë të rinj çdo mëngjes

Formati CSV

Kolonat në CSV ndahen me vijën vertikale (|)

Struktura e URL-së:

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

Parametrat:

access_name - nëndomeni juaj personal
date - data e eksportimit në formatin yyyy-mm-dd, p.sh. 2026-09-13
file_name - emri i skedarit me prapashtesë

Skedarët e disponueshëm:

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

Shembull kërkese me 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

Shembull komande me 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 është vitrina e eksportit e grupit Proto Corporation, i cili administron edhe goo-net.com, platformën japoneze të tregut të brendshëm. Tregtarë nga e gjithë Japonia nxjerrin këtu makina në shitje për blerës jashtë vendit, nga makina kei car dhe minivanë deri te SUV dhe makina sportive. Faqja e internetit është në anglisht, dhe çmimet shfaqen në jen dhe në dollarë.

Veçoria dalluese është çmimi FOB: ai tashmë mbulon dorëzimin në një port japonez dhe ngarkimin në anije. Çdo rekord përfshin muajin e regjistrimit të parë, kilometrazhin, vëllimin e motorit, transmisionin, tërheqjen, anën e timonit, statusin e riparimit pas aksidentit dhe listën e pajisjeve. Disa tregtarë shtojnë video, dhe makinat me raport inspektimi vijnë me nota për brendësinë dhe pjesën e jashtme.

Nëse importoni makina nga Japonia, këto të dhëna ju kursejnë kohë kur zgjidhni automjete. Shpalljet e reja mbërrijnë te ju brenda një ore nga publikimi, dhe përditësimet e çmimeve vijnë përmes të njëjtit fluks. Krahasoni çmimin FOB me çmimin e tregut të brendshëm japonez aty ku tregtari i jep të dyja, dhe kontrolloni fuqinë e motorit në kW aty ku është e disponueshme. Statusi i riparimit dhe raportet e inspektimit ju ndihmojnë t'i përjashtoni makinat problematike që para se ta kontaktoni tregtarin. Rekordet me foto janë gati për t'u publikuar në faqen tuaj të internetit ose në katalogun tuaj.

Goo-net Exchange API punon ditë e natë. Shpalljet e reja, ndryshimet e çmimeve dhe heqjet nga shitja hyjnë në fluks automatikisht. Gjithçka është e disponueshme përmes REST, nuk nevojitet një scraper i juaji.

Të dhëna të tjera automobilistike

Zgjeroni mbulimin e të dhënave tuaja automobilistike në tregjet botërore me API-të tona të platformave:

🇫🇷

Alcopa Auction API

API për makina në Francë

🇯🇵

Carsensor API

API për makina në Japoni

🇦🇪

Dubizzle API

API për makina në EBA

🇪🇺