{"openapi":"3.1.0","info":{"title":"Jawne Stawki API","version":"1.0.0","description":"Wynagrodzenia w Polsce z publicznych ogłoszeń o pracę (90 dni, aktualizacja co 3 godziny). Bez klucza, tylko odczyt. Kwoty: zł miesięcznie; umowa o pracę i zlecenie brutto, B2B netto na fakturze. Dane zbiorcze można wykorzystywać z podaniem źródła: jawnestawki.pl z linkiem.","contact":{"email":"kontakt@jawnestawki.pl","url":"https://jawnestawki.pl/api"}},"servers":[{"url":"https://jawnestawki.pl/api/v1"}],"paths":{"/zawody":{"get":{"operationId":"searchOccupations","summary":"Szukaj zawodu po polskiej nazwie","parameters":[{"name":"q","in":"query","required":false,"description":"Polska nazwa zawodu, np. \"magazynier\", \"programista java\"","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":10}}],"responses":{"200":{"description":"Pasujące zawody: identyfikator (slug), nazwa, liczba ofert, mediany","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/zawody/{slug}":{"get":{"operationId":"getSalary","summary":"Wynagrodzenia w zawodzie","parameters":[{"name":"slug","in":"path","required":true,"description":"Identyfikator zawodu z /zawody albo nazwa","schema":{"type":"string"}},{"name":"miasto","in":"query","required":false,"description":"Miasto: identyfikator (np. \"warszawa\") albo nazwa. Bez miasta: cała Polska.","schema":{"type":"string"}},{"name":"umowa","in":"query","required":false,"description":"Umowa: uop (brutto), b2b (netto na fakturze), zlecenie (brutto).","schema":{"type":"string","enum":["uop","b2b","zlecenie"]}},{"name":"doswiadczenie","in":"query","required":false,"description":"Wymagane doświadczenie.","schema":{"type":"string","enum":["bez","do-2-lat","2-5-lat","ponad-5-lat"]}}],"responses":{"200":{"description":"Percentyle według umowy, doświadczenie, miasta, wymagania, dane GUS, link do strony","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Nie znaleziono zawodu (z propozycjami)","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/porownaj":{"get":{"operationId":"compareOccupations","summary":"Porównaj dwa zawody","parameters":[{"name":"a","in":"query","required":true,"schema":{"type":"string"}},{"name":"b","in":"query","required":true,"schema":{"type":"string"}},{"name":"miasto","in":"query","required":false,"description":"Miasto: identyfikator (np. \"warszawa\") albo nazwa. Bez miasta: cała Polska.","schema":{"type":"string"}},{"name":"umowa","in":"query","required":false,"description":"Umowa: uop (brutto), b2b (netto na fakturze), zlecenie (brutto).","schema":{"type":"string","enum":["uop","b2b","zlecenie"]}},{"name":"doswiadczenie","in":"query","required":false,"description":"Wymagane doświadczenie.","schema":{"type":"string","enum":["bez","do-2-lat","2-5-lat","ponad-5-lat"]}}],"responses":{"200":{"description":"Dwa raporty obok siebie","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/miasta":{"get":{"operationId":"listCities","summary":"Miasta ze stroną (od 30 ofert)","responses":{"200":{"description":"Lista miast","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/miasta/{slug}":{"get":{"operationId":"getCity","summary":"Zarobki i popyt w mieście","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Oferty, mediany, porównanie z Polską, zawody z największym popytem","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Nie znaleziono miasta","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/rankingi":{"get":{"operationId":"getRankings","summary":"Najlepiej płatne zawody i największy popyt","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":15}}],"responses":{"200":{"description":"Rankingi","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/status":{"get":{"operationId":"getStatus","summary":"Stan API i świeżość danych","responses":{"200":{"description":"status: ok, liczba aktualnych ofert, ostatnia aktualizacja","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}