Create events and fetch for businesses.

Endpoint: POST /businesses/events

Purpose:

Retrieves recent business-related events, such as funding rounds, new office openings, and job market shifts.

Query Parameters:

ParameterValues
event_typesipo_announcement, new_funding_round, new_investment, new_product, new_office, etc.
business_idsList of business IDs
timestamp_fromReturn only events that occurred after this timestamp.

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"
  ],
  "timestamp_from": "2024-01-01T10:03:03.050Z"
}
'

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

Events (Businesses)

Event TypeDescription
ipo_announcementInitial Public Offering announcement
new_funding_roundAnnouncement of a new funding round
new_investmentAnnouncement of a new investment
new_productLaunch of a new product
new_officeOpening of a new office
closing_officeClosure of an office
new_partnershipAnnouncement of a new partnership
increase_in_engineering_departmentAnnouncement of an increase in the engineering department
increase_in_sales_departmentAnnouncement of an increase in the sales department
increase_in_marketing_departmentAnnouncement of an increase in the marketing department
increase_in_operations_departmentAnnouncement of an increase in the operations department
increase_in_customer_service_departmentAnnouncement of an increase in the customer service department
increase_in_all_departmentsAnnouncement of an increase across all departments
decrease_in_engineering_departmentAnnouncement of a decrease in the engineering department
decrease_in_sales_departmentAnnouncement of a decrease in the sales department
decrease_in_marketing_departmentAnnouncement of a decrease in the marketing department
decrease_in_operations_departmentAnnouncement of a decrease in the operations department
decrease_in_customer_service_departmentAnnouncement of a decrease in the customer service department
decrease_in_all_departmentsAnnouncement of a decrease across all departments
employee_joined_companyAnnouncement of an employee joining the company
hiring_in_creative_departmentHiring for creative department roles
hiring_in_education_departmentHiring for education department roles
hiring_in_engineering_departmentHiring for engineering department roles
hiring_in_finance_departmentHiring for finance department roles
hiring_in_health_departmentHiring for health department roles
hiring_in_human_resources_departmentHiring for human resources department roles
hiring_in_legal_departmentHiring for legal department roles
hiring_in_marketing_departmentHiring for marketing department roles
hiring_in_operations_departmentHiring for operations department roles
hiring_in_professional_service_departmentHiring for professional service department roles
hiring_in_sales_departmentHiring for sales department roles
hiring_in_support_departmentHiring for support department roles
hiring_in_trade_departmentHiring for trade department roles
hiring_in_unknown_departmentHiring for unknown department roles

Event Details (Businesses) -

IPO announcement

Signal NamenameType
Link to articlelinkURL
Date of IPOipo_dateDATETIME
News event IDevent_idTEXT
Company namecompany_nameTEXT
Company valuationoffer_amountNUMERIC
Number of issued sharesnumber_of_sharesNUMERIC
IPO stock exchangestock_exchangeTEXT
News event timestampevent_timeDATETIME
Price per shareprice_per_shareNUMERIC
TickertickerTEXT

New funding round

Signal NamenameType
Date of funding roundfounding_dateDATETIME
Amount raised in fundingamount_raisedNUMERIC
Link to articlelinkURL
Funding round stagefounding_stageTEXT
News event IDevent_idTEXT
News event timestampevent_timeDATETIME
Investors in funding roundinvestorsTEXT
Lead investorlead_investorTEXT

New investment

Signal NamenameType
News event timestampinvestment_dateDATETIME
Type of investmentinvestment_typeTEXT
News report publishing dateevent_timeDATETIME
News event IDevent_idTEXT
Target of investmentinvestment_targetTEXT
Link to articlelinkURL
Amount of investmentinvestment_amountNUMERIC

New product launch

Signal NamenameType
Name of productproduct_nameTEXT
News report publishing dateevent_timeDATETIME
News event IDevent_idTEXT
Link to articlelinkURL

New office

Signal NamenameType
Purpose of new officepurpose_of_new_officeTEXT
Link to articlelinkURL
Date of office openingopening_dateDATE
News event IDevent_idTEXT
Location of new officeoffice_locationTEXT
News report publishing dateevent_timeDATETIME
Number of employees at new officenumber_of_employeesNUMERIC

Office closing

Signal NamenameType
Reason for office closingreason_for_closureTEXT
News report publishing dateevent_timeDATETIME
Location of closing officeoffice_locationTEXT
Date of office closingclosure_dateDATETIME
News event IDevent_idTEXT
Number of employees impactednumber_of_employees_affectedNUMERIC
Link to articlelinkURL

New partnership

Signal NamenameType
Link to articlelinkURL
Name of partnering companypartner_companyTEXT
Date of partnershippartnership_dateDATETIME
News report publishing dateevent_timeDATETIME
Partnership purposepurpose_of_partnershipTEXT
News event IDevent_idTEXT

Department trend (per department)

Signal NamenameType
QoQ change in department countdepartment_changeNUMERIC
Department event timestampevent_timeDATE
Department event IDevent_idTEXT
Quarter when department change occurredquarter_partitionTEXT
Event collection timestampinsertion_timeTEXT
DepartmentdepartmentCATEGORY
Department trend typechange_typeCATEGORY

Executive joined company

Signal NamenameType
Executive's current job departmentjob_departmentTEXT
Executive's full namefull_nameTEXT
Executive's current job titlejob_role_titleTEXT
Executive's event IDevent_idTEXT
Executive's LinkedIn URLlinkedin_urlURL

Hiring (per department)

Display NamePartner Service NameOntology
Role locationlocationTEXT
Company hiring event IDevent_idTEXT
Company published roleevent_timeTEXT
Number of available rolesjob_countNUMERIC
Job titlesjob_titlesTEXT
DepartmentdepartmentTEXT
Language
Credentials
Click Try It! to start a request and see the response here!