Sorry, an error occurred and the server can not process your request at the moment. Try again in a few minutes.
To main page Get Started Integration Examples Test API

Get Started with Jooble REST API

Join Jooble in helping employers and candidates find each other on the web.

The REST API allows developers to access and integrate Jooble's search results within your web products, or to build an entirely new web product of your own.

How Do I Start?

Fill out the form below to request a Jooble REST API key. Upon completing the form, you will receive a unique API key. You will need this key to use our API.

We are excited to cooperate with you.

Name*
Title*
Website*
Phone*
Email*

Thank you for your cooperation.

Go to main

Integration Examples

We support multiple formats for your convenience. Consult your developers if in doubt.

Formats Supported

JSON
C# (.NET 4 or later)
Javascript
Php
Python 2.7
Python 3.5
Ruby

Send HTTP POST to https://nz.jooble.org/api/<API KEY> to use REST API

JSON Request Example:
 {
		"keywords": "account manager",
		"location": "London",
		"radius": "80",
		"salary": "3000",
		"page": "1"
 }

The Request Fields Description
keywords - (required) - search keywords
location - Location
radius - Distance (0, 8, 16, 24, 40, 80) kilometers
salary - Salary range 10000 - 3000 ($)
page - Page number
searchMode - Job listings display mode
	1 - Recommended job listngs + *JDP (Jooble Job Description mode for a better user experience)
	2 - Recommended job listings
	3 - All job listings (not recommended)
 
JSON Response Example:
{
	"totalCount":651,

	"jobs": [
		"job": {
			"title": "Account manager",
			"location": "London",
			"snippet": "... are looking for account manager in London, greate opportunity to ...",
			"salary": "3000 $",
			"source": "barclays.co.uk",
"type": "Any",
			"link": "https://nz.jooble.org/away/...",
			"company": "Jooble",
			"id": 8240559805230395300,
			"updated": "2016-05-26T10:51:51.4720673+03:00"
		},
		"job": ...
	]
}

Response Fields
 totalCount - Results Total Count

"job": Structure
title - Title
location - Location
snippet - Extract
salary - Salary
source - Job Source
type - Job Type (Any, Full-time, Temporary, Part-time, Internship, null)
link - URL
updated - job publication date (ISO 8601 format)

Response returns the total number of search results available. The search results are limited to 20 jobs per page.
var url = "https://nz.jooble.org/api/";
var key = "<YOUR_API_KEY>";

//create request object
WebRequest request = HttpWebRequest.Create(url + key);
//set http method
request.Method = "POST";
//set content type
request.ContentType = "application/x-www-form-urlencoded";
//create request writer
var writer = new StreamWriter(request.GetRequestStream());
//write request body
writer.Write("{ keywords: 'it', location: 'Bern'}");
//close writer
writer.Close();
//get response reader
var response = request.GetResponse();
var reader = new StreamReader(response.GetResponseStream());
//read response
while (!reader.EndOfStream)
{
    Console.WriteLine(reader.ReadLine());
}    
var url = "https://nz.jooble.org/api/";
var key = "<YOUR_API_KEY>";
var params = "{ keywords: 'it', location: 'Bern'}"

//create xmlHttpRequest object
var http = new XMLHttpRequest();
//open connection. true - asynchronous, false - synchronous
http.open("POST", url + key, true);

//Send the proper header information
http.setRequestHeader("Content-type", "application/x-www-form-urlencoded");
	
//Callback when the state changes
http.onreadystatechange = function() {
	if(http.readyState == 4 && http.status == 200) {
		alert(http.responseText);
	}
}
//Send request to the server
http.send(params);
<?php
$url = "https://nz.jooble.org/api/";
$key = "<YOUR_API_KEY>";

//create request object
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url."".$key);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{ "keywords": "it", "location": "Bern"}');
curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-Type: application/x-www-form-urlencoded'));

// receive server response ...
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$server_output = curl_exec ($ch);
curl_close ($ch);

//print response
print_r($server_output);

?>
import httplib

host = 'nz.jooble.org'
key = '<YOUR_API_KEY>'

connection = httplib.HTTPConnection(host)
#request headers
headers = {"Content-type": "application/x-www-form-urlencoded"}
#json query
body = '{ "keywords": "it", "location": "Bern"}'
connection.request('POST','/api/' + key, body, headers)
response = connection.getresponse()
print(response.status, response.reason)
print(response.read())
import http.client

host = 'nz.jooble.org'
key = '<YOUR_API_KEY>'

connection = http.client.HTTPConnection(host)
#request headers
headers = {"Content-type": "application/x-www-form-urlencoded"}
#json query
body = '{ "keywords": "it", "location": "Bern"}'
connection.request('POST','/api/' + key, body, headers)
response = connection.getresponse()
print(response.status, response.reason)
print(response.read())
require 'net/http'
url = 'https://nz.jooble.org/api/'
key = '<YOUR_API_KEY>'
#create uri for request
uri = URI.parse(url + key)
#prepare post data
post_args = {
	'content' => "{ keywords: 'it', location: 'Bern'}"
}
#send request to the server
resp, data = Net::HTTP.post_form(uri, post_args)