post https://api.explorium.ai/v1/prospects/match
Match a list of prospects attributes to ids.
Returns a list of the same length and order as the input list, with the matched ids.
Endpoint: POST /prospects/match
POST /prospects/match
Purpose:
Matches lead prospect records based on provided identifiers such as email, phone number, LinkedIn profile, or name + company.
Request Schema
Field | Type | Description |
---|---|---|
prospects_to_match: | ||
String | The prospect’s email address | |
phone_number | String | The prospect’s phone number |
full_name | String | The prospect’s full name (can only be used together with company_name) |
company_name | String | The prospect’s company name (can only be used together with full_name) |
String | Linkedin url | |
business_id (optional) | String | Filters the prospect to match the given business id |
* full_name must be accompanied with company_name
Example Request (cURL):
curl -X POST "https://api.explorium.ai/v1/prospects/match" \
-H "API_KEY: your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"request_context": {
"seller_id": "sample_seller"
},
"prospects_to_match": [
{
"linkedin": "https://www.linkedin.com/in/russell-lumpkin-07585b128",
"business_id": "19fbe842a2e51db95d4f92333f2cc63a"
},
{
"linkedin": "https://www.linkedin.com/in/russell-sadfdsf",
"business_id": "19fbe842a2e51db95d4f92333f2cc63a"
},
{
"linkedin": "https://linkedin.com/in/lauren-somerhalder",
"business_id": "19fbe842a2e51db95d4f92333f2cc63a"
}
]
}
'
Example Response:
{
"response_context": {
"correlation_id": "8e6cd5c8de2d4b2faf10198ebf341c21",
"request_status": "success",
"time_took_in_seconds": 0.97
},
"total_results": 3,
"total_matches": 1,
"matched_prospects": [
{
"input": {
"business_id": "19fbe842a2e51db95d4f92333f2cc63a",
"linkedin": "https://www.linkedin.com/in/russell-lumpkin-07585b128"
},
"prospect_id": "6ffd52c681452e2da8aac7ec3efb174f4604734c"
},
{
"input": {
"business_id": "19fbe842a2e51db95d4f92333f2cc63a",
"linkedin": "https://www.linkedin.com/in/russell-sadfdsf"
},
"prospect_id": null
},
{
"input": {
"business_id": "19fbe842a2e51db95d4f92333f2cc63a",
"linkedin": "https://linkedin.com/in/lauren-somerhalder"
},
"prospect_id": null
}
]
}