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

Merrni qasje në platformën kryesore të makinave në Evropë përmes API-së sonë. Tërhiqni të dhëna të strukturuara makinash përmes thirrjeve REST. Ndiqni në kohë reale shpalljet e reja, ndryshimet e çmimeve dhe automjetet e shitura.

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

Të gjitha të dhënat e automjetit: marka, modeli, viti, çmimi, kilometrazhi, motori, transmisioni, numri VIN, veçoritë, pajisjet, të dhënat e shitësit, fotot dhe raportet e inspektimit.

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

Përditësimet bëhen menjëherë. 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 AutoScout24 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. Çdo eksportim përmban të dhëna gjithëpërfshirëse automjetesh.

Cilat shtete mbulon AutoScout24 API?

API-ja jep të dhëna nga të gjitha tregjet e AutoScout24: Gjermania, Italia, Franca, Spanja, Holanda, Belgjika, Austria dhe shtete të tjera evropiane.

A mund të filtroj sipas shtetit të shitësit?

Po, të dhënat përfshijnë shtetin dhe rajonin e shitësit. Mund t'i filtroni shpalljet sipas parametrit country_code ose të përdorni filtra rajonalë.

A përfshihen të dhënat e tregtarëve?

Po, API-ja jep llojin e shitësit dhe ID-në e tregtarit. Mund të ndiqni të gjithë stokun e një tregtari të caktuar ose të filtroni vetëm shpalljet e shitësve privatë.

AutoScout24 APIScraper & Parser

AutoScout24 API - qasje në të dhënat e AutoScout24: çmime, specifikime, foto, historik. REST API dhe eksportime ditore me makina nga Evropa për biznesin tuaj.

Biblioteka zyrtare SDK

Instaloni një bibliotekë, jepini çelësin tuaj API dhe tashmë po tërhiqni të dhëna nga AutoScout24. Mbulim i plotë i API-së në çdo gjuhë të mbështetur.

PHP Node.js Python Go C#Java Ruby Rust

API për makina nga Evropa

Merrni qasje në të dhënat e platformës evropiane të makinave përmes API-së sonë. Të dhëna automjetesh, të pastra dhe të strukturuara, që jepen përmes endpoint-eve të thjeshta. Përshtaten shumë mirë për analitikë, vlerësim tregu dhe vendime blerjeje.

API

AutoScout24 API jep shpalljet e reja të automjeteve në çastin kur shfaqen.

Eksportime ditore

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

Të dhëna të plota

Merrni qasje në të gjitha të dhënat nga AutoScout24: çmimi, kilometrazhi, viti, marka, modeli, specifikimet teknike, pajisjet, raportet e gjendjes dhe historiku i automjetit.

Merrni qasje në APIQasja jepet brenda 2 minutash

Llojet e automjeteve që mbulon AutoScout24 API

Nuk mbledhim vetëm autovetura. API-ja dhe eksportimet ditore përmbajnë shpallje nga çdo seksion i AutoScout24, përfshirë motoçikleta, kamperë dhe automjete komerciale.

Makina dhe automjete personale

Autovetura
Motoçikleta dhe skuterë
Kamperë dhe rulota

Automjete komerciale

Kamionë dhe furgonë
Rimorkio

API

URL bazë

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

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

Konfigurimi i integrimit tuaj:

1. Së pari përdorni /offers për të shkarkuar të gjithë katalogun - kaloni nëpër të gjitha faqet për të mbushur bazën tuaj të të dhënave

2. Më pas thirrni periodikisht /changes për të zbuluar rekordet e reja, ndryshimet dhe shpalljet e hequra, për përditësime delta

3. Për funksionin e kërkimit, shfrytëzoni metodën /offers me parametra filtrimi dhe faqosjeje (marka, modeli, çmimi, viti, shteti)

GET/filters

Kthen të gjitha vlerat e mundshme për filtrim

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

Përgjigjja:

{
  "mark": {
    "BMW": {
      "model": {
        "3 Series": {
          "configuration": {
            "320d": { "complectation": ["Sport Line", "Luxury Line", "M Sport"] }
          }
        }
      }
    },
    "Mercedes-Benz": {
      "model": {
        "C-Class": {
          "configuration": {
            "C200": { "complectation": ["Avantgarde", "AMG Line"] }
          }
        }
      }
    }
  },
  "transmission_type": ["MT", "AT"],
  "color": ["Champagne", "Black", "Purple", "Silver", "Red", "Gray", "Blue", "White", "Green", "Yellow"],
  "body_type": ["Pick Up", "Sedan", "Sports Car", "Crossover", "Bus", "Hatchback", "Station Wagon", "Convertible", "SUV", "Truck"],
  "engine_type": ["PHEV", "Diesel", "BEV", "Gasoline", "HEV", "REEV"]
}

GET/offers

Lista e shpalljeve me faqosje dhe filtra

Parametrat:

page (i detyrueshëm) - numri i faqes
mark, model - 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ë EUR)
seller_votes_count_from - numri minimal i komenteve për tregtarin
seller_total_score_from - nota minimale e tregtarit (nga 5 të mundshme)

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

Përgjigjja:

{
  "result": [
    {
      "id": 4695867,
      "inner_id": "2aa0d910-4b72-4c69-9638-79ac5c58549e",
      "change_type": "added",
      "created_at": "2025-05-27T00:23:45.196Z",
      "data": {
        "id": 4695867,
        "inner_id": "2aa0d910-4b72-4c69-9638-79ac5c58549e",
        "url": "https://www.autoscout24.com/offers/toyota-yaris-...",
        "mark": "Toyota",
        "model": "Yaris",
        "configuration": "1.4 D-4D",
        "complectation": "Sol",
        "year": 2006,
        "color": "Black",
        "price_eur": 3490,
        "km_age": 240000,
        "engine_type": "Diesel",
        "transmission_type": "MT",
        "body_type": "Hatchback",
        "address": "Roma - Rm",
        "seller_type": "dealer",
        "is_dealer": true,
        "section": "used",
        "seller": "Spazio Auto Srl",
        "seller_id": "17358964",
        "description": "Toyota Yaris in excellent condition...",
        "displacement": 1.4,
        "horse_power": 90,
        "offer_created": "2025-05-27",
        "doors_count": 5,
        "num_seats": 5,
        "first_registration": "12/2006",
        "images": ["https://prod.pictures.autoscout24.net/..."],
        "seller_phones": ["+390624416455"],
        "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_eur - çmimi në EUR (bruto)
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)
seller - shitësi
seller_id - ID-ja e tregtarit
description - përshkrimi
displacement - vëllimi i motorit (L)
horse_power - fuqia në hp
first_registration - data e regjistrimit të parë
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/autoscout/change_id?api_key=YOUR_API_KEY&date=2025-01-15

Përgjigjja:

{ "change_id": 9182734 }

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

Përgjigjja:

{
  "result": [
    {
      "id": 456,
      "inner_id": "2aa0d910-4b72-4c69-9638-79ac5c58549e",
      "change_type": "added",    // added - new listing
      "created_at": "2025-01-15T10:30:00Z",
      "data": { ... }            // full listing data
    },
    {
      "id": 457,
      "inner_id": "2aa0d910-4b72-4c69-9638-79ac5c58549f",
      "change_type": "changed",  // changed - price update
      "created_at": "2025-01-15T10:31:00Z",
      "data": { "new_price": 3490 }
    },
    {
      "id": 458,
      "inner_id": "2aa0d910-4b72-4c69-9638-79ac5c58549g",
      "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/autoscout/offer?api_key=YOUR_API_KEY&inner_id=2aa0d910-4b72-4c69-9638-79ac5c58549e

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

Eksportime ditore

Politika për ruajtjen e të dhënave

Skedarët e eksportimit ruhen të paktën 3 ditë, me arkivim automatik të kopjeve rezervë.

Orari i API-së

Eksportime ditore të të dhënave me përmbajtje aktuale, gati për shkarkim.

Formati i skedarëve CSV

Skedarët CSV me të dhëna automobilistike përdorin vijën vertikale (|) për ndarjen e kolonave.

Formati i URL-së:

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

Parametrat e kërkesës:

access_name - identifikuesi unik 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ën e tij.

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'

AutoScout24.com

AutoScout24 është platforma kryesuese online e makinave në Evropë dhe vepron në 18 shtete që nga viti 1998. Me mbi 2 milionë shpallje aktive, është një burim parësor për të dhëna automobilistike nga Evropa. AutoScout24 API jep qasje të drejtpërdrejtë në këto të dhëna, duke eliminuar nevojën për parser apo scraper të ndërlikuar.

Çdo shpallje në AutoScout24 përfshin specifikimet teknike, historikun e servisit dhe raportet e inspektimit. API-ja i jep këto të dhëna në një format të strukturuar, gati për përdorim.

AutoScout24 API jep qasje në të dhëna të tregut, përfshirë dallimet rajonale të çmimeve, tendencat sezonale dhe ndryshimet në disponueshmërinë e automjeteve. Merrni specifikime automjetesh, opsione të prodhuesit dhe të dhëna financiare për analizë tregu.

AutoScout24 API punon në kohë reale dhe i zbulon shpalljet e reja brenda 60 sekondash. Ndiqni kur shiten makinat, për të parë çmimet reale. Merrni qasje në këto të dhëna të tregut përmes API-së, pa mbledhje manuale të të dhënave.

Të dhëna të tjera automobilistike

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

🇰🇷

Encar API

API për makina në Kore

🇰🇷

KB Chachacha API

API për makina në Kore

🇰🇷

K Car API

API për makina në Kore

🇨🇳