post https://api.explorium.ai/v1/prospects/events
Create events and fetch for businesses.
Endpoint: POST https://api.explorium.ai/v1/prospects/events
POST https://api.explorium.ai/v1/prospects/eventsPurpose:
Returns events on selected prospects.
Query Parameters
| Parameter | Values |
|---|---|
| event_types | See events table below |
| prospect_ids | Prospects ids |
| timestamp_from | Return only events that occurred after this timestamp. |
Events
| Event Type | Description |
|---|---|
| prospect_changed_role | Prospect has changed their role. |
| prospect_changed_company | Prospect has changed their company. |
| prospect_job_start_anniversary | Employee's workplace anniversary, marking the anniversary of the employee's start date at their company. |
Example Request (cURL):
curl -X POST \
"https://api.explorium.ai/v1/prospects/events" \
-H "API_KEY: your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"event_types": [
"prospect_changed_role",
"prospect_changed_company"
],
"prospect_ids": [
"https://linkedin.com/in/lauren-somerhalder",
"linkedin.com/in/jonsumroy",
"linkedin.com/in/elizabeth-pingpank-b483744",
"linkedin.com/in/oili-virta-31ab06177",
"linkedin.com/in/akshada-handge-494025200" ],
"timestamp_from": "2024-01-01T10:03:03.050Z"
}
'
Example Response:
{
"response_context": {
"correlation_id": "4666fecbbdaf45c6816f998a02fb67c2",
"request_status": "success",
"time_took_in_seconds": 0.515
},
"output_events": [
{
"event_name": "prospect_changed_role",
"event_time": "2024-04-01T00:00:00+00:00",
"event_id": "77689e89cba28f98bb92d2f08ce931f3",
"data": {
"event_name": "prospect_changed_role",
"current_company_name": "358 Helsinki",
"current_company_id": "4a84d3cf13d239dbc0c57b0a0070a896",
"current_job_title": "Junior Project Manager",
"previous_job_title": "Project Coordinator Trainee"
},
"prospect_id": "linkedin.com/in/oili-virta-31ab06177"
},
{
"event_name": "prospect_changed_company",
"event_time": "2024-06-01T00:00:00+00:00",
"event_id": "10f4a011c10112a6a986ff856107104c",
"data": {
"event_name": "prospect_changed_company",
"current_company_name": "Actalent",
"current_company_id": "97a52bce42dfc8f332fd534c4de8139f",
"current_job_title": "Aec Career Consultant / Recruiter",
"previous_company_name": "Koln/Kgin Tv 10/11 News",
"previous_company_id": "d8c9b663c31e377b0fdc80d156e66a06",
"previous_job_title": "Aec Career Consultant / Recruiter"
},
"prospect_id": "https://linkedin.com/in/lauren-somerhalder"
},
{
"event_name": "prospect_changed_company",
"event_time": "2024-07-01T00:00:00+00:00",
"event_id": "3f7e8cf51cfd522ff0cef2249772ec0c",
"data": {
"event_name": "prospect_changed_company",
"current_company_name": "Headovations",
"current_company_id": "23d794056048ff2bc8c6b3a4ecd223d1",
"current_job_title": "Vice President Of Business Development",
"previous_company_name": "Gods Gang",
"previous_company_id": "23d794056048ff2bc8c6b3a4ecd223d1",
"previous_job_title": "Vice President Of Business Development"
},
"prospect_id": "linkedin.com/in/jonsumroy"
}
]
}
Event Details
Employee job changes
| Signal Name | name | Type |
|---|---|---|
| Employee's previous job title | previous_job_title | TEXT |
| Employee left previous role timestamp | event_time | DATETIME |
| Employee's current job title | current_job_title | TEXT |
| Employee's current workplace | current_company_name | COMPANY |
| Current workplace entity ID | current_company_id | TEXT |
| Job change event ID | event_id | TEXT |
Recently changed company
| Signal Name | name | Type |
|---|---|---|
| New Company Name | current_company_name | TEXT |
| New Company ID | current_company_id | TEXT |
| New Job Title | current_job_title | TEXT |
| Previous Company Name | previous_company_name | TEXT |
| Previous Company ID | previous_company_id | TEXT |
| Previous Job Title | previous_job_title | TEXT |
| Company Change Date | event_id | DATETIME |
| Company Change Event ID | event_time | TEXT |
Employee's workplace anniversary
| Signal Name | name | Type |
|---|---|---|
| Employee's full name | full_name | TEXT |
| Employee event ID | event_id | TEXT |
| Workplace company name | company_name | TEXT |
| Number of years at company | years_at_company | NUMERIC |
| Employee's job title | job_title | TEXT |
| Employee event timestamp | job_anniversary_date | DATETIME |
| Workplace anniversary date | event_time | DATETIME |
| Employee LinkedIn URL | linkedin_url | URL |