Skip to main content
POST
/
v1
/
prospects
/
events
Fetch Prospects Events
curl --request POST \
  --url https://api.explorium.ai/v1/prospects/events \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '{
  "request_context": {},
  "entity_type": "business",
  "event_types": [
    "prospect_changed_role"
  ],
  "event_data_parameters": [
    {}
  ],
  "timestamp_to": "2023-11-07T05:31:56Z",
  "timestamp_from": "2024-01-01T00:00:00+00:00",
  "prospect_ids": [
    "<string>"
  ]
}'
"<any>"

​
Introduction

The Prospect Events API provides insights into recent events related to selected prospects, including job changes, company transitions, and professional anniversaries. These insights are essential for timely engagement, personalized outreach, and tracking career movements. Key Benefits:
  • Track real-time career movements of prospects.
  • Identify engagement opportunities based on job changes.
  • Enhance lead nurturing by targeting prospects during career transitions.
  • Integrate with CRM and sales platforms for automated alerts.
Important: Events API tracks only recent events within the last quarter (3 months). If no relevant events occurred in this timeframe, no data will be returned. Looking for historical data? Use the Prospect Enrichment API to retrieve long-term career and engagement trends.

​
Endpoint: POST https://api.explorium.ai/v1/prospects/events

  1. Input: Provide a list of prospect IDs and event types.
  2. Processing: The system retrieves relevant event details.
  3. Output: A structured response with matched prospect events.
ParameterTypeDescription
event_typesArrayList of event types to filter results. See event types below.
prospect_idsArrayList of prospect IDs to track.
timestamp_fromStringReturn only events that occurred after this timestamp.
Event TypeDescription
prospect_changed_roleProspect has changed their role.
prospect_changed_companyProspect has changed their company.
prospect_job_start_anniversaryEmployee’s workplace anniversary, marking the anniversary of the employee’s start date at their company.

​
Example Request (cURL)

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": [
        "20ae6cbf564ee683e66685e429844a5ff8ffc30f",
    "4c485f009d59e319dc039cdf3e935b85014e6a33",
    "fd4c46716295a2e4731417eee802a883280e4d57",
    "a7bbe0674c63338e62ae4c10751ae19da5723e5a"
  ],
  "timestamp_from": "2024-01-01T10:03:03.050Z"
}
'

​
Example Response

JSON
{
  "response_context": {
    "correlation_id": "2826dd3eca6b4625aeddc30a3b96e11d",
    "request_status": "success",
    "time_took_in_seconds": 0.931
  },
  "output_events": [
    {
      "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": "4c485f009d59e319dc039cdf3e935b85014e6a33"
    },
    {
      "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": "20ae6cbf564ee683e66685e429844a5ff8ffc30f"
    }
  ]
}
  • Monitor career movements to enhance engagement strategies.
  • Leverage anniversaries for personalized outreach.
  • Refine search criteria to track only relevant prospects.
  • Utilize automation to integrate prospect event tracking into CRM workflows.
  • Combine with enrichment data to build a full profile of each prospect.

Authorizations

​
api_key
string
header
required

Body

application/json
​
event_types
enum<string>[]
required
Minimum length: 1
​
prospect_ids
string[]
required
Required array length: 1 - 40 elements
​
request_context
object
​
entity_type
enum<string>
default:prospect

The EntityType class is an enumeration that defines the types of entities.

This enum is used to specify whether the entity is a business or a prospect. It ensures consistent handling of entity types across the application.

Attributes: BUSINESS: Represents a business entity. PROSPECT: Represents a prospect entity.

Available options:
business,
prospect
​
event_data_parameters
BaseEventParameter · object[]
​
timestamp_to
​
timestamp_from

ISO format datetime string or date in format YYYY-MM-DD

Examples:

"2024-01-01T00:00:00+00:00"

"2024-01-22"

Response

Successful Response

The response is of type any.

⌘I