Skip to main content
POST
/
v1
/
businesses
/
events
Fetch Businesses Events
curl --request POST \
  --url https://api.explorium.ai/v1/businesses/events \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "event_types": [
    "ipo_announcement"
  ],
  "business_ids": [
    "<string>"
  ],
  "request_context": null,
  "entity_type": "business",
  "timestamp_to": null,
  "timestamp_from": null
}
'
{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

​
Description

The Business Events endpoint delivers timely insights into key business activities, such as funding rounds, IPOs, product launches, hiring trends, office openings and more. This enables users to monitor industry shifts, analyze market dynamics, and make informed decisions based on recent developments. Each event provides a snapshot of real-time changes occurring within businesses, offering valuable intelligence on company growth, strategic moves, and workforce fluctuations.

​
Important Considerations for Event

  • Events are limited to recent occurrences and are available only within the timeframe defined intimestamp_from , which should be set to the last quarter (past 3 months).
  • If no qualifying events took place in the specified period, the response will be empty.
  • This API does not provide historical records. To access past data, refer to the appropriate Enrichment API endpoints.
AttributeCoverage Details
Total EventsCovers thousands of business-related events monthly
Event CategoriesIncludes funding, IPOs, product launches, partnerships, hiring trends, and more
Geographical ScopeGlobal coverage across 150+ countries
Data Refresh RateUpdated in near real-time
  • Input: Define filter parameters such as event_types, business_ids, and timestamp_from.
  • Processing: The system retrieves relevant business events from its real-time data sources.
  • Output: A structured response containing event details, including timestamps, descriptions, and business associations.
ParameterTypeDescription
event_typesArrayFilters events by type (e.g. ipo_announcement, new_funding_round, new_investment, new_product, new_office)
business_idsArrayReturns events related to specific businesses using their Business IDs
timestamp_fromStringFilters results to show only events after a specific timestamp (ISO format)
Bash
curl -X POST \
  "https://api.explorium.ai/v1/businesses/events" \
  -H "API_KEY: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "event_types": [
    "ipo_announcement",
    "new_investment"
  ],
  "business_ids": [
    "8adce3ca1cef0c986b22310e369a0793"
  ]
}'
JSON
{
  "response_context": {
    "correlation_id": "e96ef2125e0d45568f370cee53428106",
    "request_status": "success",
    "time_took_in_seconds": 4.299
  },
  "output_events": [
    {
      "event_name": "new_investment",
      "event_time": "2025-01-20T00:00:00+00:00",
      "event_id": "60392c31a409901d75d071565d09dda4",
      "data": {
        "event_name": "new_investment",
        "investment_date": "2025-01-20T00:00:00+00:00",
        "investment_amount": 430000013312,
        "investment_target": "United States",
        "investment_type": "Strategic Investment",
        "link": "https://www.businesstimes.com.sg/international/trump-says-apple-ceo-make-large-investment-us"
      },
      "business_id": "8adce3ca1cef0c986b22310e369a0793"
    }
  ]
}
  • Use targeted queries by specifying event_types to reduce unnecessary data retrieval.
  • Combinebusiness_ids withtimestamp_from for precise event tracking.
  • Monitor new event types as the dataset is continually updated.
  • Leverage analytics tools to extract actionable insights and refine business strategies.

​
Funding & Investment

​
Product & Business Growth

​
Partnerships & Mergers

​
Financial Adjustments

For detailed endpoint explanations, request examples, and integration tips, explore the documentation sections above.

​
Body Params - Try Me Example

event_types: ipo_announcement, new_investment
business_ids: 8adce3ca1cef0c986b22310e369a0793

Authorizations

​
api_key
string
header
required

Body

application/json
​
event_types
enum<string>[]
required
Minimum array length: 1

Enumeration of business-related event identifiers.

This enum defines various types of events associated with businesses, such as:

  • Financial activities (e.g., IPO announcements, new funding rounds, new investments)
  • Organizational changes (e.g., new offices, closing offices, mergers and acquisitions)
  • Workforce trends (e.g., hiring in specific departments, increases or decreases in department sizes)
  • Product and partnership updates (e.g., new products, new partnerships)
  • Other significant events (e.g., company awards, outages, cost-cutting measures, legal issues)

These identifiers are used to categorize and track business events within the application.

Available options:
ipo_announcement,
new_funding_round,
new_investment,
new_product,
new_office,
closing_office,
new_partnership,
increase_in_engineering_department,
increase_in_sales_department,
increase_in_marketing_department,
increase_in_operations_department,
increase_in_customer_service_department,
increase_in_all_departments,
decrease_in_engineering_department,
decrease_in_sales_department,
decrease_in_marketing_department,
decrease_in_operations_department,
decrease_in_customer_service_department,
decrease_in_all_departments,
employee_joined_company,
hiring_in_creative_department,
hiring_in_education_department,
hiring_in_engineering_department,
hiring_in_finance_department,
hiring_in_health_department,
hiring_in_human_resources_department,
hiring_in_legal_department,
hiring_in_marketing_department,
hiring_in_operations_department,
hiring_in_professional_service_department,
hiring_in_sales_department,
hiring_in_support_department,
hiring_in_trade_department,
hiring_in_unknown_department,
company_award,
outages_and_security_breaches,
cost_cutting,
merger_and_acquisitions,
lawsuits_and_legal_issues
​
business_ids
string[]
required
Required array length: 1 - 40 elements
​
request_context
Request Context · object
Example:

null

​
entity_type
enum<string>
default:business

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
​
timestamp_to

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

Example:

null

​
timestamp_from

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

Example:

null

Response

Successful Response