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:

  {
    "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
}

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
}

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&api_key=<YOUR_API_KEY>"

The above command returns JSON structured like this:

{
    "status": 200, 
    "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

Get Job Offers

import requests

url = "https://talentup.io/api/jobs"

querystring = {
    "api_key": "Your api key",
    "city": "London",
    "country":"United Kingdom",
    "position": "Frontend Developer"
    "created_at":"2022-05-26T00:00:00",
    "page":"1"

}
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/jobs/?city=Manchester&country=United%20Kingdom&created_at=2022-01-01T00:00:00&page=1&api_key=YourApiKey"

The above command returns JSON structured like this:

{
    "status": 200,
    "data": {
        "jobs": [{
            "position": {
                "subdepartment": null,
                "department": null,
                "name": "Associate Practitioner",
                "role": null,
                "family": null
            },
            "tags": {
                "tech": [],
                "secondary_tech": null
            },
            "salary": {
                "period": "year",
                "value": 23715,
                "currency": "GBP",
                "EUR": {
                    "value": 27833
                },
                "bonus": {
                    "percentage": null,
                    "value": null,
                    "EUR": {
                        "value": null
                    },
                    "sign-on": {
                        "value": null,
                        "EUR": {
                            "value": null
                        }
                    },
                    "referral": {
                        "value": null,
                        "EUR": {
                            "value": null
                        }
                    }
                },
                "min": 22549,
                "max": 24882
            },
            "source": "monster",
            "skills": null,
            "location": {
                "country": "United Kingdom",
                "continent": "Europe",
                "region": "East of England",
                "city": "Harlow",
                "coordinates": {
                    "lat": "51.77655",
                    "lon": "0.11158"
                },
                "raw": "Harlow"
            },
            "created_at": "2021-12-12T22:39:04.884685",
            "company": "National Health Service",
            "company_details": {
                "size": null,
                "raw": "National Health Service",
                "sector": null,
                "is_recruitment_agency": null
            }
        }]
    }
}

This endpoint retrieves job offers for a position given a timestamp and a location.

HTTP Request

GET https://talentup.io/api/jobs/?city=<City>&position=<Position>&country=<Country>&created_at=<Timestamp>&page=<PageNumber>&api_key=<YourApiKey>

URL Parameters

Parameter Description
City Name of the city to extract the demand and offer from (optional)
Position Name of the position to extract the demand and offer from (optional)
Country Name of the country to extract the demand and offer from (locked to United Kingdom)
Created_at All the job offers returned will have been created after this timestamp
Page Pagination of the results (defaults to 0)

Get Professionals

import requests

url = "https://talentup.io/api/professionals"

querystring = {
    "api_key": "Your api key",
    "city": "London",
    "country":"United Kingdom",
    "position": "Frontend Developer"
    "updated_at":"2022-05-26T00:00:00",
    "page":"1"

}
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/professionals/?city=London&position=Frontend%20Developer&country=United%20Kingdom&updated_at=2022-01-01T00:00:00&page=1&api_key=YourApiKey"

The above command returns JSON structured like this:

{
    "status": 200,
    "data": {
        "professionals": [{
            "position": {
                "company": {
                    "is_recruitment_agency": null,
                    "name": "Genesys",
                    "size": "5001-10000",
                    "sector": "Information Technology",
                    "raw": "Genesys",
                    "funding": {
                        "EUR": {
                            "value": 777460554
                        }
                    },
                    "id": null
                },
                "role": "First-Line Supervisors of Non-Retail Sales Workers",
                "raw": "QA Director",
                "family": "Sales and Related",
                "name": "Director"
            },
            "location": {
                "continent": "Europe",
                "raw": "frimley, surrey, united kingdom",
                "coordinates": {
                    "lon": "-0.74544",
                    "lat": "51.31667"
                },
                "country": "United Kingdom",
                "city": "Frimley"
            }
        }]
    }
}

This endpoint retrieves job offers for a position given a timestamp and a location.

HTTP Request

GET https://talentup.io/api/professionals/?city=<City>&position=<Position>&country=<Country>&updated_at=<Timestamp>&page=<PageNumber>&api_key=<YourApiKey>

URL Parameters

Parameter Description
City Name of the city to extract the demand and offer from (optional)
Position Name of the position to extract the demand and offer from (optional)
Country Name of the country to extract the demand and offer from (locked to United Kingdom)
Updated_at All the job offers returned will have been updated after this timestamp
Page Pagination of the results (defaults to 0)

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,
    "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.