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.
Coverage
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
How It Works
- Input: Define filter parameters such as
event_types
,business_ids
, andtimestamp_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
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)
Example Request (cURL)
Bash
Example Response
Example Response
JSON
Best Practices
Best Practices
- 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.
Event Categories
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
Body Params - Try Me Example
Authorizations
Body
application/json
Minimum length:
1
Required array length:
1 - 40
elementsThe 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
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
.