AUTO-API.COM
Logoja e Dongchedi.com

Dongchedi APIScraper & Parser

Dongchedi API: shpallje makinash të përdorura në Kinë me çmim, kilometrazh, specifikime dhe foto. REST API dhe eksportime ditore.

Biblioteka zyrtare SDK

Lërini mënjanë thirrjet HTTP të shkruara me dorë. Këto biblioteka e mbështjellin Dongchedi API, kështu që mund të bëni kërkesa për shpallje me dy-tre rreshta kodi.

Dongchedi API

Merrni qasje në platformën më të madhe të makinave në Kinë përmes API-së sonë. Tërhiqni të dhëna të pastra automjetesh nga mbarë Kina për analitikë dhe studim tregu.

API

Merrni njoftime të menjëhershme për shpalljet e reja të automjeteve në Kinë.

Eksportime ditore

Eksportim ditor i të gjitha shpalljeve aktive për analizë tregu.

Të dhëna të plota

Merrni qasje në të gjitha të dhënat e makinave përmes API-së: çmimi, specifikimet, diagnostikimi, historiku, modifikimet nga çdo shpallje.

Merrni qasje në APIQasja jepet brenda 2 minutash

Shpallja përfshin tashmë specifikimet e variantit, pajisjet, të dhënat e baterisë dhe rezultatin e inspektimit të Dongchedi.

URL bazë

https://{access_name}.auto-api.com/api/v3/dongchedi

Autorizimi: api_key parametër

Rrjedha e punës

1
/filtersmerrni vlerat e disponueshme të filtrave
2

Ngarkimi fillestar:

/change_id?date=...merrni ID-në fillestare për fluksin e ndryshimeve
/offersmerrni të gjitha shpalljet faqe pas faqeje
3
/changes?change_id=...merrni të gjitha ndryshimet në bazën e të dhënave duke filluar nga ID-ja
4
/offermerrni të dhënat e një shpalljeje të caktuar sipas inner_id
5
/imageslidhje të freskëta të fotove

Si të filloni:

1. Para ngarkimit të parë, merrni numrin nga /change_id për datën e sotme dhe ruajeni. Pastaj kaloni nëpër /offers faqe pas faqeje deri në fund: në faqen e fundit next_page është null.

2. Më pas thirrni rregullisht /changes duke filluar nga ky numër dhe dërgoni next_change_id nga çdo përgjigje. Kështu vijnë shpalljet e reja, çmimet e reja dhe heqjet nga shitja. Nëse next_change_id është null, ende nuk ka ngjarje: përsëritni të njëjtën kërkesë më vonë.

3. Lidhjet e fotove të Dongchedi funksionojnë jo më shumë se 7 ditë. Për t'i shfaqur fotot në një faqe interneti, përditësoni lidhjet përmes /images.

4. Për të kërkuar sipas kritereve tuaja, thirrni /offers me filtra.

Formati i të dhënave

  • Llojet e të dhënave ruhen: një numër vjen si numër, një listë si varg, një vlerë që mungon si null.
  • Vulat kohore janë në UTC, për shembull "2026-06-02T17:25:48Z". Datat jepen si "2026-09-02", muajt si "2024-01".
  • Të gjitha shumat janë në CNY.
  • Çdo shpallje ka të njëjtët çelësa. Nëse një bllok si inspektimi i Dongchedi nuk ka të dhëna, blloku është null.

GET/filters

Kthen të gjitha vlerat e mundshme për filtrim

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

Përgjigjja:

{
  "mark": {
    "BYD": {
      "model": {
        "Han DM": { "complectation": ["DM 4WD Performance Edition Luxury Version", "DM 4WD Performance Edition Premium Version", "DM-i 121KM Premium Version", "DM-i 121KM Prestige Version", ...] },
        ...
      }
    },
    "Geely": {
      "model": {
        "Boyue": { "complectation": ["1.5TD 10th Anniversary Champion Edition", "1.5TD Auto PRO", "1.5TD Auto Smart Connected PRO", "1.5TD Beloved", ...] },
        ...
      }
    },
    ...
  },
  "transmission_type": ["AMT", "Automatic", "CVT", "DCT", ...],
  "color": ["Black", "Blue", "Brown", "Champagne", ...],
  "body_type": ["Convertible", "Coupe", "Hatchback", "Liftback", ...],
  "engine_type": ["Bi-fuel", "CNG", "Diesel", "Electric", ...],
  "drive_type": ["AWD", "FWD", "RWD"]
}

GET/offers

Shpalljet faqe pas faqeje. Filtrat i ngushtojnë rezultatet.

Parametrat:

  • page (i detyrueshëm) - numri i faqes
  • mark, model, complectation - emrat e markës, modelit dhe variantit, siç shkruhen në /filters
  • transmission_type, color, body_type, engine_type, drive_type - vlerat e transmisionit, ngjyrës, karrocerisë, karburantit dhe tërheqjes, pa dallim midis shkronjave të mëdha dhe të vogla
  • owners_count - numri i pronarëve
  • first_registration_from, first_registration_to - muaji i regjistrimit të parë, nga dhe deri, në formatin yyyy-mm
  • year_from, year_to - viti i modelit, nga dhe deri
  • km_age_from, km_age_to - kilometrazhi në km, nga dhe deri
  • price_from, price_to - çmimi në juan, nga dhe deri

Për të dërguar disa vlera në një filtër, përsëritni parametrin me kllapa katrore: mark[]=Li Auto&mark[]=Zeekr

https://{access_name}.auto-api.com/api/v3/dongchedi/offers?api_key=YOUR_API_KEY&page=1https://{access_name}.auto-api.com/api/v3/dongchedi/offers?api_key=YOUR_API_KEY&page=1&mark=Li Auto&model=L8&first_registration_from=2023-01&owners_count=1https://{access_name}.auto-api.com/api/v3/dongchedi/offers?api_key=YOUR_API_KEY&page=1&mark[]=Li Auto&mark[]=Zeekr&color[]=Silver&color[]=Black&price_to=250000

Përgjigjja:

{
  "result": [
    {
      "id": 241873,
      "inner_id": "24015678",
      "change_type": "added",
      "created_at": "2026-06-02T17:25:48Z",
      "data": {
        "id": 241873,
        "inner_id": "24015678",
        "url": "https://www.dongchedi.com/usedcar/24015678",
        "mark": "Li Auto",
        "model": "L8",
        "complectation": "Pro Edition",
        "title": "Li Auto L8 2023 Pro Edition",
        "year": 2023,
        "first_registration": "2024-01",
        "km_age": 54300,
        "owners_count": 2,
        "price": 196800,
        "currency": "CNY",
        "installment_price": null,
        "installment_down_payment": null,
        "purchase_costs": {
          "items": [
            { "name": "Car price", "price": 199800 },
            { "name": "Registration service", "price": 1000 },
            { "name": "Delivery", "price": 2500 },
            { "name": "Total", "price": 203300 }
          ],
          "deposit": 1500
        },
        "engine_type": "EREV",
        "transmission_type": "Single-speed",
        "body_type": "SUV",
        "vehicle_class": "Mid-to-large SUV",
        "drive_type": "AWD",
        "color": "Silver",
        "displacement": 1.5,
        "displacement_cc": 1496,
        "engine_model": "L2E15M",
        "power": 449,
        "power_ice_hp": 154,
        "power_ice_kw": 113,
        "power_ice_net_kw": null,
        "power_hybrid_kw": 330,
        "power_electro_kw": 330,
        "power_electro_front_kw": 130,
        "power_electro_rear_kw": 200,
        "battery_capacity_kwh": 42.8,
        "electric_range_km": 175,
        "seat_count": 6,
        "emission_standard": "China VI b",
        "keys_count": null,
        "sales_status": "Available",
        "presale_note": null,
        "section": "Used",
        "seller_type": "Dealer",
        "is_dealer": true,
        "seller": "懂车帝汽车商城•斌哥新能源专营店",
        "salon_id": "205449",
        "city": "Quanzhou",
        "region": "Fujian",
        "registration_city": "Guangzhou",
        "address": "泉州市南环路922-1号",
        "description": null,
        "created_at": "2026-06-02T17:25:48Z",
        "photos": [
          "https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/ca839b3effdd406981a2a8d0cb29ca23~tplv-f042mdwyw7-original:1000:0.image?...",
          "https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/0785677e64c3472182760c423650c419~tplv-f042mdwyw7-original:1000:0.image?...",
          "https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/31316d47b21f4e6b8ab2de987429fde3~tplv-f042mdwyw7-original:1000:0.image?...",
          "https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/d251ef9e5351442986213b93515eb24e~tplv-f042mdwyw7-original:1000:0.image?...",
          ...
        ],
        "photo_details": [
          { "type": "Front left", "url": "https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/ca839b3effdd406981a2a8d0cb29ca23~tplv-f042mdwyw7-original:1000:0.image?..." },
          { "type": "Front", "url": "https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/0785677e64c3472182760c423650c419~tplv-f042mdwyw7-original:1000:0.image?..." },
          { "type": "Front right", "url": "https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/31316d47b21f4e6b8ab2de987429fde3~tplv-f042mdwyw7-original:1000:0.image?..." },
          { "type": "Left side", "url": "https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/d251ef9e5351442986213b93515eb24e~tplv-f042mdwyw7-original:1000:0.image?..." },
          ...
        ],
        "original": {  // vlerat origjinale nga dongchedi.com
          "mark": "理想汽车",
          "model": "理想L8",
          "complectation": "Pro版",
          "color": "银灰色",
          "engine_type": "增程式",
          "transmission_type": "电动车单速变速箱",
          "drive_type": "双电机四驱",
          "body_type": "SUV",
          "vehicle_class": "中大型SUV",
          "emission_standard": "国VI b",
          "city": "泉州",
          "title": "理想L8 2023款 Pro版",
          "registration_city": "广州"
        },
        "catalog_ids": {
          "mark": "202",
          "model": "6095",
          "complectation": "76932"
        },
        "options": {
          "Safety and driver assistance": ["Advanced driver assistance system", "Rear collision warning", "Rear cross-traffic alert"],
          "Parking and cameras": ["Automatic parking", "Surround view cameras"],
          "Comfort": ["Wireless phone charging", "Front seat massage"],
          "Lighting": ["Headlight leveling"]
        },
        "specs": {
          "Basic information": {
            "Manufacturer's suggested price (CNY)": "359800",
            "Manufacturer": "Li Auto",
            "Class": "Mid-to-large SUV",
            "Fuel type": "EREV",
            "Launch date": "2022.09",
            "Electric motor": "EREV, 449 hp",
            ...
          },
          "Body": {
            "Length (mm)": "5080",
            "Width (mm)": "1995",
            "Height (mm)": "1800",
            "Wheelbase (mm)": "3005",
            "Front track (mm)": "1725",
            ...
          },
          "Engine": {
            "Engine model": "L2E15M",
            "Displacement (mL)": "1496",
            "Displacement (L)": "1.5",
            "Aspiration": "Turbocharged",
            ...
          },
          "Electric motor": {
            "Motor type": "Permanent magnet synchronous",
            "Total electric motor power (kW)": "330",
            "Total electric motor power (hp)": "449",
            "Total electric motor torque (N·m)": "620",
            ...
          },
          ...
        },
        "battery": {
          "type": "NMC/NCA",
          "cell_supplier": "CATL",
          "warranty_until": "2032-01",
          "warranty_km_limit": 160000,
          "consumption_kwh_100km": 24.2,
          "fast_charge_hours": 0.5,
          "slow_charge_hours": 6.5
        },
        "inspection": {
          "date": "2026-09-02",
          "score": 9,
          "score_exterior": 6.5,
          "score_interior": 9.9,
          "score_key_parts": 9.8,
          "points_checked": 310,
          "issues_exterior": 19,
          "issues_interior": 0,
          "issues_key_parts": 1,
          "is_major_accident": false,
          "is_flooded": false,
          "is_fire_damaged": false,
          "is_odometer_tampered": false,
          "summary": "本车登记证已核验,过户1次,外观金属覆盖件有3处钣金喷漆,另...",
          "battery_soh_percent": 95,
          "battery_capacity_kwh": 40.9,
          "battery_resistance_score": 92
        },
        "repaired_parts": null,
        "selected_options": null
      }
    }
  ],
  "meta": {
    "page": 1,
    "next_page": 2,
    "limit": 20
  }
}

Fushat e të dhënave:

Shpallja

id - ID-ja e brendshme në bazën e të dhënave

inner_id - ID-ja e shpalljes në platformë

url - lidhja e shpalljes

title - Titulli i shpalljes në një rresht: marka, modeli, viti, varianti.

price, currency - Çmimi në juan, currency është gjithmonë CNY.

installment_price, installment_down_payment - Çmimi me këste dhe pagesa fillestare, kur shitësi i jep.

purchase_costs - Llogaritja e Dongchedi: items (zërat e shpenzimeve, secili me name dhe price) dhe deposit (kapari).

sales_status - "Available" ose "Pre-sale".

presale_note - Komenti i Dongchedi për parashitjen.

section - "Used" ose "New".

description - përshkrimi

created_at - Koha kur shpallja hyri në bazën tonë të të dhënave.

Makina

mark, model, complectation - Marka, modeli, varianti.

year - Viti i modelit.

first_registration - Muaji i regjistrimit të parë.

km_age - kilometrazhi në km

owners_count - Sa pronarë ka pasur makina.

keys_count - Numri i çelësave të makinës, nuk jepet në çdo shpallje.

registration_city - Qyteti ku është regjistruar makina.

Specifikimet

engine_type, transmission_type, body_type - Motori, transmisioni dhe karroceria.

vehicle_class - Klasa sipas madhësisë, për shembull "Compact SUV".

drive_type - Tërheqja: "FWD", "RWD" ose "AWD".

color - Ngjyra e karrocerisë.

displacement, displacement_cc - Vëllimi i motorit në litra dhe në centimetra kub.

engine_model - Kodi i motorit.

power - Fuqia totale, hp.

power_ice_hp, power_ice_kw - Motori me djegie të brendshme: hp dhe kW.

power_ice_net_kw - Fuqia neto e motorit me djegie të brendshme, kW.

power_hybrid_kw - Fuqia e të gjithë sistemit hibrid, kW.

power_electro_kw - Të gjithë motorët elektrikë së bashku, kW.

power_electro_front_kw, power_electro_rear_kw - Motori elektrik i përparmë dhe i pasmë veçmas, kW.

battery_capacity_kwh - Kapaciteti i baterisë së tërheqjes, kWh.

electric_range_km - Autonomia vetëm me energji elektrike, km.

seat_count - Numri i vendeve.

emission_standard - Standardi i emetimeve, për shembull "China VI b".

Shitësi

seller_type, is_dealer - "Dealer" ose "Private seller", is_dealer e përsërit këtë si true/false.

seller, salon_id - Shitësi në Dongchedi dhe ID-ja e tij atje.

city, region - Qyteti i shitësit dhe provinca ku ndodhet ky qytet.

address - Adresa e shitësit.

Fotot, pajisjet dhe të dhënat referuese

photos - Lidhjet e fotove. Secila vlen deri në 7 ditë, lidhje të freskëta merrni nga /images.

photo_details - Të njëjtat foto, me llojin e këndit në type, për shembull "Front left", dhe me lidhjen në url. Nëse këndi nuk dihet, type është null.

options - Pajisjet sipas grupeve "Safety and driver assistance", "Parking and cameras", "Comfort", "Multimedia and connectivity", "Lighting", "Driving modes". Elementet me shënimin "(optional)" mund të mungojnë në këtë makinë konkrete.

specs - Specifikimet e variantit sipas seksioneve, të gjitha vlerat si string. Mund të ketë deri në 22 seksione: "Basic information", "Body", "Engine", "Battery and charging", "Passive safety" dhe të tjera.

selected_options - Opsionet e montuara në këtë makinë, me çmimin e tyre kur blihen të reja: count (numri i opsioneve gjithsej), total_price (kostoja e tyre), items (deri në pesë zëra, secili me name dhe price).

repaired_parts - Pjesët që në kontroll janë shënuar si të riparuara: part (cila pjesë) dhe mark (cila shenjë).

original - Emrat dhe vlerat origjinale nga dongchedi.com.

catalog_ids - Kodet e markës, modelit dhe variantit në katalogun e dongchedi.com.

Bateria (battery)

Të dhënat e baterisë së tërheqjes për makinat elektrike dhe hibride. Nëse nuk ka të tilla, battery është null. Një çelës që nuk ka vlerë nuk përfshihet në bllok.

type - Lloji kimik, për shembull "LFP" ose "NMC/NCA".

cell_supplier - Kush i prodhon qelizat, për shembull "CATL".

ownership - "Owned" ose "Leased".

warranty_until, warranty_km_limit - Garancia e baterisë: muaji i mbarimit dhe kufiri i kilometrazhit në km.

consumption_kwh_100km - Konsumi i energjisë, kWh për 100 km.

fast_charge_hours, slow_charge_hours - Sa orë zgjat karikimi i shpejtë dhe ai i ngadaltë.

Inspektimi i Dongchedi (inspection)

Rezultati i inspektimit që e ka kryer vetë Dongchedi. Nëse Dongchedi nuk e ka inspektuar makinën, inspection është null. Një çelës që nuk ka vlerë nuk përfshihet në bllok.

date - Dita e inspektimit.

score, score_exterior, score_interior, score_key_parts - Notat në shkallë dhjetëpikëshe: nota e përgjithshme, pjesa e jashtme, brendësia, pjesët kyçe.

points_checked - Sa pika inspektimi u kontrolluan.

issues_exterior, issues_interior, issues_key_parts - Sa vërejtje u gjetën në pjesën e jashtme, në brendësi dhe në pjesët kyçe.

is_major_accident, is_flooded, is_fire_damaged, is_odometer_tampered - Tregues për aksident të rëndë, përmbytje, zjarr dhe kilometrazh të kthyer mbrapsht (true/false).

summary - Përfundimi i inspektorit.

battery_soh_percent - Sa përqind të kapacitetit të saj ka ruajtur bateria.

battery_capacity_kwh - Kapaciteti i baterisë sipas inspektimit, kWh.

battery_resistance_score - Nota e baterisë sipas rezistencës së brendshme, në pikët e Dongchedi.

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/v3/dongchedi/change_id?api_key=YOUR_API_KEY&date=2026-10-22

Përgjigjja:

{
  "change_id": 63514
}

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/v3/dongchedi/changes?api_key=YOUR_API_KEY&change_id=63527

Përgjigjja:

{
  "result": [
    {
      "id": 63528,
      "inner_id": "357103842",
      "change_type": "added",
      "created_at": "2026-10-22T06:48:19Z",
      "data": { ... }  // trupi i plotë i shpalljes
    },
    {
      "id": 63533,
      "inner_id": "356991207",
      "change_type": "changed",
      "created_at": "2026-10-22T07:05:52Z",
      "data": {  // çmimi ndryshoi, çmimi i ri në CNY
        "new_price": 118800
      }
    },
    {
      "id": 63540,
      "inner_id": "356884615",
      "change_type": "removed",
      "created_at": "2026-10-22T07:22:11Z",
      "data": {}  // u hoq nga shitja
    }
    // ... pastaj ngjarjet e tjera, deri në 20 për faqe
  ],
  "meta": {
    "cur_change_id": 63527,
    "next_change_id": 63547,
    "limit": 20
  }
}

GET/offer

Një shpallje e vetme sipas inner_id

Parametrat:

  • inner_id (i detyrueshëm)
https://{access_name}.auto-api.com/api/v3/dongchedi/offer?api_key=YOUR_API_KEY&inner_id=24015678

Përgjigjja përmban vetëm objektin data, pa mbështjellësin result.

GET/images

Lidhjet aktuale të fotove. Një lidhje e Dongchedi vlen deri në 7 ditë, prandaj metoda kthen shpalljet, lidhjet e të cilave janë përditësuar në 5 ditët e fundit. Nuk ofrohet për çelësin demo.

Parametrat:

  • page (i detyrueshëm) - numri i faqes
  • updated_from - data yyyy-mm-dd nga e cila merren lidhjet e përditësuara
https://{access_name}.auto-api.com/api/v3/dongchedi/images?api_key=YOUR_API_KEY&page=1https://{access_name}.auto-api.com/api/v3/dongchedi/images?api_key=YOUR_API_KEY&page=1&updated_from=2026-10-22

Përgjigjja:

{
  "result": [
    {
      "id": 30518,
      "inner_id": "18420227",
      "images": [
        "https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/e236a9deba9948ea8414c2c067d05578~tplv-f042mdwyw7-original:1000:0.image?...",
        "https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/d69b5918081541589c1abdb9e4ac60f9~tplv-f042mdwyw7-original:1000:0.image?...",
        "https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/96a549722df742849267218df1e4568a~tplv-f042mdwyw7-original:1000:0.image?...",
        "https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/02648d3a0f524244b2d9ecf4f1a6cb42~tplv-f042mdwyw7-original:1000:0.image?...",
        ...
      ],
      "synced_at": "2026-10-20"
    }
    // ... pastaj shpalljet e tjera, deri në 20 për faqe
  ],
  "meta": {
    "page": 1,
    "next_page": 2,
    "limit": 20
  }
}

Fushat e të dhënave:

  • id, inner_id - numri i rekordit në bazën tonë të të dhënave dhe numri i shpalljes në Dongchedi
  • images - varg me lidhje
  • synced_at - dita kur u përditësuan lidhjet

Gabimet

Në rast gabimi, përgjigjja ka fushën error me një përshkrim: { "error": "parameter page is required" }

  • 401 - api_key nuk u pranua
  • 400 - mungon një parametër i detyrueshëm ose një vlerë ka format të gabuar
  • 404 - nuk ka shpallje me këtë inner_id (/offer)
  • 429 - limiti i kërkesave është shteruar

Sipas lidhjes së një shpalljeje në dongchedi.com, API-ja kthen të dhënat e saj: fushat si në /offer dhe një bllok meta me limitin e mbetur.

URL bazë

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

Autorizimi: header x-api-key

POST/api/v2/offer/info

Një shpallje sipas lidhjes së saj

Parametrat:

  • url (i detyrueshëm) - adresa e faqes së shpalljes në dongchedi.com

Shembull kërkese:

curl -L 'https://{access_name}.auto-api.com/api/v2/offer/info' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ "url": "https://www.dongchedi.com/usedcar/24015678" }'

Përgjigjja:

{
  "id": 241873,
  "inner_id": "24015678",
  "url": "https://www.dongchedi.com/usedcar/24015678",
  "mark": "Li Auto",
  "model": "L8",
  "complectation": "Pro Edition",
  "title": "Li Auto L8 2023 Pro Edition",
  "year": 2023,
  "first_registration": "2024-01",
  "km_age": 54300,
  // ... fushat e tjera të shpalljes, si në /offer në API v3
  "meta": {
    "requests_made": 48,
    "requests_left": 1952,
    "requests_limit": 2000,
    "period_start": "2026-11",
    "platform": "dongchedi"
  }
}

Fushat e shpalljes janë të njëjta me ato që kthen /offer në API v3. Blloku meta vjen i fundit.

Çfarë ka në meta:

  • requests_made - sa kërkesa të suksesshme janë bërë këtë muaj
  • requests_left - sa kërkesa mund të bëni ende
  • requests_limit - limiti mujor
  • period_start - muaji i numëruesit
  • platform - nga cila platformë është shpallja: encar, che168, dongchedi, guazi ose mobilede

Në limitin mujor llogariten vetëm përgjigjet me shpallje; gabimet nuk e harxhojnë.

Gabimet

Në rast gabimi, përgjigjja ka fushën error me një përshkrim: { "error": "Failed to get info" }

  • 401 - x-api-key nuk u pranua
  • 400 - lidhja mungon ose nuk u lexua dot, ose platforma nuk është aktivizuar për çelësin
  • 422 - të dhënat e shpalljes nuk u morën dot
  • 429 - limiti i kërkesave është shteruar

Protokolli i ruajtjes së të dhënave

Skedarët ruhen për 3+ ditë.

Orari i dërgimit përmes API-së

Skedarët ditorë janë gati për shkarkim.

Konfigurimi i skedarit CSV

Skedarët CSV përdorin vijën vertikale (|) si ndarës kolonash.

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'
Dongchedi.com

Dongchedi është një platformë kryesuese makinash në Kinë. Miliona njerëz e përdorin për të blerë e shitur automjete dhe për t'u informuar rreth tyre. Tregtarët dhe shitësit privatë nxjerrin në shitje makina të reja dhe të përdorura, motoçikleta dhe automjete komerciale nëpër qytetet e mëdha.

Çdo shpallje përfshin specifikime të qarta, foto me cilësi të lartë, historik çmimi dhe verifikime të shitësit. Mund të filtroni sipas markës, modelit, vitit, çmimit dhe vendndodhjes për të gjetur shpejt makinën e duhur.

Përveç shpalljeve, Dongchedi ofron lajme, recensione, krahasime krah për krah dhe pasqyrë të tregut, për t'i ndihmuar blerësit të vendosin me bindje. Lidhjet e forta me shitës të verifikuar dhe tregtarë të autorizuar e mbajnë cilësinë të lartë.

API-ja jep të dhëna të organizuara nga platforma Dongchedi përmes endpoint-eve të besueshme. Përdoreni në aplikacionet tuaja për caktim çmimesh, ndjekje stoku dhe analizë tregu.

API-ja jonë në kohë reale punon 24/7, zbulon shpalljet e reja brenda pak minutash dhe ndjek heqjet nga shitja, për të pasqyruar lëvizjet reale të tregut. Nuk nevojitet parser apo crawler i ndërtuar vetë.

Përgjigje brenda 2 min