Prospects Profiles Job
curl --request POST \
--url https://api.explorium.ai/v2/prospects/profiles/job \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"list_id": "<string>",
"notifications": {
"email": {
"enabled": true,
"on": []
}
}
}
'import requests
url = "https://api.explorium.ai/v2/prospects/profiles/job"
payload = {
"list_id": "<string>",
"notifications": { "email": {
"enabled": True,
"on": []
} }
}
headers = {
"api_key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({list_id: '<string>', notifications: {email: {enabled: true, on: []}}})
};
fetch('https://api.explorium.ai/v2/prospects/profiles/job', 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.explorium.ai/v2/prospects/profiles/job",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'list_id' => '<string>',
'notifications' => [
'email' => [
'enabled' => true,
'on' => [
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"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"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.explorium.ai/v2/prospects/profiles/job"
payload := strings.NewReader("{\n \"list_id\": \"<string>\",\n \"notifications\": {\n \"email\": {\n \"enabled\": true,\n \"on\": []\n }\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("api_key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.explorium.ai/v2/prospects/profiles/job")
.header("api_key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"list_id\": \"<string>\",\n \"notifications\": {\n \"email\": {\n \"enabled\": true,\n \"on\": []\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.explorium.ai/v2/prospects/profiles/job")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["api_key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"list_id\": \"<string>\",\n \"notifications\": {\n \"email\": {\n \"enabled\": true,\n \"on\": []\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"job_id": "<string>",
"status": "<string>",
"status_url": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Async
Profiles (async)
POST
/
v2
/
prospects
/
profiles
/
job
Prospects Profiles Job
curl --request POST \
--url https://api.explorium.ai/v2/prospects/profiles/job \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"list_id": "<string>",
"notifications": {
"email": {
"enabled": true,
"on": []
}
}
}
'import requests
url = "https://api.explorium.ai/v2/prospects/profiles/job"
payload = {
"list_id": "<string>",
"notifications": { "email": {
"enabled": True,
"on": []
} }
}
headers = {
"api_key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({list_id: '<string>', notifications: {email: {enabled: true, on: []}}})
};
fetch('https://api.explorium.ai/v2/prospects/profiles/job', 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.explorium.ai/v2/prospects/profiles/job",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'list_id' => '<string>',
'notifications' => [
'email' => [
'enabled' => true,
'on' => [
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"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"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.explorium.ai/v2/prospects/profiles/job"
payload := strings.NewReader("{\n \"list_id\": \"<string>\",\n \"notifications\": {\n \"email\": {\n \"enabled\": true,\n \"on\": []\n }\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("api_key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.explorium.ai/v2/prospects/profiles/job")
.header("api_key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"list_id\": \"<string>\",\n \"notifications\": {\n \"email\": {\n \"enabled\": true,\n \"on\": []\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.explorium.ai/v2/prospects/profiles/job")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["api_key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"list_id\": \"<string>\",\n \"notifications\": {\n \"email\": {\n \"enabled\": true,\n \"on\": []\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"job_id": "<string>",
"status": "<string>",
"status_url": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Deprecated response fields:
job_department and job_seniority_level are deprecated and will be removed in a future release. Read job_department_main / job_department_array and job_level_main / job_level_array instead. (The job_department filter is not affected.)Description
The Asynchronous Professional Profile Enrichment API provides detailed professional and workplace insights for up to 10,000 prospects in a single request. This endpoint enables deep analysis of career history, education, and workplace affiliations. Key Benefits:- Retrieve bulk professional profiles including job history, skills, and education.
- Enhance recruiting and sales efforts with verified workplace details.
- Optimize segmentation and outreach using structured career insights.
Asynchronous variant. This submits a job through the async job infrastructure — poll job status for progress and results. Input comes from an uploaded dataset (
list_id); limits are 10,000 rows and a 24-hour run time.For the full output signal reference, see the synchronous endpoint.How It Works
How It Works
- Input: Provide up to 10,000
prospect_idvalues, obtained from the Match Prospects endpoint. - Processing: The system retrieves verified professional details, including job history, education, and workplace affiliations.
- Output: Returns structured data in the same order as the input, ensuring easy mapping.
Request Schema
Request Schema
| Field | Type | Description |
|---|---|---|
list_id | String | Identifier of an uploaded entity ID dataset (Required) |
Example Request (cURL)
Example Request (cURL)
Bash
curl --request POST \
--url https://api.explorium.ai/v2/prospects/profiles/job \
--header 'accept: application/json' \
--header 'api_key: <your api key>' \
--header 'content-type: application/json' \
--data '{
"prospect_ids": [
"ee936e451b50c70e068e1b54e106cb89173198c4",
"d668424ab4f6aaeeeb74248d56b8335383fd522b"
]
}'
Example Response
Example Response
JSON
{
"response_context": {
"correlation_id": "6f7eeca192604c73ae5b5a07671ba438",
"request_status": "success",
"time_taken_in_seconds": 0.454
},
"data": [
{
"prospect_id": "ee936e451b50c70e068e1b54e106cb89173198c4",
"data": {
"full_name": "Satya Nadella",
"country_name": "united states",
"region_name": "washington",
"city": "seattle",
"linkedin": "https://linkedin.com/in/ACoAAAEkwwAB9KEc2TrQgOLEQ-vzRyZeCDyc6DQ",
"experience": [
{
"company": {
"name": "university of chicago",
"website": "uchicago.edu"
},
"title": {
"levels": [
null
],
"name": "member board of trustees"
},
"start_date": "2018-01",
"is_primary": false
},
{
"company": {
"name": "fred hutch",
"website": "fredhutch.org"
},
"title": {
"levels": [
"director"
],
"name": "board member"
},
"start_date": "2016-01",
"end_date": "2022-01"
},
{
"company": {
"name": "microsoft",
"website": "microsoft.com"
},
"title": {
"levels": [
"cxo"
],
"name": "chairman and chief executive officer"
},
"start_date": "2014-02",
"is_primary": true
},
{
"company": {
"name": "starbucks",
"website": "starbucks.com"
},
"title": {
"levels": [
"director"
],
"name": "board member"
},
"start_date": "2017-01",
"end_date": "2024-01"
},
{
"company": {
"name": "the business council us",
"website": "thebusinesscouncil.org"
},
"title": {
"levels": [
"cxo"
],
"name": "chairman"
},
"start_date": "2021-01",
"end_date": "2023-01"
}
],
"skills": null,
"interests": null,
"age_group": "41-50",
"education": [
{
"degrees": [
"masters degree"
],
"majors": [
"computer science"
],
"minors": [],
"school": {
"name": "university of wisconsin milwaukee"
}
},
{
"start_date": "1994",
"end_date": "1996",
"minors": [],
"school": {
"name": "the university of chicago booth school of business"
}
},
{
"degrees": [
"bachelors degree"
],
"majors": [
"electrical engineering"
],
"minors": [],
"school": {
"name": "manipal institute of technology"
}
}
],
"gender": "male",
"company_name": "Microsoft",
"company_website": "https://microsoft.com",
"company_linkedin": "https://www.linkedin.com/company/microsoft",
"job_department": null,
"job_department_array": [
"c-suite"
],
"job_department_main": "c-suite",
"job_seniority_level": "cxo",
"job_level_array": [
"c-suite"
],
"job_level_main": "c-suite",
"job_title": "Chairman And Chief Executive Officer",
"linkedin_url_array": [
"https://linkedin.com/in/acoaaaekwwab9kec2trqgoleq-vzryzecdyc6dq",
"https://linkedin.com/in/satyanadella"
]
}
},
{
"prospect_id": "d668424ab4f6aaeeeb74248d56b8335383fd522b",
"data": {
"full_name": "Jensen Huang",
"country_name": "united states",
"region_name": "california",
"city": "los altos hills",
"linkedin": "https://linkedin.com/in/ACoAABMznFkB_XPgkYHnUl33kIHTWt1DtMAV6Pg",
"experience": [
{
"company": {
"name": "nvidia",
"website": "nvidia.com"
},
"title": {
"levels": [
"cxo"
],
"name": "founder and chief executive officer"
},
"start_date": "1993-01",
"is_primary": true
},
{
"company": {
"name": "dennys",
"website": "dennys.com"
},
"title": {
"levels": [
null
],
"name": "dishwasher, busboy, waiter"
},
"start_date": "1978-01",
"end_date": "1983-01"
}
],
"skills": [
"management"
],
"interests": null,
"age_group": "61-70",
"education": [
{
"degrees": [
"bsee"
],
"start_date": "1980",
"end_date": "1984",
"minors": [],
"school": {}
},
{
"degrees": [
"msee"
],
"start_date": "1990",
"end_date": "1992",
"minors": [],
"school": {}
}
],
"gender": "male",
"company_name": "Nvidia",
"company_website": "https://nvidia.com",
"company_linkedin": "https://www.linkedin.com/company/nvidia",
"job_department": null,
"job_department_array": [
"c-suite"
],
"job_department_main": "c-suite",
"job_seniority_level": "cxo",
"job_level_array": [
"c-suite",
"founder"
],
"job_level_main": "c-suite",
"job_title": "Founder And Chief Executive Officer",
"linkedin_url_array": [
"https://linkedin.com/in/acoaabmznfkb_xpgkyhnul33kihtwt1dtmav6pg",
"https://linkedin.com/in/jenhsunhuang"
]
}
}
],
"total_results": 2
}
Best Practices
Best Practices
- Ensure valid prospect IDs to maximize data accuracy.
- Use enriched profiles to refine candidate selection and outreach.
- Monitor career movements to track professional growth trends.
- Leverage structured education and skills data for talent and partnership analysis.
Asynchronous Professional Profile Output Signals
Asynchronous Professional Profile Output Signals
| Signal | API Name | Description | Data Type Final |
|---|---|---|---|
| gender | Individual’s gender | Gender reported by the individual on their profile. If gender is not reported on profile, returned value is ‘null’. | string |
| city | Individual’s city of residence | Individual’s city of residence reported on profile. | string |
| country_name | Individual’s country of residence | Individual’s country of residence reported on profile. | string |
| region_name | Individual’s State / Region of residence | Individual’s state or region of residence reported on profile. | string |
| company_website | Individual’s workplace: company website | URL to the company website belonging to the individual’s workplace. | string |
| company_linkedin | Individual’s workplace: company LinkedIn® url | URL to the company LinkedIn® page belonging to the individual’s workplace. | string |
| Individual’s LinkedIn® URL | URL of the individual’s LinkedIn® profile. | url | |
| linkedin_url_array | LinkedIn® Identifier Array | A list of LinkedIn® profile URLs associated with the prospect. Each entry may include a standard public URL and/or a URN-based URL. | array[string] |
| age_group | Individual’s age group | Individual’s estimated age group. | string |
| experience | Individual’s work experience background | List of work experience background entries on the individual’s profile. May include: company name, company website, job title, seniority level, role, start date, end date, and more. Includes current work experience activities if listed. | array |
| education | Individual’s educational background | List of educational background entries on the individual’s profile. May include: institutions name, institutions website, degree category, major, start date, end date, and more. Includes current educational activities if listed. | array |
| interests | Individual’s interests | List of all interests reported by the individual on their profile. | array |
| skills | Individual’s skills | List of all skills reported by the individual on their profile. | array |
| job_title | Individual’s job title | Individual’s current job title listed on their professional profile. | string |
| job_department | Individual’s job department | Deprecated — use job_department_main / job_department_array instead. Individual’s job department, derived from their current job title. | object |
| job_department_array | Job Department (Array) | All detected normalized job departments for the individual. Examples: retail, engineering, customer success, administration, education, security, healthcare, public service, partnerships, creative, strategy, real estate, procurement, IT, data, c-suite, manufacturing, support, logistics, product, sales, design, marketing, finance, R&D, trade, human resources, legal, operations. | array<string> |
| job_department_main | Job Department (Main) | Primary normalized job department selected from the detected departments (e.g., “engineering”). Examples of possible values: retail, engineering, customer success, administration, education, security, healthcare, public service, partnerships, creative, strategy, real estate, procurement, IT, data, c-suite, manufacturing, support, logistics, product, sales, design, marketing, finance, R&D, trade, human resources, legal, operations. | string |
| job_seniority_level | Individual’s seniority level | Deprecated — use job_level_main / job_level_array instead. Individual’s top seniority level, derived from their current job title. | object |
| job_level_array | Job Level (Array) | All detected normalized job levels for the individual. Examples: manager, president, senior manager, owner, advisor, freelancer, junior, director, c-suite, board member, senior non-managerial, non-managerial, partner, vice president, founder. | array<string> |
| job_level_main | Job Level (Main) | Primary normalized job level selected from the detected levels (e.g., “senior non-managerial”). Examples of possible values: manager, president, senior manager, owner, advisor, freelancer, junior, director, c-suite, board member, senior non-managerial, non-managerial, partner, vice president, founder. | string |
| company_name | Individual’s workplace: company name | Name of the company the individual listed as their workplace. | string |
| full_name | Individual’s full name | First and last names associated with the individual, appended with a space. | string |
Body Params - Try Me Example
prospect_ids: ee936e451b50c70e068e1b54e106cb89173198c4,
57f9e5dac64d31d80e6e9432fe2c500d0bba2c01
Authorizations
APIKeyHeaderAPIKeyHeader
Body
application/json
Was this page helpful?