API žinynas / Paieška

Gauti automobilį pagal loto numerį

GET/search-lot/{lot}/{domain}

Gaukite automobilį ir jo aukciono įrašus pagal Copart ar IAAI loto numerį. Ieškoma aktyviuose ir archyviniuose skelbimuose.

Perduokite šaltinio loto numerį iš lots[].lot kaip {lot} ir copart_com arba iaai_com kaip {domain}. Loto numeris yra šaltinio identifikatorius, skirtingas nuo data.id ir lots[].id.
Šaltinio išoriniam automobilio ID, pvz., IAAI ID iš skelbimo URL, nustatykite search_by_id=1 ir perduokite tą ID kaip {lot}. Skaitiniai išoriniai ID tikrinami pagal pradžią; neskaitiniai turi sutapti tiksliai.
Grąžina HTTP 400 netinkamam loto formatui, HTTP 401 jūsų paskyrai neprieinamam šaltiniui ir HTTP 404, kai niekas neatitinka.

Pakeiskite reikšmes žemiau
Užklausa dešinėje atsinaujinaUžklausa viršuje atsinaujina
Vykdykite ją gyvai su savo raktu

Kelio parametrai

lotstring · privalomas

Šaltinio loto numeris: skaitmenys, pabaigoje gali būti raidė. Šaltinio išorinį ID naudokite tik su search_by_id=1. Tai nėra vidinis įrašo ID.

domainstring · privalomas

Šaltinio platforma: copart_com – Copart, iaai_com – IAAI.

Užklausos parametrai 2

prices_historyinteger · 0–1

Nustatykite 1, kad kiekvienam lotui būtų įtrauktas kainų istorijos masyvas. Praleiskite arba naudokite 0 standartiniam atsakymui.

search_by_idinteger · 0–1

Nustatykite 1, kad {lot} būtų laikomas external_id (pvz., IAAI automobilio ID jo URL). Skaitiniai išoriniai ID tikrinami pagal pradžią; neskaitiniai – tiksliai.

GET /search-lot/{lot}/{domain}

curl --get 'https://auctionsapi.com/api/search-lot/86246665/copart_com' \  --header 'x-api-key: YOUR_API_KEY'

200

pavyzdiniai duomenys

{  "data": {    "id": 16070300,    "year": 2023,    "title": "2023 BMW M8",    "vin": "WBSAE0C06PCL70372",    "manufacturer": {      "id": 16,      "name": "BMW"    },    "model": {      "id": 3038,      "name": "M8",      "manufacturer_id": 16    },    "generation": {      "id": 900001,      "name": "I (F92) LCI",      "manufacturer_id": 16,      "model_id": 3038    },    "body_type": {      "name": "coupe",      "id": 3    },    "color": {      "name": "green",      "id": 4    },    "engine": {      "id": 39,      "name": "4.4l 8"    },    "transmission": {      "name": "automatic",      "id": 1    },    "drive_wheel": {      "name": "all",      "id": 3    },    "vehicle_type": {      "name": "automobile",      "id": 1    },    "fuel": {      "name": "gasoline",      "id": 4    },    "cylinders": 8,    "lots": [      {        "id": 16447827,        "lot": "94166665",        "domain": {          "name": "copart_com",          "id": 3        },        "external_id": null,        "odometer": {          "km": 28218,          "mi": 17534,          "status": {            "name": "actual",            "id": 1          }        },        "estimate_repair_price": null,        "pre_accident_price": 88591,        "clean_wholesale_price": 97575,        "actual_cash_value": null,        "sale_date": "2026-03-25T15:55:05.000000Z",        "sale_date_updated_at": "2026-03-26T15:56:32.000000Z",        "bid": 56500,        "bid_updated_at": "2026-03-25T14:01:44.000000Z",        "buy_now": 0,        "buy_now_updated_at": "2026-03-01T23:14:06.000000Z",        "final_bid": 56500,        "final_bid_updated_at": "2026-03-15T03:12:52.000000Z",        "status": {          "name": "sold",          "id": 6        },        "seller": null,        "seller_type": null,        "title": {          "id": 4235,          "code": null,          "name": "Ct - Clean Title"        },        "detailed_title": {          "id": 1582,          "code": null,          "name": "Mi - Certificate Of Title"        },        "note": null,        "damage": {          "main": {            "id": 37,            "name": "Side"          },          "second": {            "id": 3,            "name": "Front End"          }        },        "keys_available": true,        "airbags": null,        "condition": {          "name": "run_and_drives",          "id": 0        },        "grade_iaai": null,        "images": {          "id": 19358054,          "small": [            "https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/1225/b1f12fe1dcf2485190eb28e2f104d11c_thb.jpg",            "https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/1225/89c8fb28463844338e402c0b27b35259_thb.jpg"          ],          "normal": [            "https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/1225/b1f12fe1dcf2485190eb28e2f104d11c_hrs.jpg",            "https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/1225/89c8fb28463844338e402c0b27b35259_hrs.jpg"          ],          "big": [            "https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/1225/b1f12fe1dcf2485190eb28e2f104d11c_hrs.jpg",            "https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/1225/89c8fb28463844338e402c0b27b35259_hrs.jpg"          ],          "exterior": null,          "interior": null,          "video": "https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/1225/986c53a65f76451ab653fc6492983720_O.mp4",          "video_youtube_id": null,          "external_panorama_url": null,          "downloaded": [            "https://cars2.import-motor.com/copart/bmw/m8/2023/94166665/WBSAE0C06PCL70372-1.webp",            "https://cars2.import-motor.com/copart/bmw/m8/2023/94166665/WBSAE0C06PCL70372-2.webp"          ]        },        "location": {          "country": {            "iso": "us",            "name": "USA"          },          "state": {            "id": 82,            "code": "mi",            "name": "michigan"          },          "city": {            "id": 75,            "name": "davison"          },          "location": {            "id": 88,            "name": "mi - flint"          },          "latitude": 43.07812,          "longitude": -83.51813,          "postal_code": "48423 8502",          "is_offsite": null,          "raw": "mi - flint",          "offsite": null        },        "tags": [          "CERT-D",          "IV"        ],        "line": "A/92",        "selling_branch": {          "name": "mi - flint",          "link": null,          "number": null,          "id": 540618,          "domain_id": 3        },        "created_at": "2025-12-01T16:11:02.000000Z",        "updated_at": "2026-03-26T18:07:05.000000Z",        "details": null,        "is_timed_auction": false,        "seller_reserve": {          "price": 55000,          "updated_at": "2026-03-24T10:30:00.000000Z"        },        "auction_type": {          "name": "pure_sale",          "id": 1        },        "archived": true,        "archived_at": "2026-03-26T18:01:13.000000Z",        "prices": [          {            "id": 9746422,            "lot_id": 16447827,            "bid": 51000,            "final_bid_updated_at": "2026-03-13T18:20:35.000000Z",            "buy_now_price": null,            "sale_date": "2026-03-11T14:00:00.000000Z",            "status": {              "name": "not_sold",              "id": 8            }          }        ]      }    ]  }}