AUTO-API.COM
Logoja e IAAI

IAAI APIScraper & Parser

IAAI API: lote ankandesh sigurimi në SHBA e Kanada me Buy Now, ACV, vlerësim riparimi, dëmtime, certifikatë pronësie, datë ankandi. Fluks ndryshimesh, skedarë.

Biblioteka zyrtare SDK

SDK-të tona i përmbajnë metodat e API-së si funksione të gatshme, dhe bibliotekat janë me kod të hapur në GitHub.

IAAI API

Parser-i mbledh lote nga IAAI, ankandet e sigurimeve në SHBA dhe Kanada, përfshirë autovetura, SUV, pikapë dhe furgonë. Me API-në mund t'i filtroni lotet sipas kërkesave të një blerësi dhe t'i ndiqni përmes fluksit të ndryshimeve derisa të hiqen nga shitja. Nuk ju duhet të shkruani dhe të mirëmbani një scraper të juajin për iaai.com.

API

Fluksi /changes kthen ngjarje për lotet e IAAI: lot i ri, çmim i ri Buy Now, heqje nga shitja.

Eksportime ditore

Eksportimi ditor nga IAAI përmban lotet që janë në shitje në datën e eksportimit.

Të dhëna të plota

Kilometrazhi dhe statusi i odometrit, motori dhe fuqia, dëmtimet, arsyeja e shitjes, lloji i certifikatës së pronësisë, çelësat dhe jastëkët e ajrit, data e shitjes dhe dega, blerësit e lejuar, fotot dhe videoja e motorit.

Merrni qasje në APIQasja jepet brenda 2 minutash

Një lot ka dy numra: inner_id, me të cilin e kërkoni lotin te /offer, dhe stock_number, numri me të cilin e njohin blerësit në ankandet e IAAI.

URL bazë

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

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 lotet faqe pas faqeje
3
/changes?change_id=...merrni të gjitha ndryshimet në bazën e të dhënave duke filluar nga ID-ja
4
/offernjë lot i vetëm sipas inner_id

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ë lotet e reja, çmimet e reja Buy Now dhe heqjet e loteve 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. 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-11-12T14:30:00Z".
  • Çmimi, ACV dhe vlerësimi i riparimit janë në monedhën e lotit: USD për lotet në SHBA, CAD për lotet në Kanada.
  • Çdo lot ka të njëjtin grup fushash. Një vlerë që mungon është null, për shembull auction_at derisa IAAI të caktojë datën e shitjes. Përjashtim bën photos: për një lot pa foto, kjo fushë është varg bosh.

GET/filters

Kthen të gjitha vlerat e mundshme për filtrim

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

Përgjigjja:

{
  "mark": {
    "CHEVROLET": { "model": [..., "TAHOE", "TAHOE HYBRID", "TAHOE K1500", "TRACKER", "TRAILBLAZER", ...] },
    "FORD": { "model": [..., "EXPEDITION", "EXPEDITION EL", "EXPEDITION MAX", "EXPLORER", "EXPLORER SPORT", ...] },
    "TOYOTA": { "model": [..., "RAV4 HYBRID", "RAV4 PLUG-IN HYBRID", "RAV4 PRIME", "RAV4 SE HYBRID", ...] },
    ...
  },
  "transmission_type": ["Automatic", "CVT", "Manual"],
  "color": ["Beige", "Black", "Blue", "Brown", ...],
  "body_type": [..., "Passenger van", "Pickup", "QUATTRO COUPE", "Roadster", ...],
  "engine_type": ["Diesel", "Electric", "Flex fuel", "Gasoline", "Hybrid", "Other"],
  "drive_type": ["4WD", "4x2", "AWD", ..., "FWD", ..., "RWD"]
}

GET/offers

Lotet faqe pas faqeje. Filtrat i ngushtojnë rezultatet.

Parametrat:

  • page (i detyrueshëm) - numri i faqes
  • mark, model - marka dhe modeli, siç shkruhen në /filters, pa dallim midis shkronjave të mëdha dhe të vogla
  • transmission_type, color, body_type, engine_type, drive_type - transmisioni, ngjyra, karroceria, karburanti dhe tërheqja, me vlerat nga /filters, pa dallim midis shkronjave të mëdha dhe të vogla
  • 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 Buy Now, nga dhe deri, në monedhën e lotit. Lotet pa Buy Now nuk përputhen me këta filtra

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

https://{access_name}.auto-api.com/api/v3/iaai/offers?api_key=YOUR_API_KEY&page=1https://{access_name}.auto-api.com/api/v3/iaai/offers?api_key=YOUR_API_KEY&page=1&mark=CHEVROLET&model=TAHOE&year_from=2020https://{access_name}.auto-api.com/api/v3/iaai/offers?api_key=YOUR_API_KEY&page=1&body_type=Pickup&price_to=15000

Përgjigjja:

{
  "result": [
    {
      "id": 61842,
      "inner_id": "43963919~US",
      "change_type": "added",
      "created_at": "2026-10-25T05:41:52Z",
      "data": {
        "id": 61842,
        "inner_id": "43963919~US",
        "stock_number": "43468982",
        "url": "https://www.iaai.com/VehicleDetail/43963919~US",
        "mark": "CHEVROLET",
        "model": "TAHOE",
        "complectation": "2WD LT",
        "year": 2021,
        "first_registration": null,
        "km_age": 187368,
        "odometer": 116425,
        "odometer_unit": "mi",
        "odometer_status": "Not actual",
        "owners_count": null,
        "price": 14000,
        "currency": "USD",
        "acv": 38323,
        "repair_cost": 25348,
        "engine_type": "Gasoline",
        "transmission_type": "Automatic",
        "body_type": "SUV",
        "drive_type": "4x2",
        "color": "Gray",
        "interior_color": null,
        "displacement": 5.3,
        "displacement_cc": 5300,
        "engine": "5.3L V-8 DI, VVT, 355HP",
        "cylinders": 8,
        "power": 355,
        "power_ice_hp": 355,
        "power_electro_kw": null,
        "seat_count": null,
        "section": "Used",
        "seller_type": null,
        "is_dealer": null,
        "salon_id": null,
        "seller_category": "Insurance company",
        "region": "Georgia",
        "city": "Winder",
        "address": "1045 Atlanta Hwy SE",
        "zip": "30680",
        "latitude": 33.97598,
        "longitude": -83.6573,
        "description": null,
        "created_at": "2026-10-25T05:41:52Z",
        "offer_created": "2026-10-25T05:33:28Z",
        "photos": [
"https://vis.iaai.com/resizer?imageKeys=43963919~SID~B707~S0~I1~RW2576~H1932~TH0&width=2576&height=1932",
"https://vis.iaai.com/resizer?imageKeys=43963919~SID~B707~S0~I2~RW2576~H1932~TH0&width=2576&height=1932",
"https://vis.iaai.com/resizer?imageKeys=43963919~SID~B707~S0~I3~RW2576~H1932~TH0&width=2576&height=1932",
"https://vis.iaai.com/resizer?imageKeys=43963919~SID~B707~S0~I4~RW2576~H1932~TH0&width=2576&height=1932",
          ...
        ],
"photo_360_url": "https://vis.iaai.com/Home/ThreeSixtyView?keys=SID-43963919~STP-1~INT-1&iframeview=true",
"engine_video_url": "https://mediastorageaccountprod.blob.core.windows.net/media/43963919_VES-100_1",
        "vin": "1GNSCNKD0MR******",
        "auction_at": "2026-11-12T14:30:00Z",
        "auction_type": "Live auction",
        "timed_auction_close_at": null,
        "branch": "Atlanta East",
        "branch_id": "707",
        "lane": "D",
        "run_number": 153,
        "country": "USA",
        "primary_damage": "Right rear",
        "secondary_damage": "Rear",
        "loss_type": "Collision",
        "title_group": "Salvage",
        "title_state": "Georgia",
        "title_brand": null,
        "title_notes": null,
        "condition": "Run & drive",
        "has_keys": true,
        "airbags": "Intact",
        "catalytic_converter": true,
        "is_public": true,
        "who_can_buy": ["Dealers", "Dismantlers", "Exporters", "Other licensed businesses", "Non-auto licensed businesses", "Public", "Rebuilders", "Scrappers"],
        "vehicle_type": "SUV",
        "country_of_origin": "USA",
        "restraint_system": ["Driver front airbag", "Driver side airbag", "Curtain airbags", "Passenger front airbag", "Passenger side airbag", "Front center airbag"],
        "declarations": null,
        "original": {  // vlerat origjinale nga iaai.com
          "mark": "CHEVROLET",
          "model": "TAHOE",
          "complectation": "2WD LT",
          "engine_type": "GASOLINE",
          "transmission_type": "AUTOMATIC",
          "body_type": "UTILITY",
          "drive_type": "4X2 DRIVE",
          "color": "GRAY",
          "interior_color": null,
          "primary_damage": "Right Rear",
          "secondary_damage": "Rear",
          "loss_type": "Collision",
          "title_group": "Salvage",
          "condition": "Run & Drive",
          "region": "GA"
        },
        "catalog_ids": {
          "mark": null,
          "model": null,
          "complectation": null
        },
        "options": {
          "Equipment": ["Console display"]
        }
      }
    }
    // ... pastaj lotet e tjera, deri në 20 për faqe
  ],
  "meta": {
    "page": 1,
    "next_page": 2,
    "limit": 20
  }
}

Fushat e të dhënave:

Loti

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

inner_id - ID-ja e lotit nga lidhja në IAAI, me tregun pas tildës: "43963919~US", ose si "Imp_3139055~CA" për lotet kanadeze. Këtë ID e pranon /offer.

stock_number - Stock#, numri i lotit që IAAI e tregon në faqen e vet të internetit dhe në ankand.

url - Lidhja e lotit.

price, currency - Çmimi Buy Now dhe monedha, USD ose CAD. Nëse loti nuk ka çmim Buy Now, price është null.

acv - ACV, vlera e vlerësuar e makinës para dëmtimit.

repair_cost - Kostoja e vlerësuar e riparimit.

section - Gjithmonë "Used".

description - Përshkrimi i shitësit. Lotet e IAAI nuk e kanë, prandaj është gjithmonë null.

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

offer_created - Koha kur loti u nxor në shitje, siç e jep IAAI. IAAI e përditëson, për shembull kur loti ripublikohet ose kur shitja zhvendoset në një datë tjetër, prandaj mund të jetë më vonë se created_at.

Makina

mark, model - Marka dhe modeli, siç i shkruan IAAI: "CHEVROLET", "TAHOE".

complectation - Varianti, për shembull "2WD LT".

year - Viti i modelit.

first_registration - Regjistrimi i parë. IAAI nuk e publikon, prandaj është gjithmonë null.

vin - VIN, siç e tregon IAAI: 11 karakteret e para, ndërsa pjesa tjetër është e fshehur me yje.

km_age - Kilometrazhi në km. Nëse në vend të kilometrazhit IAAI jep 0 ose 1 (odometri nuk lexohet, nuk punon ose kilometrazhi është i përjashtuar nga deklarimi), vlera është null.

odometer, odometer_unit - Leximi i odometrit, siç është në IAAI, dhe njësia e tij: "mi" (milje) ose "km".

odometer_status - Statusi i odometrit, për shembull "Actual", "Not actual", "Exceeds mechanical limits" ose "Exempt" (makinat më të vjetra janë të përjashtuara nga deklarimi i kilometrazhit).

owners_count - Numri i pronarëve. IAAI nuk e publikon, prandaj është gjithmonë null.

vehicle_type - Lloji i automjetit sipas klasifikimit të IAAI, për shembull "Automobile", "Light truck" ose "Classic car". Lloji i karrocerisë vjen në body_type.

country_of_origin - Shteti i montimit.

Specifikimet

engine_type - Karburanti: "Gasoline", "Diesel", "Hybrid", "Electric", "Flex fuel" ose "Other".

transmission_type - "Automatic", "Manual" ose "CVT".

body_type - Lloji i karrocerisë, për shembull "SUV" ose "Pickup". Emërtimi i karrocerisë, siç e shkruan IAAI, është në original.body_type.

drive_type - Tërheqja: "FWD", "RWD", "AWD" ose "4WD". "4x2" do të thotë se IAAI nuk ka treguar cili bosht është tërheqës.

color, interior_color - Ngjyra e karrocerisë dhe ngjyra e brendësisë.

displacement, displacement_cc - Vëllimi i motorit në litra, siç e jep IAAI, dhe i njëjti vëllim në cc (5.3 l janë 5300).

engine - Motori, siç e përshkruan IAAI, për shembull "5.3L V-8 DI, VVT, 355HP".

cylinders - Numri i cilindrave.

power - Fuqia në hp. Për makinat hibride dhe elektrike është null: IAAI nuk e publikon fuqinë totale të sistemit.

power_ice_hp - Fuqia e motorit me djegie të brendshme në hp. Për makinat hibride plotësohet edhe kur power është null.

power_electro_kw, seat_count - Fuqia e motorit elektrik dhe numri i vendeve. IAAI nuk i publikon, prandaj janë gjithmonë null.

Dëmtimet dhe certifikata e pronësisë

primary_damage, secondary_damage - Dëmtimi kryesor dhe dëmtimi dytësor, për shembull "Front end", "Left side", "Flood" ose "Hail".

loss_type - Arsyeja pse makina u dërgua në ankand: "Collision", "Theft", "Flood", "Fire" ose "Other".

condition - Statusi i ndezjes: "Run & drive", "Starts", "Stationary" ose "Can't test".

has_keys - Nëse çelësat e makinës janë të pranishëm (true/false).

airbags - Gjendja e jastëkëve të ajrit, për shembull "Intact", "Deployed" ose "Missing".

restraint_system - Jastëkët e ajrit dhe rripat e sigurimit që ka makina.

catalytic_converter - Katalizatori është në vend (true) ose është hequr (false).

title_group - Lloji i certifikatës së pronësisë: "Clear", "Salvage", "Non-repairable" e të tjera. Për lotet kanadeze vjen siç e shkruan IAAI, për shembull "ON-NOT BRANDED-ONTARIO". Derisa certifikata e pronësisë të arrijë te IAAI, vlera është null.

title_state - Shteti ose provinca që ka lëshuar certifikatën e pronësisë.

title_brand, title_notes - Shënimi i statusit në certifikatën e pronësisë dhe vërejtjet, siç i shkruan IAAI, për shembull "PREVIOUS SALVAGE".

declarations - Deklaratat e shitësit për lotet kanadeze, teksti siç e shkruan IAAI, për shembull "TKU" (kilometrazhi i vërtetë nuk dihet) ose një referencë te raporti CARFAX.

Shitja, shitësi dhe vendndodhja

auction_at - Fillimi i ankandit të drejtpërdrejtë. Derisa IAAI të caktojë datën, vlera është null. Caktimi ose zhvendosja e datës së shitjes nuk krijon ngjarje në /changes. /offer dhe /offers kthejnë datën dhe orën më të fundit të planifikuar të ankandit.

auction_type - "Live auction" ose "Timed auction".

timed_auction_close_at - Mbyllja e ankandit me afat kohor.

branch, branch_id - Dega e IAAI ku shitet loti dhe numri i degës.

lane, run_number - Korsia e ankandit dhe numri i radhës së lotit në të. IAAI i cakton pak para shitjes, deri atëherë janë null. Ashtu si data e shitjes, ato nuk vijnë si ngjarje të veçanta në /changes.

is_public - true nëse loti është i hapur për blerës privatë (shënimi Public). Kush tjetër mund ta blejë lotin renditet në who_can_buy.

who_can_buy - Kush mund ta blejë lotin: "Dealers", "Dismantlers", "Exporters", "Public" e të tjerë. IAAI e plotëson listën më afër shitjes, deri atëherë vlera është null.

seller_category - Nga erdhi makina në ankand: "Insurance company", "Remarketing", "Lease and rental", "Repossession" e të tjera.

seller_type, is_dealer, salon_id - Shitësi. IAAI nuk e tregon, prandaj këto fusha janë gjithmonë null.

country - "USA" ose "Canada".

region, city - Shteti ose provinca dhe qyteti ku ndodhet makina.

address, zip - Adresa dhe kodi ZIP ose kodi postar i të njëjtit vend.

latitude, longitude - Koordinatat e të njëjtit vend. Për lotet kanadeze janë null.

Fotot, videot dhe të dhënat referuese

photos - Lidhjet e fotove në madhësi të plotë. Varg bosh për një lot pa foto.

photo_360_url - Lidhja e pamjes 360 në faqen e internetit të IAAI.

engine_video_url - Lidhja e videos së motorit në punë.

options - Pajisjet, siç i rendit IAAI, në një grup të vetëm "Equipment".

original - Vlerat origjinale të fushave kryesore nga iaai.com, pa përkthim.

catalog_ids - Kodet e katalogut. IAAI nuk i publikon, prandaj vlerat janë gjithmonë null.

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/iaai/change_id?api_key=YOUR_API_KEY&date=2026-11-10

Përgjigjja:

{
  "change_id": 208400
}

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

Përgjigjja:

{
  "result": [
    {
      "id": 208412,
      "inner_id": "46237543~US",
      "change_type": "changed",
      "created_at": "2026-11-10T03:12:40Z",
      "data": {  // çmimi i ri Buy Now në monedhën e lotit (null nëse Buy Now është hequr)
        "new_price": 28225
      }
    },
    {
      "id": 208413,
      "inner_id": "47020463~US",
      "change_type": "added",
      "created_at": "2026-11-10T03:12:41Z",
      "data": { ... }  // trupi i plotë i lotit, si në /offers
    },
    {
      "id": 208414,
      "inner_id": "46769371~US",
      "change_type": "removed",
      "created_at": "2026-11-10T03:12:43Z",
      "data": {}  // loti u hoq nga shitja
    }
    // ... pastaj ngjarjet e tjera, deri në 20 për faqe
  ],
  "meta": {
    "cur_change_id": 208412,
    "next_change_id": 208432,
    "limit": 20
  }
}

GET/offer

Një lot i vetëm sipas inner_id.

Parametrat:

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

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

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 lot me këtë inner_id (/offer)
  • 429 - limiti i kërkesave është shteruar

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ë:

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

Parametrat:

  • access_name - nëndomeni juaj personal
  • date - data e eksportimit në formatin yyyy-mm-dd, p.sh. 2026-11-10
  • file_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.csv

Shembull komande me Wget

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

IAAI (iaai.com) është faqja e internetit e Insurance Auto Auctions (IAA). Që nga viti 2023, kompania është pjesë e RB Global. Në SHBA dhe Kanada, makinat dërgohen në ankand nga kompanitë e sigurimit pas një aksidenti, përmbytjeje, zjarri ose vjedhjeje, si dhe nga bankat, tregtarët, kompanitë e lizingut dhe ato të makinave me qira.

Një lot shitet në një ankand të drejtpërdrejtë në një ditë të caktuar ose në një ankand me afat kohor, dhe disa lote mund të blihen para ankandit me një çmim Buy Now. Disa lote u shiten vetëm blerësve me licencë, si tregtarët, çmontuesit e makinave dhe eksportuesit, ndërsa lotet me shënimin Public janë të hapura edhe për blerës privatë. IAAI nuk i publikon as ofertat, as çmimet e shitjes.

Një importues mund të shohë te loti nëse eksportuesit lejohen ta blejnë. Me vitin e modelit, vëllimin dhe fuqinë e motorit mund të përllogaritni detyrimet doganore, ndërsa me 11 karakteret e para të VIN-it mund të kontrolloni modelin dhe fabrikën.

Lotet e reja, çmimet e reja Buy Now dhe heqjet nga shitja vijnë përmes /changes. Heqja nga shitja nuk do të thotë gjithmonë që loti është shitur.

Përgjigje brenda 2 min