Zmodyfikowano dnia: 16 Aug, 2026

Ten przewodnik zawiera dokumentację ułatwiającą integrację z Jooble REST API. Poniżej znajdziesz informacje na temat generowania kluczy API, punktów końcowych (endpoints), parametrów żądań, formatów JSON oraz typowych kodów odpowiedzi. Jeśli proces integracji nie został jeszcze rozpoczęty, zapoznaj się z naszym przewodnikiem krok po kroku Jak połączyć się z Jooble REST API.

Ważne ograniczenia regionalne:
Każda domena Jooble (kraj) wymaga własnego, unikalnego klucza REST API. Na przykład klucz wygenerowany na stronie jooble.org zapewnia dostęp wyłącznie do ofert pracy z USA. Aby wyszukiwać oferty pracy w innych krajach, zarejestruj się i pobierz klucz API na odpowiedniej domenie regionalnej (np. uk.jooble.org/api/about dla Wielkiej Brytanii lub de.jooble.org/api/about dla Niemiec).

Limity korzystania z API:
Bezpłatny plan REST API obejmuje całkowity limit 500 żądań na klucz w całym okresie użytkowania (jest to bezwzględny limit całkowity, a nie limit miesięczny).

Jak uzyskać klucz do Jooble REST API

1. Zarejestruj konto w portalu API Jooble dla wybranego kraju (np. pl.jooble.org/api/about).
2. Po zarejestrowaniu skopiuj i bezpiecznie zapisz wygenerowany klucz API.

Parametry żądania (treść JSON)

Treść żądania musi zostać wysłana w formacie application/json z następującymi parametrami:

• keywords(ciąg znaków, wymagany): Słowa kluczowe lub stanowiska do wyszukania.
• location(ciąg znaków, wymagany): Nazwa lokalizacji (miasto, region lub kraj).
• radius(ciąg znaków, opcjonalny): Promień wyszukiwania w kilometrach. Dozwolone wartości: 0, 4, 8, 16, 26, 40, 80.
• salary(liczba całkowita, opcjonalna): Minimalny próg wynagrodzenia.
• page(liczba całkowita, opcjonalna): Numer strony z wynikami wyszukiwania (domyślnie 1).
• ResultOnPage(liczba całkowita, opcjonalna): Liczba ofert pracy zwracanych na stronie.
• SearchMode(liczba całkowita, opcjonalna): Tryb algorytmu wyszukiwania (domyślnie 0).
• companysearch(wartość logiczna, opcjonalna):
  • true – wyszukiwanie słów kluczowych wyłącznie w nazwach firm.
  • false – wyszukiwanie słów kluczowych w stanowiskach i opisach ofert pracy.

Parametry odpowiedzi

Po pomyślnym przesłaniu żądania serwer zwraca obiekt JSON zawierający:

• totalCount(liczba całkowita): Całkowita liczba znalezionych ofert pracy.
• jobs(tablica): Lista obiektów ofert pracy zawierających:
  • id(liczba całkowita): Unikalny identyfikator ogłoszenia.
  • title(ciąg znaków): Stanowisko.
  • location(ciąg znaków): Lokalizacja oferty pracy.
  • snippet(ciąg znaków): Krótki fragment opisu wyświetlany w wynikach wyszukiwania.
  • salary(ciąg znaków): Przedział wynagrodzenia w formacie {min} - {max} {currency}.
  • source(ciąg znaków): Źródło ogłoszenia o pracę.
  • type(ciąg znaków): Typ zatrudnienia (np. Pełny etat, Część etatu).
  • link(ciąg znaków): Bezpośredni link do oferty pracy na Jooble.
  • company(ciąg znaków): Nazwa firmy.
  • updated(ciąg znaków): Znacznik czasu ISO ostatniej aktualizacji oferty pracy.

Przykłady żądań i odpowiedzi JSON

Przykładowa treść żądania:

Przykładowa prawidłowa odpowiedź (200 OK):

Kody odpowiedzi HTTP i błędów

• 200 OK: Żądanie powiodło się i zwrócono dane.
• 403 Access Denied: Nieprawidłowy lub brakujący klucz API.
• 404 Not Found: Żądany punkt końcowy lub zasób nie istnieje.

Przykłady implementacji kodu

Możesz zintegrować Jooble REST API, korzystając z takich języków programowania jak PHP, JavaScript, Python (2.7 / 3.5+), C# (.NET 4+), Ruby i innych. Gotowe fragmenty kodu i przewodniki dotyczące implementacji są dostępne na naszej stronie dokumentacji Jooble API.