Quickstart - Skill Enrichment API

A fast hands-on introduction to the Skill Enrichment API

Getting Started

In order to use our Skill Enrichment API, you must have an active API key. You can look up your API key by logging into our self-serve dashboard and going to the API Keys section.


Need an API Key?

If you don't have an API key, you can easily create one by signing up for a self-serve account. Check out our Self-Serve Quickstart Guide, which walks you through the sign-up process as well as how to use the self-serve API dashboard.

Simple Example

As mentioned in the Overview, the Skill Enrichment API is a way to perform a one-to-one match of a skill with those included in our Skill Dataset. In order to use the Skill Enrichment API, you will need the skill that you want to look up.

Here's a quick example that demonstrates retrieving a record with a skill of ai:

import requests

url = "https://api.peopledatalabs.com/v5/skill/enrich"

query_string = {"skill": "ai"}

headers = {
    'accept': "application/json",
    'content-type': "application/json",
    'x-api-key': "YOUR_API_KEY"

response = requests.request("GET", url, headers=headers, params=query_string)

curl -X GET -G \
  'https://api.peopledatalabs.com/v5/skill/enrich' \
  -H 'X-Api-Key: YOUR API KEY' \
  --data-urlencode 'skill=ai'

The response returned is a job title record if the skill passed exists in our dataset:

  "cleaned_skill": "ai",
  "similar_skills": [
    "machine learning",
    "artificial intelligence",
    "deep learning",
    "data science",
  "relevant_job_titles": [
    "data scientist",
    "software engineer",
    "senior data scientist",
    "chief technology officer",
    "senior software engineer"

If you don't get this response, check out our errors page for more information.

Did this page help you?