Introduction
Welcome to TalentUp's API! You can use our API to access TalentUp API endpoints, which can get information on salaries, offer and demand of different positions in our database.
We have language bindings in Shell and Python! You can view code examples in the dark area to the right, and you can switch the programming language of the examples with the tabs in the top right.
Authentication
To authorize, use this code:
import requests
url = "https://talentup.io/api/authenticate"
querystring = {
"api_key": "Your api key"
}
headers = {
'Cache-Control': 'no-cache',
'Content-Type': 'application/json'
}
response = requests.request("GET", url, headers=headers, params=querystring)
print(response.text)
curl "https://talentup.io/api/authenticate/?api_key=<YOUR_API_KEY>"
Make sure to replace
Your api key
with your API key. A correct authentication returns a JSON like this:
{
"api_key": "Your api key",
"valid": True,
"code":"Authentication successful",
"status":200
}
TalentUp expects for the API key to be included in all API requests to the server in a header that looks like the following:
api_key: Your api key
Location API
Get All Cities
import requests
url = "https://talentup.io/api/cities"
querystring = {
"api_key": "Your api key"
}
headers = {
'Cache-Control': 'no-cache',
'Content-Type': 'application/json'
}
response = requests.request("GET", url, headers=headers, params=querystring)
print(response.text)
curl "https://talentup.io/api/cities/?api_key=YOUR_API_KEY"
The above command returns JSON structured like this:
{"data":
{"cities":
[
"Barcelona", "Madrid"
]
},
"status": 200,
"api_key":"Your api key"
}
This endpoint retrieves all cities available.
HTTP Request
GET http://talentup.io/api/cities
Position API
List available positions
import requests
url = "https://talentup.io/api/positions"
querystring = {
"api_key": "Your api key"
}
headers = {
'Cache-Control': 'no-cache',
'Content-Type': 'application/json'
}
response = requests.request("GET", url, headers=headers, params=querystring)
print(response.text)
curl "http://talentup.io/api/positions/?api_key=<YOUR_API_KEY>"
The above command returns JSON structured like this:
{
"data":{
"positions":[
"Human Resources Specialist", "Accounts Payable Specialist"
]
},
"status":200,
"api_key":"Your api key"
}
This request returns all available positions in the salary platform.
HTTP Request
GET http://talentup.io/api/positions/?api_key=<YOUR_API_KEY>
Talent Market API
Get Offer and Demand
import requests
url = "https://talentup.io/api/offer-demand"
querystring = {
"api_key": "Your api key",
"city": "Barcelona",
"position": "Frontend Developer"
}
headers = {
'Cache-Control': 'no-cache',
'Content-Type': 'application/json'
}
response = requests.request("GET", url, headers=headers, params=querystring)
print(response.text)
curl "https://talentup.io/api/offer-demand/?city=YourCity&position=Your%20Position"
The above command returns JSON structured like this:
{
"status": 200,
"api_key":"Your api key",
"data": {
"job_offers": 784,
"professionals": 10
}
}
This endpoint retrieves offer and demand for a position in a certain city.
HTTP Request
GET https://talentup.io/api/offer-demand/?city=<City>&position=<Position>
URL Parameters
Parameter | Description |
---|---|
City | Name of the city to extract the demand and offer from |
Position | Name of the position to extract the demand and offer from |
Salaries API
Salary Overview
import requests
url = "https://talentup.io/api/salaryOverview"
querystring = {
"api_key": "Your api key",
"city":"Barcelona",
"country":"Spain",
"position":"Frontend Developer"
}
headers = {
'Cache-Control': 'no-cache',
'Content-Type': 'application/json'
}
response = requests.request("GET", url, headers=headers, params=querystring)
print(response.text)
curl "http://talentup.io/api/salaryOverview/?api_key=<YOUR_API_KEY>&city=<CITY>&country=<COUNTRY>&position=<POSITION>"
The above command returns JSON structured like this:
{
"status": 200,
"api_key":"Your api key",
"data": {
"observations": 630,
"location": {
"city": "Barcelona",
"country": "Spain"
},
"position": "Frontend Developer",
"salary": 50000,
"currency":"EUR"
}
}
This request returns all available positions in the salary platform.
HTTP Request
GET http://talentup.io/api/salaryOverview/?api_key=<YOUR_API_KEY>&city=<CITY>&country=<COUNTRY>&position=<POSITION>
URL Parameters
Parameter | Description |
---|---|
City | Name of the city to extract the salary information from |
Country | Name of the country to extract the salary information from |
Position | Name of the position to extract the salary information from |
Errors
The TalentUp API uses the following error codes:
Error Code | Meaning |
---|---|
400 | Bad Request -- Your request is invalid. |
401 | Unauthorized -- Your API key is wrong. |
403 | Forbidden -- Your request is hidden for administrators only. |
404 | Not Found -- Your could not be found or gave 0 results. |
405 | Method Not Allowed -- Invalid method. |
406 | Not Acceptable -- You requested a format that isn't json. |
410 | Gone -- The request result has been removed from our servers. |
418 | I'm a teapot. |
429 | Too Many Requests -- Too many requests! Slow down! |
500 | Internal Server Error -- We had a problem with our server. Try again later. |
503 | Service Unavailable -- We're temporarily offline for maintenance. Please try again later. |