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

Merrni qasje të drejtpërdrejtë në të dhënat e platformës Dubicars në mbarë Emiratet e Bashkuara Arabe. Tërhiqni shpallje automjetesh përmes thirrjeve standarde REST, përfshirë markat, modelet, çmimet në AED dhe specifikimet e plota. Monitoroni shpalljet e reja në treg, ndryshimet e çmimeve dhe automjetet e shitura.

Çfarë të dhënash nga Dubicars jep API-ja?

Tërhiqni të dhënat e plota të shpalljes: marka dhe modeli, viti, çmimi (AED), specifikimet GCC kundrejt atyre të importit, evidenca e servisit, të dhënat e garancisë, fotot me rezolucion të lartë, të dhënat e tregtarit dhe vendndodhja e saktë.

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

Përditësime në kohë reale. Shpalljet e reja dhe ndryshimet e çmimeve zbulohen brenda pak minutash. Skedarët ditorë të eksportimit përfshijnë të gjitha shpalljet aktive dhe automjetet e shitura së fundmi, nga çdo emirat.

Çfarë formatesh mbështet Dubicars API?

Ofrohen disa formate të dhënash: REST API për përditësime në kohë reale, JSON për parsim të strukturuar dhe CSV/XLSX për analizë dhe raportim. Të dhënat e plota të automjetit jepen në të gjitha formatet.

A i mbulon API-ja të gjitha emiratet e EBA-së?

Po, të dhënat përfshijnë shpallje nga Dubai, Abu Dabi, Sharjah, Ajman dhe të gjitha emiratet e tjera. Të dhënat e vendndodhjes tregojnë emiratin dhe qytetin për çdo shpallje.

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.

A mund t'i filtroj veçmas shpalljet e tregtarëve dhe ato të shitësve privatë?

Po, çdo shpallje përfshin të dhëna për llojin e shitësit. Përmes të dhënave të API-së mund të dalloni midis autosalloneve të autorizuara, tregtarëve të pavarur dhe shitësve privatë.

Dubicars APIScraper & Parser

Qasje profesionale në API për të dhënat e Dubicars. Shpallje makinash në kohë reale nga Dubai, Abu Dabi dhe anembanë EBA-së: çmime, specifikime, të dhëna tregtarësh.

Biblioteka zyrtare SDK

Plotësisht me kod të hapur dhe të dokumentuara në GitHub. Shtoni njërën në projektin tuaj dhe filloni të merrni shpallje nga Dubicars, pa nevojë për kod shabllon.

PHP Node.js Python Go C#Java Ruby Rust

Dubicars API

Merrni qasje në platformën automobilistike të Emirateve të Bashkuara Arabe me një API të thjeshtë. Tërhiqni të dhëna automjetesh nga Dubai, Abu Dabi, Sharjah dhe të gjitha emiratet, përfshirë çmimet (AED), specifikimet dhe të dhënat e tregtarëve. Përshtatet shumë mirë për menaxhimin e stokut, krahasimin e çmimeve dhe studimin e tregut, pa nevojë për scraper të ndërtuar vetë.

API

Shpalljet e reja zbulohen dhe jepen përmes API-së brenda pak minutash.

Eksportime ditore

Skedar ditor me të gjitha shpalljet aktive në mbarë Emiratet.

Të dhëna të plota

Nxirrni të dhënat e plota: çmimi (AED), odometri, viti, marka, modeli, specifikimet e motorit, specifikimet rajonale (GCC/import), evidenca e mirëmbajtjes, mbulimi i garancisë dhe të dhënat e inspektimit.

Merrni qasje në APIQasja jepet brenda 2 minutash

API

URL bazë

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

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

Si të filloni me integrimin:

1. Së pari tërhiqni stokun e plotë me /offers - kaloni nëpër të gjitha faqet për të ndërtuar setin tuaj fillestar të të dhënave

2. Pas importimit, thirrni rregullisht /changes për të kapur çdo shtim, ndryshim çmimi ose heqje dhe për të ruajtur sinkronizimin

3. Kur ndërtoni frontend-in tuaj, përdorni /offers me filtra (marka, modeli, çmimi, viti, emirati) dhe faqosje për marrje efikase të të dhënave

GET/filters

Kthen të gjitha vlerat e mundshme për filtrim

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

Përgjigjja:

{
  "mark": {
    "Kia": {
      "model": ["Carnival", "Carnival 3.5L Petrol", "Cerato", "Cerato 1.6L", "K5", "K5 2.0L LX", "Seltos", "Seltos 1.5L", "Sorento", "Sorento 2.5L AWD", "Sportage", "Sportage 1.6L TURBO"]
    },
    "Toyota": {
      "model": ["Land Cruiser", "Land Cruiser VXR", "Land Cruiser GXR", "Camry", "Camry 2.5L", "Corolla", "RAV4", "Prado"]
    }
  },
  "transmission_type": ["MT", "AT"],
  "color": ["Silver", "Green", "Red", "Purple", "Blue", "Champagne", "Gray", "White", "Black", "Yellow"],
  "body_type": ["SUV", "Hatchback", "Sedan", "Bus", "Convertible", "Sports Car", "Station Wagon", "Pick Up", "Crossover", "Truck"],
  "engine_type": ["HEV", "Gasoline", "Diesel", "PHEV", "BEV", "REEV"]
}

GET/offers

Lista e shpalljeve me faqosje dhe filtra

Parametrat:

page (i detyrueshëm) - numri i faqes
mark, model, configuration, complectation - filtra (pa dallim midis shkronjave të mëdha dhe të vogla)
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ë AED)

https://{access_name}.auto-api.com/api/v2/dubicars/offers?api_key=YOUR_API_KEY&page=1https://{access_name}.auto-api.com/api/v2/dubicars/offers?api_key=YOUR_API_KEY&page=1&mark=Toyota&color=white

Përgjigjja:

{
  "result": [
    {
      "id": 8234567,
      "inner_id": "904588",
      "change_type": "added",
      "created_at": "2025-10-31T03:30:24.000Z",
      "data": {
        "id": 263,
        "inner_id": "904588",
        "url": "https://www.dubicars.com/2021-ram-1500-trx-904588.html",
        "mark": "RAM",
        "model": "1500 TRX",
        "configuration": "Crew Cab",
        "complectation": "6.2L Supercharged",
        "year": 2021,
        "color": "Blue",
        "price": 300000,
        "km_age": 40000,
        "engine_type": "Gasoline",
        "transmission_type": "AT",
        "body_type": "Pick Up",
        "address": "Dubai",
        "seller_type": "Private",
        "is_dealer": false,
        "section": "used",
        "seller": "youssef",
        "salon_id": "1623",
        "description": "2021 Ram 1500 TRX, single owner...",
        "displacement": 6200,
        "offer_created": "2025-10-31",
        "doors_count": 4,
        "rudder": "Left",
        "images": ["https://www.dubicars.com/images/904588_001.jpg"],
        "extra": {}
      }
    }
  ],
  "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
configuration - versioni
complectation - varianti
year - viti i prodhimit
color - ngjyra
price - çmimi në AED
km_age - kilometrazhi në km
engine_type - lloji i motorit

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
seller - shitësi
salon_id - ID-ja e tregtarit
description - përshkrimi
displacement - vëllimi i motorit (cc)
offer_created - data e krijimit të shpalljes
images - varg me URL imazhesh

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/dubicars/change_id?api_key=YOUR_API_KEY&date=2025-01-15

Përgjigjja:

{ "change_id": 5829147 }

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/dubicars/changes?api_key=YOUR_API_KEY&change_id=1

Përgjigjja:

{
  "result": [
    {
      "id": 456,
      "inner_id": "904588",
      "change_type": "added",    // added - new listing
      "created_at": "2025-01-15T10:30:00Z",
      "data": { ... }            // full listing data
    },
    {
      "id": 457,
      "inner_id": "904589",
      "change_type": "changed",  // changed - price update
      "created_at": "2025-01-15T10:31:00Z",
      "data": { "new_price": 290000 }
    },
    {
      "id": 458,
      "inner_id": "904590",
      "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

Një shpallje e vetme sipas inner_id

Parametrat:

inner_id (i detyrueshëm)

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

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

Eksportime ditore

Politika e ruajtjes së të dhënave

Skedarët mbahen të paktën 3+ ditë

Orari i disponueshmërisë së API-së

Skedarë ditorë të rinj, gati për shkarkim

Formati i të dhënave 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-10-15)
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'

Dubicars.com

Dubicars.com nisi punën në vitin 2012 dhe është një platformë automobilistike e specializuar për Emiratet e Bashkuara Arabe. Ndryshe nga portalet e përgjithshme të shpalljeve, përqendrohet vetëm te automjetet. Platforma ka rreth 30 000 shpallje në Dubai, Abu Dabi, Sharjah, Ajman dhe emiratet veriore, si nga autosallone të autorizuara, ashtu edhe nga shitës të pavarur.

Platforma vë theksin te të dhënat kryesore për tregun e Emirateve të Bashkuara Arabe. Shpalljet bëjnë dallimin midis specifikimeve GCC dhe importeve, një faktor thelbësor për vlerën e rishitjes dhe për sigurimin. Të dhënat përfshijnë statusin e garancisë, historikun e pronësisë dhe verifikimin e aksidenteve. Shumë shpallje kanë edhe regjistra mirëmbajtjeje nga servise të autorizuara.

E dobishme për përdorime të ndryshme. Tregtarët mund të ndjekin çmimet e konkurrentëve nëpër emirate, duke vënë re diferencat rajonale, si dallimet e çmimeve midis Dubai Marina dhe Fujairah. Vlerësuesit e dëmeve në sigurime i përdorin të dhënat për vlerësime, ndërsa eksportuesit monitorojnë modele të caktuara. API-ja i jep këto të dhëna të platformës përmes endpoint-eve të strukturuara, te të cilat mund të bëni kërkesa.

Dubicars API punon vazhdimisht dhe i zbulon shpalljet e reja brenda pak minutash. Shpalljet e hequra ndiqen për të dhënë njohuri mbi çmimet reale të transaksioneve kundrejt çmimeve të kërkuara. Të gjitha të dhënat jepen përmes endpoint-eve REST, duke eliminuar nevojën për infrastrukturë scraping-u.

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

🇦🇪