curl --request GET \
--url https://api.gospott.com/job-descriptions/vacancy/{id} \
--header 'x-api-key: <api-key>'import requests
url = "https://api.gospott.com/job-descriptions/vacancy/{id}"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.gospott.com/job-descriptions/vacancy/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.gospott.com/job-descriptions/vacancy/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.gospott.com/job-descriptions/vacancy/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.gospott.com/job-descriptions/vacancy/{id}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gospott.com/job-descriptions/vacancy/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"jobDescriptionId": "550e8400-e29b-41d4-a716-446655440000",
"vacancyId": "<string>",
"language": "en-US",
"format": "FREEFORM",
"externalJobTitle": "Senior Software Engineer",
"content": "<p>We are looking for a senior software engineer...</p>",
"requirements": "<string>",
"description": "<string>",
"compensation": "<string>"
}{
"status": 0,
"message": "<string>",
"requestId": "<string>",
"errors": [
{
"code": "REQUIRED",
"path": "<string>",
"message": "<string>",
"received": "<unknown>"
}
]
}{
"status": 0,
"message": "<string>",
"requestId": "<string>"
}{
"status": 0,
"message": "<string>",
"requestId": "<string>"
}{
"status": 0,
"message": "<string>",
"requestId": "<string>"
}Get job description for job
Deprecated: returns only the default (oldest) job description for a job. Use GET /job-descriptions?vacancyId= to list every job description and GET /job-descriptions/:id to fetch a specific one.
curl --request GET \
--url https://api.gospott.com/job-descriptions/vacancy/{id} \
--header 'x-api-key: <api-key>'import requests
url = "https://api.gospott.com/job-descriptions/vacancy/{id}"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.gospott.com/job-descriptions/vacancy/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.gospott.com/job-descriptions/vacancy/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.gospott.com/job-descriptions/vacancy/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.gospott.com/job-descriptions/vacancy/{id}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gospott.com/job-descriptions/vacancy/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"jobDescriptionId": "550e8400-e29b-41d4-a716-446655440000",
"vacancyId": "<string>",
"language": "en-US",
"format": "FREEFORM",
"externalJobTitle": "Senior Software Engineer",
"content": "<p>We are looking for a senior software engineer...</p>",
"requirements": "<string>",
"description": "<string>",
"compensation": "<string>"
}{
"status": 0,
"message": "<string>",
"requestId": "<string>",
"errors": [
{
"code": "REQUIRED",
"path": "<string>",
"message": "<string>",
"received": "<unknown>"
}
]
}{
"status": 0,
"message": "<string>",
"requestId": "<string>"
}{
"status": 0,
"message": "<string>",
"requestId": "<string>"
}{
"status": 0,
"message": "<string>",
"requestId": "<string>"
}Authorizations
API key for authentication. Get your API key from Settings → API Keys in your Spott dashboard.
Path Parameters
Response
Job description retrieved successfully
Unique identifier of the job description
1"550e8400-e29b-41d4-a716-446655440000"
The language of this job description
en-US, en-GB, es, nl, fr, de, hu, cs, pt, no, sv, da, fi, pl, ro, it, af, cy, ja, hr, is The content format of this job description. FREEFORM stores a single HTML body; STRUCTURED stores separate blocks whose derived HTML is exposed on content.
FREEFORM, STRUCTURED The externally visible job title for this job
"Senior Software Engineer"
The HTML content of the job description, or null if no content has been set. For STRUCTURED job descriptions this is the derived HTML projection of the blocks.
"<p>We are looking for a senior software engineer...</p>"
The Requirements block HTML for STRUCTURED job descriptions; null for FREEFORM job descriptions.
The Description block HTML for STRUCTURED job descriptions; null for FREEFORM job descriptions.
The Compensation block HTML for STRUCTURED job descriptions; null for FREEFORM job descriptions.
Was this page helpful?