post https://api.explorium.ai/v1/businesses/workforce_trends/enrich
Endpoint: POST /businesses/workforce_trends/enrich
POST /businesses/workforce_trends/enrich
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.
How It Works
- 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.
Workforce trends Output Signal
Signal | API Name | Description | Data Type |
---|---|---|---|
QoQ real estate roles | change_in_real_estate_roles | Quarter over quarter rate of change in the percentage of employees working in real estate-related positions. Calculation: (% Selected Quarter / % Previous Quarter) - 1. | NUMERIC |
Percentage of design roles | perc_design_roles | Percentage of employee profiles that disclose the employee’s role who listed a design-related position. This calculation is relevant to the selected timeframe. Designer roles include product designers, web designers, and graphic designers. | NUMERIC |
Number of profiles | profiles_found_per_quarter | Number of detected profiles containing information on the employee. | NUMERIC |
Percentage of sales roles | perc_sales_roles | Percentage of employee profiles that disclose the employee’s role who listed a sales-related position. This calculation is relevant to the selected quarter. | NUMERIC |
Percentage of human resources roles | perc_hr_roles | Percentage of employee profiles that disclose the employee’s role who listed a human resources-related position. This calculation refers to the selected quarter. | NUMERIC |
Percentage of operations roles | perc_operations_roles | Percentage of employee profiles that disclose the employee’s role who listed an operations position. This calculation is relevant to the selected quarter. | NUMERIC |
Percentage of public relations roles | perc_pr_roles | Percentage of employee profiles that disclose the employee’s role who listed a PR position. This calculation is relevant to the selected quarter. | NUMERIC |
Percentage of health roles | perc_health_roles | Percentage of employee profiles that disclose the employee’s role who listed a health-related position. This calculation refers to the selected quarter. | NUMERIC |
Percentage of professional trades roles | perc_trades_roles | Percentage of employee profiles that disclose the employee’s role who listed a professional trades position. This calculation is relevant to the selected quarter. | NUMERIC |
Percentage of engineering roles | perc_engineering_roles | Percentage of employee profiles that disclose the employee’s role who listed an engineering-related position. This calculation refers to the selected quarter. | NUMERIC |
Percentage of finance roles | perc_finance_roles | Percentage of employee profiles that disclose the employee’s role who listed a finance-related position. This calculation refers to the selected quarter. | NUMERIC |
Percentage of customer service roles | perc_customer_service_roles | Percentage of employee profiles that disclose the employee’s role who listed a customer service position. This calculation is relevant to the selected timeframe. | NUMERIC |
Percentage of legal roles | perc_legal_roles | Percentage of employee profiles that disclose the employee’s role who listed a legal-related position. This calculation refers to the selected quarter. | NUMERIC |
Percentage of media roles | perc_media_roles | Percentage of employee profiles that disclose the employee’s role who listed a marketing position. This calculation is relevant to the selected quarter. | NUMERIC |
Percentage of marketing roles | perc_marketing_roles | Percentage of employee profiles that disclose the employee’s role who listed a marketing position. This calculation is relevant to the selected quarter. | NUMERIC |
Percentage of real estate roles | change_in_real_estate_roles | Percentage of employee profiles that disclose the employee’s role who listed a real estate position. This calculation is relevant to the selected quarter. | NUMERIC |
Percentage of education roles | perc_education_roles | Percentage of employee profiles that disclose the employee’s role who listed an education-related position. This calculation refers to the selected quarter. | NUMERIC |
QoQ design roles | change_in_design_roles | Quarter over quarter rate of change in the percentage of employees working in design roles. Calculation: (% Selected Quarter / % Previous Quarter) - 1. Designer roles include product designers, web designers, and graphic designers. | NUMERIC |
QoQ education roles | change_in_education_roles | Quarter over quarter rate of change in the percentage of employees working in education-related roles. Calculation: (% Selected Quarter / % Previous Quarter) - 1. | NUMERIC |
QoQ public relation roles | change_in_pr_roles | Quarter over quarter rate of change in the percentage of employees working in public relations-related positions. Calculation: (% Selected Quarter / % Previous Quarter) - 1. | NUMERIC |
QoQ professional trades roles | change_in_trades_roles | Quarter over quarter rate of change in the percentage of employees working in trades-related positions. Calculation: (% Selected Quarter / % Previous Quarter) - 1. | NUMERIC |
QoQ customer service roles | change_in_customer_service_roles | Quarter over quarter rate of change in the percentage of employees working in customer service roles. Calculation: (% Selected Quarter / % Previous Quarter) - 1. | NUMERIC |
QoQ health roles | change_in_health_roles | Quarter over quarter rate of change in the percentage of employees working in health roles. Calculation: (% Selected Quarter / % Previous Quarter) - 1. | NUMERIC |
QoQ operations roles | change_in_operations_roles | Quarter over quarter rate of change in the percentage of employees working in operations-related positions. Calculation: (% Selected Quarter / % Previous Quarter) - 1. | NUMERIC |
QoQ sales roles | change_in_sales_roles | Quarter over quarter rate of change in the percentage of employees working in sales-related positions. Calculation: (% Selected Quarter / % Previous Quarter) - 1. | NUMERIC |
QoQ legal roles | change_in_legal_roles | Quarter over quarter rate of change in the percentage of employees working in legal-related roles. Calculation: (% Selected Quarter / % Previous Quarter) - 1. | NUMERIC |
QoQ profiles that disclose employee's role | change_in_roles_divisor | Quarter over quarter rate of change in the percentage of employee profiles that contain information about the employee’s role or position at the company. Calculation: (% Selected Quarter / % Previous Quarter) - 1. | NUMERIC |
QoQ finance roles | change_in_finance_roles | Quarter over quarter rate of change in the percentage of employees working in finance roles. Calculation: (% Selected Quarter / % Previous Quarter) - 1. | NUMERIC |
QoQ media roles | change_in_media_roles | Quarter over quarter rate of change in the percentage of employees working in media-related roles. Calculation: (% Selected Quarter / % Previous Quarter) - 1. | NUMERIC |
QoQ human resources roles | change_in_hr_roles | Quarter over quarter rate of change in the percentage of employees working in human resources roles. Calculation: (% Selected Quarter / % Previous Quarter) - 1. | NUMERIC |
QoQ marketing roles | change_in_marketing_roles | Quarter over quarter rate of change in the percentage of employees working in marketing-related roles. Calculation: (% Selected Quarter / % Previous Quarter) - 1. | NUMERIC |
QoQ engineering roles | change_in_engineering_roles | Quarter over quarter rate of change in the percentage of employees working in engineering-related positions. Calculation: (% Selected Quarter / % Previous Quarter) - 1. Engineering roles include data, DevOps, electrical, mechanical, network, information technology, project engineering, quality assurance, security, software, systems, and web roles. | NUMERIC |
Quarter | quarters | Cutoff date of the data's quarterly period, e.g., 01/01/2001. | DATETIME |
Example Request (cURL)
curl --request POST \
--url https://api.explorium.ai/v1/businesses/workforce-trends/enrich \
--header 'accept: application/json' \
--header 'api_key: your_api_key_here' \
--header 'content-type: application/json' \
--data '{
"business_id": "8adce3ca1cef0c986b22310e369a0793"
}'
Best Practices
- 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