Şu tarihte değiştirildi: 16 Aug, 2026

Bu kılavuz, Jooble REST API ile entegrasyon için dokümantasyon sağlamaktadır. Aşağıda API anahtarı oluşturma, uç noktalar, istek parametreleri, JSON formatları ve yaygın yanıt kodları hakkında bilgi bulabilirsiniz. Entegrasyonu henüz başlatmadıysanız lütfen Jooble REST API'sine Nasıl Bağlanılır konulu adım adım kılavuzumuza bakın.

Önemli Bölgesel Kısıtlamalar:
Her Jooble alan adı (ülke) kendi benzersiz REST API anahtarını gerektirir. Örneğin, jooble.org üzerinde oluşturulan bir anahtar yalnızca ABD'deki iş ilanlarına erişim sağlar. Diğer ülkelerin iş ilanlarını sorgulamak için ilgili bölgesel alan adında (örneğin, Birleşik Krallık için uk.jooble.org/api/about veya Almanya için de.jooble.org/api/about) kaydolun ve bir API anahtarı edinin.
API Kullanım Sınırları:
Ücretsiz REST API planı, anahtar başına toplam 500 istek içeren bir ömür boyu sınıra sahiptir (bu, aylık bir sınır değil, kesin bir ömür boyu kotadır).

Jooble REST API Anahtarı Nasıl Alınır

  1. Hedef ülkeniz için Jooble API portalında bir hesap oluşturun (örneğin, tr.jooble.org/api/about).
  2. Kaydolduktan sonra, oluşturulan API anahtarınızı kopyalayın ve güvenli bir yerde saklayın.

İstek Parametreleri (JSON Gövdesi)

İstek yükü, aşağıdaki parametrelerle birlikte application/json formatında gönderilmelidir:

  • keywords(dize, gerekli): Aranacak anahtar kelimeler veya iş unvanları.
  • location(dize, gerekli): Konum adı (şehir, bölge veya ülke).
  • radius(dize, isteğe bağlı): Kilometre cinsinden arama yarıçapı. İzin verilen değerler: 0, 4, 8, 16, 26, 40, 80.
  • salary(tamsayı, isteğe bağlı): Minimum maaş eşiği.
  • page(tamsayı, isteğe bağlı): Arama sonuçlarının sayfa numarası (varsayılan değer 1'dir).
  • ResultOnPage(tamsayı, isteğe bağlı): Sayfa başına döndürülen iş ilanı sayısı.
  • SearchMode(tamsayı, isteğe bağlı): Arama algoritması modu (varsayılan değer 0'dır).
  • companysearch(boole, isteğe bağlı):
    • true – Anahtar kelimeleri özellikle şirket adlarında ara.
    • false – Anahtar kelimeleri iş unvanlarında ve açıklamalarında ara.

Yanıt Parametreleri

Başarılı bir isteğin ardından sunucu, şunları içeren bir JSON nesnesi döndürür:

  • totalCount(tamsayı): Bulunan toplam eşleşen iş ilanı sayısı.
  • jobs(dizi): Şunları içeren iş ilanı nesnelerinin listesi:
    • id(tamsayı): Benzersiz iş ilanı kimliği.
    • title(dize): İş unvanı.
    • location(dize): İş ilanı konumu.
    • snippet(dize): Arama sonuçlarında görüntülenen kısa açıklama snippet'i.
    • salary(dize): {min} - {max} {currency} şeklinde biçimlendirilmiş maaş aralığı.
    • source(dize): İş ilanının yayınlandığı kaynak.
    • type(dize): İstihdam türü (örneğin, Tam zamanlı, Yarı zamanlı).
    • link(dize): İş ilanının Jooble üzerindeki doğrudan bağlantısı.
    • company(dize): Şirket adı.
    • updated(dize): Son iş ilanı güncellemesinin ISO zaman damgası.

JSON İstek ve Yanıt Örnekleri

Örnek İstek Yükü:

POST https://tr.jooble.org/api/{api_Key} Content-Type: application/json { "keywords": "Sales Manager, Administrator", "location": "Kyiv", "radius": "80", "page": "1", "companysearch": "false" }

Örnek Başarılı Yanıt (200 OK):

{ "totalCount": 1, "jobs": [ { "id": 1234567890, "title": "Sales Manager", "location": "Kyiv", "snippet": "This is a great opportunity to join our team...", "salary": "17,600 UAH", "source": "jooble", "type": "Full-time", "link": "https://ua.jooble.org/jdp/12345", "company": "ABC Corp", "updated": "2023-09-15T12:55:35.3870000" } ] }

HTTP Yanıt ve Hata Kodları

  • 200 OK: İstek başarılı oldu ve verdöndürüldüdü.
  • 403 Access Denied: Geçersiz veya eksik API anahtarı.
  • 404 Not Found: İstenen uç nokta veya kaynak mevcut değil.

Kod Uygulama Örnekleri

Jooble REST API'sini PHP, JavaScript, Python (2.7 / 3.5+), C# (.NET 4+), Ruby ve diğer programlama dillerini kullanarak entegre edebilirsiniz. Kullanıma hazır kod parçacıkları ve uygulama kılavuzları, Jooble API Dokümantasyon Sayfamızda mevcuttur.