Lidh çelësin
GET/searchAutomjete

Kërkoni automjete

Filtroni automjetet aktive në burimet tuaja të aktivizuara. Rezultatet janë të lehta: çdo makinë mban flamuj raportesh, jo trupat e raporteve.

  • vehicle_type=automobile / 1 është parazgjedhja; motorcycle / 2 zgjedh motoçikleta në /search, /search/count dhe /cars. Përdorni të njëjtin lloj në fjalorë.
  • Hierarki e plotë: brands[] → models[] → generations[] → variants[] / trims[]. Çdo objekt marke, modeli dhe gjenerate kërkon id. OSE midis fqinjëve dhe vlerave variants/trims; DHE midis kushteve brenda një dege. Lista e munguar ose bosh nënkupton të gjithë pasardhësit. Deri në 100 elemente për listë. ID të panjohura ose të papajtueshme japin rezultat bosh; format i pavlefshëm — 422.
  • brands[0][models][]=573 ekzistues funksionon. Për pasardhës përdorni brands[0][models][0][id]=573. Pastroni fushën e vjetër të ID para objekteve të modeleve për atë markë, përndryshe PHP mbishkruan indeksin 0.
  • is_auction pranon true/false/1/0. False përfshin false, null dhe flamurin e munguar; pa parametër nuk ka filtër. Duhet të përputhet me is_leasing në të njëjtin njoftim aktiv të domenit të lejuar; njoftime të tjera mund të mbeten në listings[].
  • perPage është 2–50 (parazgjedhja 50). perPage=1 kthen 422.
  • Mbajeni page × perPage deri në 10,000. Për të lexuar më tej, përdorni /cars.
  • data mund të përmbajë perPage + 1 makina, dhe meta.total ndalet te 10,000. Përdorni /search/count për totale të sakta.
  • sort=auction_nearest zgjedh ankande të ardhshme: auction_at >= now në një njoftim aktiv të domenit të zgjedhur. Dërgoni të njëjtin sort te /search/count.
  • Renditjet sipas çmimit (cheaper, expensive) i krahasojnë çmimet në currency.
  • Përdorni price për Buy Now, current_bid për ofertën aktuale dhe /listing-fields për shumat shtesë të lejuara. Krahasimet monetare kërkojnë monedhën origjinale brenda çdo kushti custom-field; shumat e burimit nuk konvertohen.

Parametrat e query-t

48
Query, faqosja dhe shtrirja
vinstring1–19 chars

VIN i pjesshëm, pa dallim shkronjash të mëdha/të vogla. Për një VIN të saktë me 16–19 karaktere, përdorni /cars/vin/{vin}.

pageinteger≥ 1 · default 1

Numri i faqes. Për /search, kaloni perPage në mënyrë eksplicite dhe mbajeni page × perPage ≤ 10000. /search/count e injoron faqosjen dhe e anashkalon këtë kontroll të zhvendosjes.

perPageinteger2–50 · default 50

Madhësia e faqes së kërkimit: minimumi 2, maksimumi 50. perPage=1 kthen 422; përdorni perPage=2 për të marrë një mostër të vogël. Vlerat e faqosjes që mungojnë ose janë null përdorin page=1 dhe perPage=50, përfshirë kontrollin e dritares së rezultateve të kërkimit. Vlerat e pavlefshme kthejnë 422.

sortstring

Sort order. Price sorting requires a resolved currency. auction_nearest selects only cars with an active listing in an enabled/selected domain with auction_at >= now; past dates do not participate in sorting. Pass the same sort to /search/count for a matching count.

currencystring3 chars · default usd

Kodi i monedhës, pa dallim shkronjash të mëdha/të vogla, për filtrimin/renditjen sipas çmimit. Duhet të ekzistojë në fjalorin e monedhave. Nuk i konverton çmimet e serializuara të shpalljeve.

currency_idinteger≥ 1

ID e brendshme opsionale e monedhës; ka përparësi ndaj currency.

domains[]integer[]≥ 1

Shtrirje opsionale e burimeve. Përdorni ID-të e kthyera nga GET /domains. Hiqeni për të përdorur të gjitha domenet e aktivizuara. Përsëritni parametrin me kllapa: domains[]=33&domains[]=34. Çdo ID duhet të jetë e aktivizuar për këtë çelës.

vehicle_typestringdefault automobile

vehicle_type=automobile / 1 është parazgjedhja; motorcycle / 2 zgjedh motoçikleta në /search, /search/count dhe /cars. Përdorni të njëjtin lloj në fjalorë.

langstring

Gjuha e përgjigjes. Përkthimet e opsioneve kufizohen gjithashtu nga gjuhët e llogarisë. Faqja e zgjedh automatikisht gjuhën e saj aktuale.

Marka, modeli dhe vendndodhja
brands[0][id]integer≥ 1

Hierarki e plotë: brands[] → models[] → generations[] → variants[] / trims[]. Çdo objekt marke, modeli dhe gjenerate kërkon id. OSE midis fqinjëve dhe vlerave variants/trims; DHE midis kushteve brenda një dege. Lista e munguar ose bosh nënkupton të gjithë pasardhësit. Deri në 100 elemente për listë. ID të panjohura ose të papajtueshme japin rezultat bosh; format i pavlefshëm — 422.

brands[0][models][]integer[]≥ 1 · ≤ 100 items

brands[0][models][]=573 ekzistues funksionon. Për pasardhës përdorni brands[0][models][0][id]=573. Pastroni fushën e vjetër të ID para objekteve të modeleve për atë markë, përndryshe PHP mbishkruan indeksin 0.

brands[0][models][0][id]integer≥ 1

Hierarki e plotë: brands[] → models[] → generations[] → variants[] / trims[]. Çdo objekt marke, modeli dhe gjenerate kërkon id. OSE midis fqinjëve dhe vlerave variants/trims; DHE midis kushteve brenda një dege. Lista e munguar ose bosh nënkupton të gjithë pasardhësit. Deri në 100 elemente për listë. ID të panjohura ose të papajtueshme japin rezultat bosh; format i pavlefshëm — 422.

brands[0][models][0][generations][0][id]integer≥ 1

Hierarki e plotë: brands[] → models[] → generations[] → variants[] / trims[]. Çdo objekt marke, modeli dhe gjenerate kërkon id. OSE midis fqinjëve dhe vlerave variants/trims; DHE midis kushteve brenda një dege. Lista e munguar ose bosh nënkupton të gjithë pasardhësit. Deri në 100 elemente për listë. ID të panjohura ose të papajtueshme japin rezultat bosh; format i pavlefshëm — 422.

brands[0][models][0][generations][0][variants][]integer[]≥ 1 · ≤ 100 items

Hierarki e plotë: brands[] → models[] → generations[] → variants[] / trims[]. Çdo objekt marke, modeli dhe gjenerate kërkon id. OSE midis fqinjëve dhe vlerave variants/trims; DHE midis kushteve brenda një dege. Lista e munguar ose bosh nënkupton të gjithë pasardhësit. Deri në 100 elemente për listë. ID të panjohura ose të papajtueshme japin rezultat bosh; format i pavlefshëm — 422.

brands[0][models][0][generations][0][trims][]integer[]≥ 1 · ≤ 100 items

Hierarki e plotë: brands[] → models[] → generations[] → variants[] / trims[]. Çdo objekt marke, modeli dhe gjenerate kërkon id. OSE midis fqinjëve dhe vlerave variants/trims; DHE midis kushteve brenda një dege. Lista e munguar ose bosh nënkupton të gjithë pasardhësit. Deri në 100 elemente për listë. ID të panjohura ose të papajtueshme japin rezultat bosh; format i pavlefshëm — 422.

countries[0][id]integer

ID e brendshme e shtetit të parë nga /countries. Shtetet shtesë përdorin countries[1][id], etj.

countries[0][regions][]integer[]

ID të brendshme opsionale rajonesh që i përkasin shtetit të parë.

Intervalet
seatsinteger1–200

Numri i saktë i vendeve.

price_fromint64≥ 0

Çmimi minimal i shpalljes në monedhën e zgjedhur. Maksimumi 9223372036854775807 (numër i plotë 64-bit me shenjë); vlerat përtej numrave të plotë të sigurt të JavaScript duhet të ruhen nga klientët si tekst dhjetor.

price_toint64≥ 1

Çmimi maksimal i shpalljes në monedhën e zgjedhur. Maksimumi 9223372036854775807 (numër i plotë 64-bit me shenjë); vlerat përtej numrave të plotë të sigurt të JavaScript duhet të ruhen nga klientët si tekst dhjetor.

year_frominteger1,800–3,000

Viti minimal i prodhimit.

year_tointeger1,800–3,000

Viti maksimal i prodhimit.

odometer_frominteger0–999,999,999

Kilometrazhi minimal në kilometra.

odometer_tointeger0–999,999,999

Kilometrazhi maksimal në kilometra.

engine_volume_frominteger0–999,999,999

Kilindrata minimale e motorit.

engine_volume_tointeger0–999,999,999

Kilindrata maksimale e motorit.

power_hp_frominteger0–100,000

Fuqia minimale në kuaj-fuqi.

power_hp_tointeger1–100,000

Fuqia maksimale në kuaj-fuqi.

Flamujt
is_leasingboolean

Filtër opsional i lizingut. Dërgoni true (ose 1) për shpalljet e shënuara shprehimisht is_leasing=true. Dërgoni false (ose 0) për të përjashtuar true, duke përfshirë false të ruajtur, null dhe fushat që mungojnë. Hiqeni për të mos filtruar sipas lizingut; vlerat bosh ose të pavlefshme kthejnë 422. Një makinë duhet të ketë të paktën një shpallje aktive që përputhet në shtrirjen e domeneve të aktivizuara/zgjedhura. Shpalljet e tjera mund të mbeten në përgjigje, prandaj makinat me lloje të përziera shpalljesh mund të përputhen me të dyja vlerat. Për /cars, vendoseni këtë në kërkesën e parë dhe ndiqni next_url të pandryshuar; false ruhet. Vazhdimi vetëm me scroll_id e ruan filtrin. Ndryshimi ose shtimi i filtrit gjatë scroll-it kthen 422. Nëse gjendja e filtrit në cache humbet ose scroll-i është më i vjetër se ky parametër, një vlerë eksplicite kthen 422; filloni një scroll të ri.

is_auctionboolean

Optional auction filter. Send true (or 1) for listings explicitly marked is_auction=true. Send false (or 0) to exclude true, including stored false, null and missing fields. Omit for no auction filter; empty or invalid values return 422. Combined is_auction and is_leasing must match the same listing. A car must have at least one matching active listing in the enabled/selected domain scope. Other listings can remain in the response, so cars with mixed listing types can match both values. For /cars, set this on the first request and follow next_url unchanged; false is preserved. Continuing with only scroll_id retains the filter. Changing or adding the filter mid-scroll returns 422. If cached filter state is lost or the scroll predates this parameter, an explicit value returns 422; start a new scroll.

keys_availableinteger

Shpallja ka çelësa. Dërgoni 1 (true) ose 0 (false). Hiqeni për cilëndo vlerë; vargjet "true"/"false" refuzohen.

is_manufacturer_certifiedinteger

Shpallja është e certifikuar nga prodhuesi ose nga programi zyrtar i shitësit. Dërgoni 1 (true) ose 0 (false). Hiqeni për cilëndo vlerë; vargjet "true"/"false" refuzohen.

has_inspectionsinteger

Makina rrënjë ka një inspektim publik. Dërgoni 1 (true) ose 0 (false). Hiqeni për cilëndo vlerë; vargjet "true"/"false" refuzohen.

has_history_reportsinteger

Një shpallje në shtrirjen e domeneve të zgjedhura ka një raport historiku publik. Dërgoni 1 (true) ose 0 (false). Hiqeni për cilëndo vlerë; vargjet "true"/"false" refuzohen.

Kategoritë
body_types[]integer[]

Repeat to match any of the values.

colors[]integer[]

Repeat to match any of the values.

fuels[]integer[]

Repeat to match any of the values.

transmissioninteger

One value.

seller_typeinteger

One value.

steering_wheel_positioninteger

One value.

airbagsinteger

One value.

damages[]integer[]

Repeat to match any of the values.

conditions[]integer[]

Repeat to match any of the values.

availabilities[]integer[]

Repeat to match any of the values.

emissions[]integer[]

Repeat to match any of the values.

drive_wheels[]integer[]

Repeat to match any of the values.

interior_colors[]integer[]≤ 100 items

ID-të e ngjyrave të brendshme nga fjalori i ngjyrave. Vlerat lidhen me OSE; vlerat që mungojnë nuk përputhen. Zbatohet në /search, /search/count dhe /cars. Mos e ndryshoni gjatë vazhdimit të scroll.

cylinders[]integer[]1–99 · ≤ 99 items

Numri i saktë i cilindrave (1–99), OSE brenda listës; vlerat e panjohura nuk përputhen. Zbatohet në /search, /search/count dhe /cars. Mos e ndryshoni gjatë vazhdimit të scroll.

Fusha shtesë të njoftimeve

Ngarkoni /listing-fields pasi të kontrolloni çelësin. Përkufizimet, kufizimet, operatorët dhe shënimet vlejnë vetëm për atë çelës dhe domenet e zgjedhura.

Tekst: eq, in, exists. Numra dhe data edhe gt, gte, lt, lte. Boolean: eq ose exists. Përdorni eq, in, exists ose interval; exists veçmas. Deri në 20 fusha dhe 100 vlera në in.

Të gjitha kushtet, domenet dhe gjendja aktive duhet të përputhen në një njoftim. Zero dhe false janë vlera. Te vargjet mjafton një element që përputhet. Fushat/operatorët e panjohur ose të palejuar kthejnë 422.

Filtroni vetëm fushat filterable. Vlerat e indeksuara: listings[].custom_fields; të tjerat: listings[].source_data. Publikimi aktivizon filtrat; importet e zakonshme pasuese plotësojnë vlerat. Dokumentet e vjetra nuk plotësohen veçmas.

Në /cars kushtet ruhen për tërë scroll. Përkufizimi i papajtueshëm ose humbja e gjendjes së ruajtur kërkon scroll të ri. Renditja dhe agregimet nuk mbështeten.

Zëvendësoni FIELD_KEY me një çelës nga katalogu i lejuar. Për krahasime monetare vendosni monedhën e njoftimit; konvertimi Buy Now nuk zbatohet.

Vlerësimet historike të tregut nga burimi janë vlera informative pa indeksim. Përshkruajnë shitje të krahasueshme, jo çmimin, ofertën ose rezervën e këtij listimi. Kontrolloni përshkrimin e fushës, kriteret e krahasimit dhe datën e llogaritjes; mos supozoni monedhën e listimit. Fushat numerike të regjistruara mund të jenë null kur mungon vlerësimi.

custom_fields[FIELD_KEY][gte]=2
custom_fields[FIELD_KEY][in][]=a&custom_fields[FIELD_KEY][in][]=b
custom_fields[FIELD_KEY][eq]=false
custom_fields[FIELD_KEY][lte]=15000&custom_fields[FIELD_KEY][currency]=cad

Fusha shtesë të njoftimeve

Lidhni një çelës për të parë fushat e domeneve të lejuara.

Kthen · Një faqe me objekte Car në data, me links dhe meta. Vargjet inspections dhe vehicle_history_reports mungojnë.
GET/search
curl -g "https://api.auctionsapi.com/search?perPage=5&api_key=$CARS_API_KEY" \
  -H "Accept: application/json"
ShembujI regjistruar
{3 keys
"data": [1 item
0: {21 keys
"id": "l_eCJb-8zB_XcJ-z6Y7oZWjw"
"has_inspections": true
"has_history_reports": true
"year": 2014
"month": 4
"vin": "wddhf0cb3ea952710"
"brand": {2 keys}
"model": {2 keys}
"engine_volume": 2143
"seats": 5
"body_type": {2 keys}
"transmission": {2 keys}
"transmission_steps": 6
"fuel": {2 keys}
"color": {2 keys}
"power_hp": 170
"market_origin": {2 keys}
"badge": "E220 CDI Avantgarde"
"option_ids": [53 items]
"listings": [1 item]
"hash": "093563801f92d9cfa23a07346b26b69db32df8da05d7c5ee60fa5fd876a7fe0b"
}
]
"links": {4 keys}
"meta": {7 keys}
}

Merrni qasje në API

Lidhni çelësin për të ekzekutuar çdo kërkesë nga këto faqe me të dhënat tuaja. Ende pa çelës? Na kërkoni një çelës demo: i njëjti JSON si në planet me pagesë.

Kam një çelës