
Carsensor APIScraper & Parser
Carsensor API: çmime tregtarësh japonezë me e pa shpenzime regjistrimi, kilometrazh, inspektim, specifikime, foto. Ndryshimet për makinë, gjithë stoku çdo ditë.
Carsensor API
Parser-i dhe scraper-i për Carsensor punojnë në anën tonë, dhe ju merrni përmes API-së shpallje të tregtarëve japonezë gati për përdorim. Çdo rekord përmban çmimin e automjetit dhe çmimin total të tregtarit, kilometrazhin, specifikimet, të dhënat e inspektimit dhe fotot, ndërsa fluksi i ndryshimeve ju njofton për shpalljet e reja, ndryshimet e çmimeve dhe makinat e hequra nga shitja.
Fluksi i ndryshimeve njofton për çdo shpallje të re në Carsensor, ndryshim çmimi dhe heqje nga shitja.
Një skedar në ditë me të gjithë stokun aktual të Carsensor.
Çmimi i automjetit dhe çmimi total i tregtarit, viti i regjistrimit, kilometrazhi, kodet e modelit dhe të motorit, fuqia, transmisioni, tërheqja dhe ana e timonit, shënimet për gjendjen dhe riparimet, fleta e inspektimit, pajisjet, tregtari dhe fotot.
URL bazë
https://{access_name}.auto-api.com/api/v2/carsensorAutorizimi: 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ënavePë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_idNga të filloni:
1. Para ngarkimit të parë, thirrni /change_id me datën e sotme dhe ruani ID-në e kthyer; nëse kthen 0, provoni sërish pak më vonë. Pastaj merrni /offers faqe pas faqeje, deri në faqen e fundit.
2. Më pas, lexoni /changes duke filluar nga ajo ID dhe dërgoni next_change_id nga çdo përgjigje: kështu merrni makinat e sapodala në shitje, çmimet e reja dhe shpalljet e hequra. Nëse next_change_id kthehet null, ende nuk ka ngjarje të reja: përsëriteni kërkesën më vonë me të njëjtën ID.
3. Për të kërkuar sipas kritereve tuaja, thirrni /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/carsensor/filters?api_key=YOUR_API_KEYPërgjigjja:
{
"mark": {
"Toyota": {
"model": ["Alphard", "Aqua", "Crown", "Harrier", "Hiace Van", "Land Cruiser Prado", "Noah", "Prius", "Sienta", "Voxy"]
},
"Honda": {
"model": ["Fit", "Freed", "N-BOX", "Vezel"]
}
},
"transmission_type": ["Automatic", "CVT", "Manual", "Other"],
"color": ["Black", "Blue", "Brown", "Gold", "Gray", "Green", "Navy", "Orange", "Other", "Pearl", "Pink", "Purple", "Red", "Silver", "White", "Yellow"],
"body_type": ["Bus", "Camper", "Convertible", "Coupe", "Hatchback", "Minivan", "Other", "Pickup truck", "SUV", "Sedan", "Station wagon", "Truck"],
"engine_type": ["Diesel", "Electric", "Gasoline", "Hybrid", "Plug-in hybrid"],
"drive_type": ["2WD", "4WD"],
"rudder": ["Left", "Right", "Unknown"]
}GET/offers
Lista e shpalljeve me faqosje dhe filtra
Parametrat:
page(i detyrueshëm) - numri i faqesmark, model- marka dhe modeli, siç shkruhen në /filterstransmission_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ë voglayear_from, year_to- intervali i vitit të regjistrimit të parëkm_age_from, km_age_to- intervali i kilometrazhit, kmprice_from, price_to- intervali i çmimit të automjetit, jen
https://{access_name}.auto-api.com/api/v2/carsensor/offers?api_key=YOUR_API_KEY&page=1https://{access_name}.auto-api.com/api/v2/carsensor/offers?api_key=YOUR_API_KEY&page=1&mark=Honda&model=Freed&year_from=2020&km_age_to=50000&engine_type=GasolinePërgjigjja:
{
"result": [
{
"id": 3,
"inner_id": "AU7363661281",
"change_type": "added",
"created_at": "2026-09-29T01:24:02.000+03:00",
"data": {
"id": "3",
"inner_id": "AU7363661281",
"url": "https://www.carsensor.net/usedcar/detail/AU7363661281/index.html",
"mark": "Honda",
"model": "Freed",
"generation": "2025.07 -",
"configuration": "5BA-GT1",
"complectation": "1.5 エアー EX",
"year": "2025",
"price": "3090000",
"km_age": "9000",
"color": "Navy",
"engine_type": "Gasoline",
"body_type": "Minivan",
"transmission_type": "CVT",
"drive_type": "2WD",
"rudder": "Right",
"displacement": "1500",
"doors_count": "5",
"horse_power": "118",
"condition": "Non-smoking car",
"no_accidents": true,
"owners_count": "",
"equipment": "[\"Power steering\", \"ABS\", \"Automatic emergency braking\", \"Adaptive cruise control\", \"Lane keeping assist\", \"Camera: rear\", \"Electronic stability control\"]",
"region": "Saitama",
"city": "幸手市",
"address": "埼玉県幸手市北2-6-16",
"seller": "ネクステージ 幸手店",
"seller_url": "https://www.carsensor.net/shop/saitama/206339416/",
"salon_id": "206339416",
"section": "used",
"title": "フリード 1.5 エアー EX 両側電動スライドドア 純正11.4型ナビ バックカメラ 衝突軽減",
"offer_created": "2026-09-28",
"images": "[\"https://ccsrpcma.carsensor.net/CSphoto/bkkn/308/423/UZ0054308423/UZ0054308423_001.JPG?ver=detail001&impolicy=car_002\", \"https://ccsrpcml.carsensor.net/CSphoto/ml/308/423/UZ0054308423/UZ0054308423_1_001.jpg?ver=detail001&impolicy=car_002\"]",
"extra_prep": {
"total_price": 3212000,
"plan_prices": { "A": 3228000, "B": 3229000 },
"is_price_ask": false,
"monthly_loan": 25600,
"monthly_loan_type": "regular",
"is_mileage_unknown": false,
"is_mileage_tampered": false,
"is_meter_replaced": false,
"year_raw": "2025(R07)",
"chassis_no_tail": "064",
"seats": 6,
"power_kw": 86.79,
"power_kw_estimated": true,
"engine_code": "L15D",
"displacement_exact": 1496,
"catalog_path": "honda/freed/F003/M003G013",
"maker_code": "HO",
"model_code_site": "S083",
"is_new": true,
"is_maker_certified": false
// ... other extra_prep fields, including the ais inspection sheet
}
}
}
],
"meta": { "page": 1, "next_page": 2, "limit": 20 }
}Fushat e rekordit
- id - numri i rekordit në bazën tonë të të dhënave; përdorni inner_id për ta lidhur me shpalljen në platformë
- inner_id - identifikuesi i shpalljes në Carsensor, që është edhe pjesë e URL-së së shpalljes: AU7363661281
- url - lidhja e shpalljes në carsensor.net
- title - titulli i shpalljes, siç e ka shkruar tregtari
- section - seksioni: used për makinat e përdorura, new për të rejat
- mark, model - marka dhe modeli, p.sh. Honda dhe Freed
- generation - periudha e prodhimit të këtij versioni të modelit në formatin 2017.04 - 2018.03; pa datë përfundimi nëse modeli prodhohet ende
- configuration - kodi i modelit nga dokumentet japoneze të regjistrimit, p.sh. 5BA-GT1
- complectation - varianti, siç e ka shënuar tregtari
- year - viti kur makina është regjistruar për herë të parë; për importet paralele, platforma jep vitin e prodhimit
- color - ngjyra e karrocerisë, vlera nga /filters
- body_type - lloji i karrocerisë, vlera nga /filters
- doors_count - numri i dyerve
- engine_type - lloji i karburantit, vlera nga /filters
- displacement - vëllimi i motorit në cc
- horse_power - fuqia sipas fabrikës në hp; te makinat hibride llogaritet vetëm motori me djegie të brendshme, te makinat elektrike është ajo e motorit elektrik; bosh kur nuk ka të dhëna
- transmission_type - lloji i transmisionit: automatik, manual, CVT ose tjetër
- drive_type - 4WD ose 2WD; për 2WD, fusha drive_catalog tregon cilat rrota janë tërheqëse
- rudder - ana e timonit
- price - çmimi i makinës në jen, me taksën japoneze të konsumit të përfshirë, shpenzimet e regjistrimit veçmas; -1 kur çmimi është sipas kërkesës
- km_age - kilometrazhi në km, siç e rrumbullakos platforma, zakonisht në 1 000 km; bosh kur kilometrazhi është i panjohur ose i kthyer mbrapsht
- no_accidents - true do të thotë se pjesët strukturore të karrocerisë nuk janë riparuar as ndërruar; false do të thotë se punime të tilla janë bërë
- condition - shënimet e tregtarit si listë e ndarë me presje, p.sh. një pronar, makinë ku nuk është pirë duhan, evidencë e mirëmbajtjes
- owners_count - 1 kur tregtari shënon një pronar të vetëm, përndryshe bosh
- equipment - lista e pajisjeve si varg JSON brenda një string-u
- seller - emri i tregtarit
- seller_url - lidhja e profilit të tregtarit në carsensor.net
- salon_id - ID-ja e tregtarit në Carsensor
- region - prefektura ku ndodhet makina
- city - qyteti ose rrethi
- address - adresa e tregtarit
- images - lidhjet e fotove si varg JSON brenda një string-u; shumë makina kanë disa dhjetëra foto
- offer_created - data kur u shfaq shpallja, sipas shenjës NEW; bosh nëse data nuk dihet
- extra_prep - objekt i ndërfutur me të dhëna shtesë, përshkruar më poshtë; vlerat që mungojnë vijnë si null
Brenda extra_prep
- total_price - shuma totale për t'u paguar në jen: makina plus shpenzimet e detyrueshme të regjistrimit kur blini nga ky tregtar dhe e regjistroni makinën në zonën e tregtarit
- plan_prices - shuma totale për t'u paguar për paketat A dhe B të tregtarit, p.sh. me garanci të zgjatur; nuk i ka çdo makinë
- is_price_ask - true kur tregtari nuk ka shënuar çmim dhe fusha price është -1
- monthly_loan - kësti mujor i kredisë së tregtarit për makinën, në jen
- monthly_loan_type - lloji i kredisë: regular për kredi standarde, residual për kredi me një pagesë të madhe në fund
- mileage_raw - kilometrazhi pikërisht siç është shkruar në shpallje, përfshirë shënimet, nëse ka
- is_mileage_unknown - true kur kilometrazhi real nuk dihet
- is_mileage_tampered - true kur është konfirmuar kthimi mbrapsht i kilometrazhit
- is_meter_replaced - true kur odometri është ndërruar
- year_raw - viti nga shpallja me shënimin e erës japoneze: 2025(R07)
- shaken - skadimi i kontrollit teknik japonez (viti dhe muaji), ose një shënim që tregon nëse tregtari do ta bëjë si pjesë të shitjes
- warranty - nëse ka garanci
- maintenance - servisi i parashikuar me ligj para shitjes: i përfshirë në çmim, bëhet me tarifë shtesë ose nuk bëhet
- recycle_fee - statusi i tarifës japoneze të riciklimit: nëse është paguar dhe nëse është përfshirë në çmim
- transmission_raw - emërtimi origjinal i transmisionit: vendndodhja e levës së shpejtësive, numri i shpejtësive dhe nëse ka regjim manual
- color_name - ngjyra me fjalët e vetë tregtarit
- color_factory - emri i ngjyrës sipas fabrikës
- chassis_no_tail - tri shifrat e fundit të numrit të shasisë; Carsensor nuk e publikon numrin e plotë
- seats - numri i vendeve
- fuel - karburanti i rekomanduar nga prodhuesi: benzinë e zakonshme, benzinë premium ose dizel
- drive_catalog - tërheqja sipas specifikimeve të fabrikës, p.sh. FF (rrotat e përparme), FR (rrotat e pasme) ose 4WD (të katra)
- power_kw - fuqia nga fusha horse_power, e konvertuar në kW
- power_kw_estimated - true kur shifra në kW është konvertuar nga hp
- engine_kind - ndërtimi i motorit: numri dhe vendosja e cilindrave, lloji i mekanizmit të valvulave; te makinat elektrike, motori elektrik
- engine_code - kodi i motorit: L15D
- displacement_exact - vëllimi i motorit sipas fabrikës, i saktë deri në centimetër kub: 1496
- grade_name - emri i plotë i variantit sipas të dhënave të fabrikës
- catalog_path - identifikuesi i variantit në carsensor.net: makinat e të njëjtit variant e kanë të njëjtë
- maker_code - kodi i brendshëm i markës në Carsensor
- model_code_site - kodi i brendshëm i modelit në Carsensor
- is_new - true kur ka shenjën NEW: shpallja është shfaqur ose është ripublikuar brenda javës së fundit
- labels - etiketat në shpallje, p.sh. garanci nga tregtari, pamje 360°, konsultim online, raport vlerësimi
- is_maker_certified - true për makinat e certifikuara nga prodhuesi
- evaluation - rezultati i inspektimit: kush e ka inspektuar makinën, nota e përgjithshme dhe data; nota R u vihet makinave të cilave u janë riparuar pjesët strukturore të karrocerisë
- ais - fleta e hollësishme e inspektimit nga Carsensor: nota e përgjithshme, notat me shkronja për brendësinë dhe pjesën e jashtme, kodi i modelit, leximi i odometrit në ditën e inspektimit, nëse makina ka pasur rilyerje të plotë ose ndërrim odometri, lista e defekteve dhe një lidhje te një imazh me dëmtimet e shënuara
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/carsensor/change_id?api_key=YOUR_API_KEY&date=2026-09-29Përgjigjja:
{ "change_id": 1254 }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/carsensor/changes?api_key=YOUR_API_KEY&change_id=1254Përgjigjja:
{
"result": [
{
"id": 1254,
"inner_id": "AU7305608350",
"change_type": "added", // added - new listing
"created_at": "2026-09-29T19:12:40.512+03:00",
"data": { ... } // full listing data
},
{
"id": 1255,
"inner_id": "AU7363661281",
"change_type": "changed", // changed - new car price, JPY
"created_at": "2026-09-29T20:05:17.208+03:00",
"data": { "new_price": 2990000 }
},
{
"id": 1256,
"inner_id": "AU6927774389",
"change_type": "removed", // removed - listing deleted
"created_at": "2026-09-29T21:48:02.331+03:00",
"data": {}
}
],
"meta": { "cur_change_id": 1254, "next_change_id": 1257, "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/carsensor/offer?api_key=YOUR_API_KEY&inner_id=AU7363661281Përgjigjja: objekti data (i njëjtë si në /offers, por pa mbështjellësin result)
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ë:
Parametrat:
access_name- nëndomeni juaj personaldate- data e eksportimit në formatin yyyy-mm-dd, p.sh. 2026-09-29file_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.csvShembull komande me Wget
wget --method GET \
--header 'Authorization: Basic XXX==' \
'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'Carsensor (carsensor.net) i përket kompanisë japoneze Recruit dhe është një nga faqet më të mëdha të internetit për makina të përdorura në vend. Shpalljet i publikojnë vetëm tregtarët, nga pika të vogla shitjeje deri te autosallone të autorizuara, dhe aty mund të gjeni pothuajse gjithçka, përfshirë makina kei car, kamionë dhe kamperë.
Çmimet në Carsensor janë në jen dhe vijnë si dy shifra: çmimi i automjetit dhe çmimi total i tregtarit, përfshirë shpenzimet e regjistrimit. Shpallja tregon nëse pjesët strukturore të karrocerisë janë riparuar ose ndërruar, nëse ka garanci dhe muajin kur skadon kontrolli teknik (shaken). Disa makina kontrollohen nga një inspektor i Carsensor, dhe atëherë shpallja përfshin një fletë inspektimi me nota dhe defekte.
Për një importues, Carsensor është një mënyrë e shpejtë për të gjetur variantin e duhur te tregtarët në mbarë Japoninë pa humbur shpalljet e reja. Të njëjtat të dhëna tregojnë sa kushton një model në tregun japonez dhe si ndryshon çmimi i tij, ndërsa me kodin e modelit dhe specifikimet e motorit është e lehtë të përllogaritni paraprakisht detyrimet doganore dhe tarifat e importit.
Shpalljet e reja, ndryshimet e çmimeve dhe heqjet nga shitja vijnë përmes /changes. Për këtë nuk ju duhet një parser i juaji.
Zgjeroni mbulimin e të dhënave tuaja automobilistike në tregjet botërore me API-të tona të platformave: