Parametrat e kërkimit — GET /cars
Kombinoni cilindo prej tyre në një thirrje të vetme. Përgjigjja mban total, page, count dhe results[], prandaj mund të faqezoni mbi total pa një kërkesë të dytë.
| parameter | what it does |
|---|---|
| manufacturer | Brand, as Encar writes it: BMW, Hyundai, Kia, Genesis, Mercedes-Benz, Audi. |
| model | Model name, e.g. X5 (G05). Partial names match, and a generation name narrows further: model=The New Carnival returns that generation alone, not the whole nameplate. |
| q | Free-text search across brand, model and badge. Aliases: keyword, search. |
| fuel | diesel · gasoline · hybrid · electric · lpg. |
| transmission | automatic · manual. |
| color | Exterior colour. |
| seats | Seat count: 5, 7, 9. Several at once as seats=7,9. The two ends are ranges, not counts — 2 means two seats or fewer and 10 means ten or more, which is how the source files them. A car's own figure comes back as details.seats from /car. |
| yearFrom / yearTo | Model year bounds, as plain years: 2018, 2024. |
| mileageFrom / mileageTo | Odometer bounds in kilometres. |
| priceFrom / priceTo | Price bounds in EUR — converted for you, not won. |
| sort | priceAsc or priceDesc. Left out, results come back newest first. |
| page | Page index, zero-based. Default 0. |
| count | Listings per page. Default 24, maximum 500. |
Parametrat e panjohur injorohen në vend që të refuzohen, prandaj shtimi i një filtri që plani juaj nuk e mbështet nuk e prish një integrim ekzistues — thjesht nuk e ngushton rezultatin.
Një shembull i punuar
BMW X5 me naftë nën 40.000 €, më të lirat të parat, 24 për faqe. I gjithë query-ja është URL-ja.
curl -H "x-api-key: avg_free_..." \
"https://api.encar-api.com/api/cars?manufacturer=BMW&model=X5\
&fuel=diesel&priceTo=40000&sort=priceAsc&count=24"Merr çelësin tënd të API-t
Falas · 100 kërkesa në ditë
Vazhdo të lexosh
Të dhënat vijnë nga një burim korean, prandaj katër prej këtyre fushave lexohen gabim si parazgjedhje. Secili gabim dështon në heshtje — faqja juaj shfaqet, thjesht është e pasaktë.
Çdo përgjigje mban X-RateLimit-Limit, X-RateLimit-Remaining dhe X-RateLimit-Reset, prandaj një limit e shihni duke ardhur, nuk e zbuloni.
Nëse diçka mungon, na shkruani — numri poshtë arrin te një njeri.