NAV
shell python

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.