V2 Prospects Profiles Enrich
curl --request POST \
--url https://api.explorium.ai/v2/prospects/profiles/enrich \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"prospect_ids": "<string>",
"request_context": null,
"parameters": {}
}
'import requests
url = "https://api.explorium.ai/v2/prospects/profiles/enrich"
payload = {
"prospect_ids": "<string>",
"request_context": None,
"parameters": {}
}
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({prospect_ids: '<string>', request_context: null, parameters: {}})
};
fetch('https://api.explorium.ai/v2/prospects/profiles/enrich', 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/enrich",
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([
'prospect_ids' => '<string>',
'request_context' => null,
'parameters' => [
]
]),
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/enrich"
payload := strings.NewReader("{\n \"prospect_ids\": \"<string>\",\n \"request_context\": null,\n \"parameters\": {}\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/enrich")
.header("api_key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"prospect_ids\": \"<string>\",\n \"request_context\": null,\n \"parameters\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.explorium.ai/v2/prospects/profiles/enrich")
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 \"prospect_ids\": \"<string>\",\n \"request_context\": null,\n \"parameters\": {}\n}"
response = http.request(request)
puts response.read_body{
"response_context": {
"correlation_id": "<string>",
"request_status": "success",
"time_taken_in_seconds": 123
},
"data": [
{
"prospect_id": "<string>",
"data": {
"full_name": "<string>",
"first_name": "<string>",
"last_name": "<string>",
"country_name": "<string>",
"region_name": "<string>",
"city": "<string>",
"linkedin": "<string>",
"experience": [
{}
],
"skills": [
"<string>"
],
"interests": [
"<string>"
],
"age_group": "<string>",
"education": [
{}
],
"gender": "male",
"company_name": "<string>",
"company_website": "<string>",
"company_linkedin": "<string>",
"job_department": "Real estate",
"job_department_array": [
"administration"
],
"job_department_main": "administration",
"job_seniority_level": "owner",
"job_level_array": [
"owner"
],
"job_level_main": "owner",
"job_title": "<string>",
"linkedin_url_array": [
"<string>"
]
}
}
],
"total_results": 123
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Sync
Profiles
POST
/
v2
/
prospects
/
profiles
/
enrich
V2 Prospects Profiles Enrich
curl --request POST \
--url https://api.explorium.ai/v2/prospects/profiles/enrich \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"prospect_ids": "<string>",
"request_context": null,
"parameters": {}
}
'import requests
url = "https://api.explorium.ai/v2/prospects/profiles/enrich"
payload = {
"prospect_ids": "<string>",
"request_context": None,
"parameters": {}
}
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({prospect_ids: '<string>', request_context: null, parameters: {}})
};
fetch('https://api.explorium.ai/v2/prospects/profiles/enrich', 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/enrich",
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([
'prospect_ids' => '<string>',
'request_context' => null,
'parameters' => [
]
]),
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/enrich"
payload := strings.NewReader("{\n \"prospect_ids\": \"<string>\",\n \"request_context\": null,\n \"parameters\": {}\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/enrich")
.header("api_key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"prospect_ids\": \"<string>\",\n \"request_context\": null,\n \"parameters\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.explorium.ai/v2/prospects/profiles/enrich")
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 \"prospect_ids\": \"<string>\",\n \"request_context\": null,\n \"parameters\": {}\n}"
response = http.request(request)
puts response.read_body{
"response_context": {
"correlation_id": "<string>",
"request_status": "success",
"time_taken_in_seconds": 123
},
"data": [
{
"prospect_id": "<string>",
"data": {
"full_name": "<string>",
"first_name": "<string>",
"last_name": "<string>",
"country_name": "<string>",
"region_name": "<string>",
"city": "<string>",
"linkedin": "<string>",
"experience": [
{}
],
"skills": [
"<string>"
],
"interests": [
"<string>"
],
"age_group": "<string>",
"education": [
{}
],
"gender": "male",
"company_name": "<string>",
"company_website": "<string>",
"company_linkedin": "<string>",
"job_department": "Real estate",
"job_department_array": [
"administration"
],
"job_department_main": "administration",
"job_seniority_level": "owner",
"job_level_array": [
"owner"
],
"job_level_main": "owner",
"job_title": "<string>",
"linkedin_url_array": [
"<string>"
]
}
}
],
"total_results": 123
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Introduction
The Professional Profile Contact and Workplace Enrichments API provides comprehensive professional details about a prospect, including job history, company affiliations, skills, education, and workplace details. This endpoint is designed to enhance prospect intelligence, streamline recruitment efforts, and improve sales and marketing strategies. Key Benefits:- Access detailed career history, including past and present job roles.
- Retrieve company affiliations and workplace insights.
- Analyze skills and expertise for targeted outreach.
- Gain educational background to understand professional qualifications.
- Improve lead scoring and personalization in sales and marketing campaigns.
Endpoint: POST /prospects/profiles/enrich
v2: this endpoint accepts either a single ID (a string) or a list of up to 50 IDs — the separate
/bulk_enrich route is gone. See v2 conventions.How It Works
How It Works
- Input: Provide a
prospect_id(retrieved from the Match Prospects endpoint) to fetch professional details. - Processing: The system gathers professional data from multiple sources and structures it.
- Output: A response containing job history, workplace affiliations, skills, and education details.
Request Schema
Request Schema
| Field | Type | Description |
|---|---|---|
prospect_id | String | A unique identifier for the prospect (Required) |
Best Practices
Best Practices
- Use verified prospect IDs to ensure accurate data enrichment.
- Leverage job history and expertise for recruitment and lead scoring.
- Incorporate workplace insights into sales and marketing automation.
- Analyze skills and education to personalize communication and engagement.
- Cross-check company affiliations for networking and partnership opportunities.
Professional Profile Contact and Workplace Output Signal
Professional Profile Contact and Workplace Output Signal
| 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 | URN 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 | 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 | 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_id: ee936e451b50c70e068e1b54e106cb89173198c4
Authorizations
APIKeyHeaderAPIKeyHeader
Body
application/json
Was this page helpful?