Çfarë është Che168 API dhe si funksionon?

Lidhuni me platformën më të madhe të makinave në Kinë përmes API-së sonë. Merrni të dhëna makinash gati për përdorim përmes thirrjeve REST. Ndiqni shpalljet e reja, ndryshimet e çmimeve dhe automjetet e hequra nga shitja.

Çfarë të dhënash nxjerr parser-i nga Che168?

Të gjitha të dhënat e automjetit: marka, modeli, viti, çmimi, kilometrazhi, motori, transmisioni, numri VIN, raportet e inspektimit, historiku i servisit, të dhënat e shitësit, fotot dhe gjendja e automjetit.

Sa shpesh përditësohen të dhënat e Che168?

Sinkronizim i të dhënave në kohë reale. Shpalljet e reja të makinave zbulohen brenda pak minutash. Skedarë ditorë me të gjitha automjetet aktive dhe të hequra nga shitja.

Çfarë formatesh mbështet Che168 API?

Disa formate: REST API për të dhëna në kohë reale, JSON për të dhëna të formatuara, CSV për analizë dhe Excel për raporte. Të gjitha formatet japin të dhënat e plota të makinës.

A mund të marr numrat VIN përmes API-së?

Po, kodet VIN janë të disponueshme për shumicën e shpalljeve në Che168. Përfshihen në rekordin e hollësishëm të automjetit përmes endpoint-it /offer.

Sa shpesh përditësohen eksportimet ditore?

Skedarët e rinj krijohen çdo mëngjes. Përmbajnë një pamje të plotë të shpalljeve aktive dhe një listë të automjeteve të hequra nga shitja ditën e mëparshme.

Cilat rajone të Kinës mbulohen?

Che168 mbulon të gjitha provincat e Kinës. Të dhënat përfshijnë vendndodhjen e shitësit dhe mund të filtrohen sipas qyteteve dhe rajoneve.

Che168 APIScraper & Parser

Qasje në të dhëna automjetesh nga platforma kineze e makinave. VIN, raporte inspektimi, historik servisi. Monitorim në kohë reale i përditësimeve të shpalljeve.

Biblioteka zyrtare SDK

Çdo bibliotekë vjen me përgjigje të tipizuara dhe trajtim të integruar të gabimeve. Mjafton ta instaloni dhe t'i jepni çelësin tuaj API për Che168.

PHP Node.js Python Go C#Java Ruby Rust

Che168 API

Merrni të dhëna makinash nga Kina drejtpërdrejt përmes API-së. Qasje e drejtpërdrejtë në të dhëna automjetesh pa ndërtuar scraper. Përshtatet shumë mirë për studim tregu, analizë çmimesh dhe inteligjencë biznesi.

API

Merrni njoftime kur në Che168 shfaqen makina të sapodala në shitje. Ndiqni shpalljet që në çastin kur publikohen.

Eksportime ditore

Skedarë ditorë me të gjitha shpalljet aktuale dhe të dhënat për çmimet.

Të dhëna të plota

Merrni të dhëna të formatuara përmes API-së: çmimi, kilometrazhi, viti, marka, modeli, specifikimet teknike, raportet e inspektimit, historiku i servisit dhe gjendja e automjetit.

Merrni qasje në APIQasja jepet brenda 2 minutash

API

URL bazë

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

Autorizimi: api_key parametër

Rrjedha e punës

/filtersbëni kërkesë për të gjitha vlerat e disponueshme të filtrave

/offersmerrni shpallje makinash me faqosje dhe filtrim - rekomandohet për importimin masiv të të dhënave

Për t'i mbajtur të dhënat tuaja të përditësuara pas importimit fillestar:

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

/changes?change_id=...merrni të gjitha përditësimet që nga një ID ndryshimi e caktuar

/offertërhiqni të dhënat e plota të një shpalljeje të vetme duke përdorur inner_id

Rrjedha e sugjeruar e punës për integrimin:

1. Filloni me /offers për të shkarkuar setin e plotë të të dhënave (kaloni nëpër të gjitha faqet)

2. Më pas thirrni /changes në intervale të rregullta për të kapur të gjitha përditësimet (shtime/ndryshime/heqje) dhe për të sinkronizuar bazën tuaj të të dhënave

3. Për të shfaqur të dhëna në faqen tuaj të internetit, përdorni /offers me filtra dhe parametra faqosjeje (marka, modeli, çmimi, viti e të tjera)

GET/filters

Jep të gjitha fushat e filtrueshme dhe vlerat e tyre të lejuara

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

Përgjigjja:

{
  "mark": {
    "BMW": { "model": ["X5", "X3", "3 Series"] },
    "Audi": { "model": ["A4", "A6", "Q7"] }
  },
  "transmission_type": ["Manual", "Automatic"],
  "color": ["White", "Black", "Silver", "Dark Gray", "Blue", "Red", "Brown", "Orange", "Yellow", "Green", "Purple", "Champagne", "Other"],
  "body_type": ["Crossover/SUV", "Sedan", "Hatchback", "Minivan", "Pickup", "Coupe/Roadster", "Microvan", "Light Truck", "Van", "Mini"],
  "engine_type": ["Gasoline", "Diesel", "Electric", "Hybrid", "Plug-in Hybrid", "Range Extender", "Hydrogen Fuel Cell", "Gasoline + 48V Mild Hybrid", "Gasoline + 24V Mild Hybrid", "Gasoline + CNG", "CNG"],
  "drive_type": ["FWD", "RWD", "AWD", "RWD (dual-motor)", "AWD (dual-motor)", "AWD (tri-motor)", "AWD (quad-motor)"]
}

GET/offers

Lista e faqosur e shpalljeve të automjeteve me mbështetje për filtra

Parametrat:

page (i detyrueshëm) - numri i faqes
mark, model, transmission_type, color, body_type, engine_type - filtra (pa dallim midis shkronjave të mëdha dhe të vogla)
year_from, year_to - filtër sipas intervalit të viteve
km_age_from, km_age_to - filtër sipas intervalit të kilometrazhit
price_from, price_to - filtër sipas intervalit të çmimit (në CNY)

https://{access_name}.auto-api.com/api/v2/che168/offers?api_key=YOUR_API_KEY&page=1https://{access_name}.auto-api.com/api/v2/che168/offers?api_key=YOUR_API_KEY&page=1&mark=BMW&color=black

Përgjigjja:

{
  "result": [
    {
      "id": 1273379,
      "inner_id": "55651236",
      "change_type": "added",
      "created_at": "2025-08-05T08:18:10.679Z",
      "data": {
        "id": 1273379,
        "inner_id": "55651236",
        "url": "https://www.che168.com/dealer/648815/55651236.html",
        "mark": "Lamborghini",
        "model": "Huracán",
        "title": "Huracán 2020 Huracán EVO RWD",
        "year": 2020,
        "color": "Red",
        "price": 1890000,
        "km_age": 19000,
        "engine_type": "Gasoline",
        "transmission_type": "Automatic",
        "body_type": "Sports Car",
        "drive_type": "RWD (mid-engine)",
        "address": "Shanghai, Minhang",
        "seller_type": "dealer",
        "is_dealer": true,
        "section": "Used",
        "salon_id": "648815",
        "description": "Shanghai Luxury Car Store: 166 detailed inspections...",
        "displacement": 5.2,
        "offer_created": "2025-08-05",
        "images": ["https://2sc2.autoimg.cn/escimg/auto/g34/M04/C4/EC/..."],
        "extra": {"inspection": {...}, "configuration": {...}},
        "power": 610
      }
    }
  ],
  "meta": { "page": 1, "next_page": 2, "limit": 20 }
}

Fushat e të dhënave:

id - ID-ja e brendshme në bazën e të dhënave
inner_id - ID-ja e shpalljes në platformë
url - lidhja e shpalljes
mark - marka e makinës
model - modeli i makinës
year - viti i prodhimit
color - ngjyra
price - çmimi në CNY
km_age - kilometrazhi në km
engine_type - lloji i motorit
drive_type - lloji i tërheqjes

transmission_type - lloji i transmisionit
body_type - lloji i karrocerisë
address - adresa
seller_type - lloji i shitësit
is_dealer - tregues nëse shitësi është tregtar (true/false)
section - seksioni
salon_id - ID-ja e tregtarit
displacement - vëllimi i motorit
images - varg me URL imazhesh
power - fuqia në hp

GET/change_id

Merrni ID-në fillestare të ndryshimit për një datë të dhënë (e nevojshme për endpoint-in /changes)

Parametrat:

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

https://{access_name}.auto-api.com/api/v2/che168/change_id?api_key=YOUR_API_KEY&date=2025-01-15

Përgjigjja:

{ "change_id": 3294715 }

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

GET/changes

Fluksi i përditësimeve inkrementale (rekorde 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/che168/changes?api_key=YOUR_API_KEY&change_id=1

Përgjigjja:

{
  "result": [
    {
      "id": 456,
      "inner_id": "55651236",
      "change_type": "added",    // added - new listing
      "created_at": "2025-01-15T10:30:00Z",
      "data": { ... }            // full listing data
    },
    {
      "id": 457,
      "inner_id": "55651237",
      "change_type": "changed",  // changed - price update
      "created_at": "2025-01-15T10:31:00Z",
      "data": { "new_price": 1790000 }
    },
    {
      "id": 458,
      "inner_id": "55651238",
      "change_type": "removed",  // removed - listing deleted
      "created_at": "2025-01-15T10:32:00Z"
    }
  ],
  "meta": { "cur_change_id": 1, "next_change_id": 21, "limit": 20 }
}

GET/offer

Të dhëna të hollësishme për një shpallje të caktuar sipas inner_id

Parametrat:

inner_id (i detyrueshëm)

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

Përgjigjja: një objekt i vetëm data (të njëjtat fusha si elementet e /offers, kthehet drejtpërdrejt pa mbështjellësin result)

Merrni shpalljen sipas URL-së

Tërhiqni të dhënat e plota të shpalljes duke dërguar URL-në nga che168.com

URL bazë

https://{access_name}.auto-api.com/api/v1/offer/info

Autorizimi: header x-api-key

POST/api/v1/offer/info

Merrni të dhënat e shpalljes nga che168.com sipas URL-së

Parametrat:

url (i detyrueshëm) - link to the listing on che168.com

Shembull kërkese:

curl -L 'https://{access_name}.auto-api.com/api/v1/offer/info' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ "url": "https://www.che168.com/dealer/413863/56520004.html" }'

Përgjigjja:

{
  "inner_id": "56520004",
  "url": "https://www.che168.com/dealer/413863/56520004.html",
  "mark": "Ora",
  "model": "Black Cat",
  "year": 2020,
  "color": "White",
  "price": 31800,
  "km_age": 54000,
  "engine_type": "Electric",
  "transmission_type": "Automatic",
  "body_type": "Mini",
  "drive_type": "FWD",
  "displacement": "0",
  "vin": "LGWECMA47LE008164",
  "city": "Shenzhen",
  "seller_type": "dealer",
  "is_dealer": true,
  "offer_created": "2025-12-04",
  "images": [
    "https://2sc2.autoimg.cn/escimg/auto/g33/M0B/AE/D7/1024x768_c42_autohomecar__ChxpVWj8TteALlI3AAnIctts-w8397.jpg.webp",
    "https://2sc2.autoimg.cn/escimg/auto/g34/M0B/A3/C5/1024x768_c42_autohomecar__ChxpWGj8TtiAJ0EJAAq9t0PZjQc486.jpg.webp"
  ],
  "power": 61,
  "first_registration": "2020-09"
}

Përshkrimi i fushave:

inner_id - ID-ja e shpalljes në che168.com
url - lidhja e shpalljes
mark - marka e makinës
model - modeli i makinës
year - viti i prodhimit
color - ngjyra e automjetit
price - çmimi në CNY
km_age - kilometrazhi në km

engine_type - lloji i motorit/karburantit
transmission_type - lloji i transmisionit
body_type - lloji i karrocerisë
drive_type - lloji i tërheqjes (FWD, RWD, AWD)
displacement - vëllimi i motorit
vin - numri i identifikimit të automjetit
city - qyteti i shitësit
seller_type - lloji i shitësit
is_dealer - tregues nëse shitësi është tregtar
offer_created - data e krijimit të shpalljes
images - varg me URL imazhesh
power - fuqia e motorit në kuaj-fuqi (hp)
first_registration - data e regjistrimit të parë (YYYY-MM)

Eksportime ditore

Ruajtja e skedarëve

Skedarët ruhen të paktën 3 ditë

Orari i përditësimeve

Skedarë të rinj me të dhëna, të krijuar çdo ditë dhe të disponueshëm për shkarkim

Formati i skedarit

Skedarët CSV përdorin simbolin e vijës vertikale (|) për të ndarë kolonat

Struktura e URL-së:

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

Parametrat e kërkesës:

access_name - identifikuesi i nëndomenit që ju është caktuar
date - data e dëshiruar në formatin yyyy-mm-dd (p.sh. 2025-09-06)
file_name - emri i skedarit të eksportimit me prapashtesë

Formatet e disponueshme:

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 API 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

Komanda e shkarkimit me Wget

wget --method GET \
  --header 'Authorization: Basic XXX==' \
  'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'

Che168.com

Shpalljet në Che168.com përmbajnë të dhëna të plota të automjeteve, përfshirë specifikimet, çmimet, të dhënat e shitësit dhe të vendndodhjes. Këto të dhëna tregojnë tendencat e tregut, ecurinë e çmimeve dhe sjelljen e blerësve në tregun automobilistik të Kinës.

Historiku i automjeteve, raportet e inspektimit dhe të dhënat e financimit nga platforma japin njohuri të vlefshme. Kompanitë i përdorin këto të dhëna për planifikimin e stokut, vendimet për çmimet dhe strategjinë e tregut.

Ekipet e studimit të tregut, zhvilluesit e aplikacioneve automobilistike dhe analistët i përdorin këto të dhëna përmes API-së sonë për Che168. Qasja e drejtpërdrejtë në të dhëna do të thotë se nuk ju duhet të zhvilloni apo të mirëmbani scraper.

Che168 API punon vazhdimisht, zbulon shpalljet e reja brenda pak minutash dhe monitoron ndryshimet e çmimeve, për të dhëna të tregut në kohë reale. Të gjitha të dhënat automobilistike janë të disponueshme përmes endpoint-eve të strukturuara të API-së.

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

🇯🇵

Goo-net Exchange API

API për makina në Japoni

🇦🇪