Skip to main content
POST
/
v1
/
businesses
/
workforce_trends
/
enrich
Workforce Trends
curl --request POST \
  --url https://api.explorium.ai/v1/businesses/workforce_trends/enrich \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '{
  "request_context": {},
  "parameters": {},
  "business_id": "<string>"
}'
{
  "response_context": {
    "correlation_id": "<string>",
    "request_status": "success",
    "time_took_in_seconds": 123
  },
  "data": {
    "change_in_real_estate_roles": 123,
    "perc_design_roles": 123,
    "profiles_found_per_quarter": 123,
    "perc_sales_roles": 123,
    "perc_hr_roles": 123,
    "perc_operations_roles": 123,
    "perc_pr_roles": 123,
    "perc_health_roles": 123,
    "perc_trades_roles": 123,
    "perc_engineering_roles": 123,
    "perc_finance_roles": 123,
    "perc_customer_service_roles": 123,
    "perc_legal_roles": 123,
    "perc_media_roles": 123,
    "perc_marketing_roles": 123,
    "perc_real_estate_roles": 123,
    "perc_education_roles": 123,
    "change_in_design_roles": 123,
    "change_in_education_roles": 123,
    "change_in_pr_roles": 123,
    "change_in_trades_roles": 123,
    "change_in_customer_service_roles": 123,
    "change_in_health_roles": 123,
    "change_in_operations_roles": 123,
    "change_in_sales_roles": 123,
    "change_in_legal_roles": 123,
    "change_in_roles_divisor": 123,
    "change_in_finance_roles": 123,
    "change_in_media_roles": 123,
    "change_in_hr_roles": 123,
    "change_in_marketing_roles": 123,
    "change_in_engineering_roles": 123,
    "quarters": "2023-11-07T05:31:56Z"
  },
  "entity_id": "<string>"
}

Description

The Workforce Trends Enrichment endpoint provides insights into employee distribution, departmental growth, and workforce shifts within a company. This dataset is valuable for HR strategists, investors, and business analysts looking to assess organizational trends over time. The data includes:
  • Percentage distribution of employees across various departments.
  • Quarterly workforce change rates, indicating hiring or downsizing trends.
  • Aggregated workforce data providing a comprehensive view of company employment trends.
This information is sourced from employment records, job postings, and public workforce data to provide real-time visibility into corporate workforce dynamics.
  • Input: Provide a business_id obtained from the Match Businesses API.
  • Processing: The system analyzes workforce composition, department trends, and hiring activity over time.
  • Output: A structured response summarizing workforce distribution and hiring/firing trends.
  • Use workforce distribution insights to assess company department growth and investment focus.
  • Analyze hiring and downsizing trends to gauge business expansion or contraction.
  • Leverage workforce trend data to benchmark against competitors in the same industry.
  • Monitor key roles in engineering, sales, and operations to understand where a company is investing resources.
For additional enrichment options, explore related API endpoints below.

Body Params - Try Me Example

business_id: 8adce3ca1cef0c986b22310e369a0793

Authorizations

api_key
string
header
required

Body

application/json
business_id
string
required
request_context
object
parameters
object

Response

Successful Response

This is base response model for all responses in partner service.

response_context
object
required
data
entity_id
I