Business Events

Endpoint: `POST /businesses/events`

Description

The Fetch 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 in timestamp_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.

Coverage

Attribute	Coverage Details
Total Events	Covers thousands of business-related events monthly
Event Categories	Includes funding, IPOs, product launches, partnerships, hiring trends, and more
Geographical Scope	Global coverage across 150+ countries
Data Refresh Rate	Updated in near real-time

How It Works

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.

Query Parameters

Parameter	Type	Description
`event_types`	Array	Filters events by type (e.g. `ipo_announcement`, `new_funding_round`, `new_investment`, `new_product`, `new_office`)
`business_ids`	Array	Returns events related to specific businesses using their Business IDs
`timestamp_from`	String	Filters results to show only events after a specific timestamp (ISO format)

Example Request (cURL)

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"
  ]
}'

Example Response

{
  "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"
    }
  ]
}

Best Practices

Use targeted queries by specifying event_types to reduce unnecessary data retrieval.
Combine business_ids with timestamp_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.

Event Categories

Funding & Investment

IPO Announcement - Initial Public Offering announcement
New Funding Round - Announcement of a new funding round
New Investment - Announcement of a new investment

Product & Business Growth

New Product Launch - Launch of a new product
New Office Opening - Opening of a new office
Office Closing - Closing of a company's office
Company's Award - Recognition of a company's achievements and accolades

Partnerships & Mergers

New Partnership - Announcement of a new partnership
Merger and Acquisitions - Tracks major M&A activity

Hiring & Workforce Trends

Hiring (per department) - Hiring by Department
Department trend (per department) - Workforce Changes by Department
Employee Joined Company - Announcement of a new employee joining the company

Legal & Security Issues

Lawsuits and Legal Issues - Tracks legal challenges and regulatory issues
Outages and Security Breaches - Identifies major disruptions and cybersecurity incidents

Financial Adjustments

Cost Cutting - Tracks significant cost reduction measures

📌 Explore the sections above for more details on filtering options and advanced query examples.

Body Params - Try Me Example

event_types: ipo_announcement, new_investment
business_ids: 8adce3ca1cef0c986b22310e369a0793

Endpoint: POST /businesses/events