API Katalog Samochodów
Parametry dla kategorii pojazdów osobowych(id:29) w Otomoto, bazują na katalogu, który wskazuje wartości jakie mogą być dodane w odpowiednich parametrach takich jak: marka, model, rok produkcji, rodzaj paliwa, moc, pojemność skokowa, liczba drzwi, skrzynia biegów oraz wersja.
Można to porównać do języka, którym posługują się dwa komputery, aby współpracować. Dzięki API, możesz na przykład korzystać z aplikacji do zarządzania swoim biznesem, która automatycznie łączy Twoje konto Otomoto z ofertą, którą posiadasz na swojej stronie internetowej lub w innym serwisie. To pozwala na szybsze i wygodniejsze zarządzanie ofertą, szczególnie gdy posiadasz dużą ilość ogłoszeń.
Pobranie odpowiednich odbywa się za pomocą metody html GET na adres:
GET https://www.otomoto.pl/categories/29/models/kia/generations/ceed
Zalecamy jednak tworzenie szczegółowych zapytań, dzięki uzupełnieniu takich parametrów jak marka, model itp
Aby pobrać generacje, należy zgodnie z dokumentacją skorzystać z zapytania:
GET https://www.otomoto.pl/categories/:category_id/models/:brand_code/generations/:model_code
Przykładowo, dla zapytania
GET https://www.otomoto.pl/api/open/categories/29/
Otrzymamy odpowiedź:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
{
"options": {
"gen-i-2006-2012": {
"pl": "I (2006-2012)",
"en": "I (2006-2012)"
},
"gen-ii-2012-ceed": {
"pl": "II (2012-)",
"en": "II (2012-)"
},
"gen-iii-2018": {
"pl": "III (2018-)",
"en": "III (2018-)"
}
}
}
Jeśli chodzi natomiast o aktualne wartości dla parametru “version”, to przykładowe zapytanie i odpowiedź dla Kia Ceed wyglądają następująco:
GET https://www.otomoto.pl/categories/29/models/kia/versions/ceed?&fuel_type=petrol&engine_power=109
Otrzymamy odpowiedź:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
{
"options": {
"ver-cee-d-1-4-comfort": {
"pl": "Cee'd 1.4 Comfort",
"en": "Cee'd 1.4 Comfort"
},
"ver-cee-d-1-4-comfort-plus": {
"pl": "Cee'd 1.4 Comfort +",
"en": "Cee'd 1.4 Comfort +"
},
"ver-cee-d-1-4-optimum": {
"pl": "Cee'd 1.4 Optimum",
"en": "Cee'd 1.4 Optimum"
},
"ver-cee-d-1-4-optimum-plus": {
"pl": "Cee'd 1.4 Optimum +",
"en": "Cee'd 1.4 Optimum +"
},
"other": {
"pl": "Inne",
"en": "Other"
}
}
}
Zgodnie z działaniem katalogu samochodów, możliwość wybrania konkretnej wersji jest uzależniona od parametrów silnika czy skrzyni biegów. Można to sprawdzić bezpośrednio z poziomu formularza dodawania ogłoszenia na Otomoto, z dowolnego konta prywatnego czy biznesowego.
Kolejność podawania parametrów jest następująca:
1) rok produkcji
2) marka i model pojazdu
3) rodzaj paliwa, moc i pojemność silnika
4) liczba drzwi
5) skrzynia biegów
6) wersja (jeśli dostępna)
Aby uzyskać wersje dostępne dla konkretnego rodzaju paliwa, silnika i skrzyni biegów, należy postąpić zgodnie ze ścieżką.
1. Odpytać o dostępne rodzaje paliwa danego rocznika, marki i modelu.
2. Następnie, o dostępne moce silnika dla kombinacji z pkt 1, później o dostępne pojemności silnika dla wybranej mocy itd. Po uzyskaniu pełnej liczby parametrów, można odpytać system o dostępne wersje.
Przykładowo - najpierw należy wysłać zapytanie jak niżej, aby określić dostępne moce silnika w danym modelu (i np jego konkretnym roczniku i roku produkcji).
GET https://www.otomoto.pl/categories/29/models/kia/engine_powers/ceed
Dalej, dla uzyskanych parametrów - można wysłać kolejne zapytanie o dostępne pojemności silnika, liczbę drzwi itd. Do takiego zestawu parametrów można przypisać ostatecznie parametr "versions" w jego obecnym formacie.
Poniżej przykładowe zapytanie dla parametru “versions” z dodanymi wszystkimi parametrami oraz odpowiednimi wartościami
GET https://www.otomoto.pl/categories/29/models/kia/versions/ceed?&fuel_type=petrol&engine_power=109&engine_capacity=1396&year=2011$door_count=5&gearbox=manual
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
{
"options": {
"ver-cee-d-1-4-comfort": {
"pl": "Cee'd 1.4 Comfort",
"en": "Cee'd 1.4 Comfort"
},
"ver-cee-d-1-4-comfort-plus": {
"pl": "Cee'd 1.4 Comfort +",
"en": "Cee'd 1.4 Comfort +"
},
"ver-cee-d-1-4-optimum": {
"pl": "Cee'd 1.4 Optimum",
"en": "Cee'd 1.4 Optimum"
},
"other": {
"pl": "Inne",
"en": "Other"
}
}
}
Dokumentacja API
Sprawdź dokumentację naszego API
Kolekcja API
Skorzystaj z kolekcji API do Postman
Chcesz zacząć wysłać ogłoszenia poprzez API na OTOMOTO?
Załóż konto partnera API i ciesz się automatyzacją procesu wysyłki i zarządzania ogłoszeniami