REST API Belgeleri

Şu tarihte değiştirildi: 26 May, 2025

REST API anahtarınızla bağlantı kurduktan sonra endpoint, yanıt parametreleri ve olası kod hataları hakkında bilgi bulabilirsiniz. Bağlantı kurmadıysanız, bu rehberdeki adımları takip edin.

API Anahtarını Nasıl Alabilirsiniz?
Web sitesine kaydolun: https://tr.jooble.org/api/about
Kayıt yaptıktan sonra, sizin için oluşturulan API anahtarını kopyalayıp saklayın.

Endpoints
Aşağıda, istediğiniz verileri almak için Jooble REST API ile etkileşimde bulunmak üzere kullanabileceğiniz mevcut endpoint'leri bulabilirsiniz.

İstek Parametreleri:
POST /api/{api_Key}

keywords: İş ilanlarını aramak için anahtar kelimeler.
location: İş ilanlarını aramak için konum.
radius (isteğe bağlı): Arama yarıçapı, kilometreye çevrildi (tür: string; yalnızca değer: 0, 4, 8, 16, 26, 40, 80).
salary (isteğe bağlı): İş araması için minimum maaş (tür: integer).
page (isteğe bağlı): Arama sonuçlarının sayfa numarası.
ResultOnPage (isteğe bağlı): Her sayfada gösterilen iş ilanı sayısı.
SearchMode (isteğe bağlı): Arama modu, varsayılan 0.
companysearch (isteğe bağlı):
- true – İş ilanında şirket adında anahtar kelimeleri arayın.
- false &nd ash; İş ilanında iş başlığı veya açıklamasında anahtar kelimeleri arayın.

Yanıt Parametreleri:

totalCount: Arama isteğinde bulunan toplam iş ilanı sayısı.
jobs: Arama kriterlerine uyan iş ilanlarının listesi.
title: İş başlığı.
location: İş konumu.
snippet: Arama sonuçlarında görüntülenen iş açıklamasının parçası.
salary: Maaş aralığı {job.salary_val1} - {job.salary_val2} {currency} formatında.
source: İş ilanının kaynağı.
type: İş türü (tam zamanlı, yarım zamanlı, vb.).
link: İş ilanına giden URL.
company: Şirket adı.
updated: İş ilanının son güncellenme tarihi ve saati.
id: İş ilanının benzersiz kimliği.

JSON Örnek İstek
POST https://jooble.org/api/{api_Key}

{
  "keywords": "Satış Yöneticisi, Yönetici",
  "location": "Kyiv",
  "radius": "80",
  "page": "1",
  "companysearch": "false"
}

Başarılı Yanıt: 200 OK

{  "totalCount": 1,  
    "jobs": [    
    {   "title": "Satış Yöneticisi",      
        "location": "Kyiv",      
        "snippet": "Bu, ekibimize katılmak için harika bir fırsat...",      
        "salary": "17,600 UAH",      
        "source": "jooble",      
        "type": "Tam Zamanlı",      
        "link": "https://tr.jooble.org/jdp/12345",      
        "company": "ABC Corp",      
        "updated": "2023-09-15T12:55:35.3870000",      
        "id": 1234567890    }  ] 
}

Hata Yanıtları:
403: Erişim reddedildi – Geçersiz API anahtarı.
404: Bulunamadı – İstenen endpoint veya kaynak mevcut değil.

Kodda Jooble API'nin Kullanım Örneği
Jooble API'sini PHP, JavaScript, Ruby, C# (.NET 4 veya sonrası), Python 3.5 veya Python 2.7 kullanarak uygulayabilirsiniz. Her dil için ayrıntılı kod örnekleri Jooble API hakkında sayfasında bulunabilir, bunu programcıya gösterin.

Jooble REST API Dokümantasyonu

İlgili Makaleler