Datasets

Workforce Dynamics

This dataset contains aggregated workforce statistics. Every row is a distinct level of aggregation and month combination. Generally, the broadest configuration of this dataset is the company and month level. In that case, every row observes a particular company in a given month. If we include country as a level of aggregation, then each row of the dataset would correspond to a company, country, and month combination. The dataset at the company-country-month level can be aggregated to create the company-month dataset.

Let’s take a look at an example output where we have the levels of aggregation as company, country tracked across month and let count be the outcome of interest that represents the total headcounts for that particular level of aggregation, month combination (the count represents the headcount at the end of that particular month):

company

country

month

count

Company A

U.S.

2021-01

10

Company A

U.S.

2021-02

12

Company A

U.S.

2021-03

14

Company A

Canada

2021-01

10

Company A

Canada

2021-02

11

Company A

Canada

2021-03

9

This enables us to visualize the table as a graph as well, where the month can be represented along the X-axis, and the outcome count can be represented along the Y-axis. Thus, in this case (Company A, U.S.) and (Company A, Canada) can be viewed as entities for which the outcome count is tracked over time (month) on this graph.

Note that it’s easy to compute a broader level of aggregation from a narrower level of aggregation. To reduce our previous example to the company and month level, we can sum across the country column to get:

company

month

count

Company A

2021-01

20 (10+10)

Company A

2021-02

23 (12+11)

Company A

2021-03

23 (14+9)

  • Rcid (categorical): Revelio Labs company ID

  • Company (categorical): Revelio Labs’ delivery file can provide insights on all public (and many private) companies. By default, companies are defined at the holding company level, where all subsidiaries held by the top parent company are included. The list of parent companies covered by Revelio Labs include those mapped by FactSet Research Systems Inc., in addition to manually defined companies at the client’s request.

  • Job Category (categorical): In addition to geographical granularities, role-level granularities can also be specified. The most basic job category classification groups roles into the following 7 groups:

    • Admin

    • Engineer

    • Finance

    • Marketing

    • Operations

    • Sales

    • Scientist

    The job role taxonomy is developed by our proprietary representation and clustering algorithms. We develop mathematical representations of each job title using the title itself, the text description of the position (from either individuals describing their own experiences or employers on a job posting), individuals’ skills, associates, and previous experience. Our clustering algorithm is in the family of hierarchical/agglomerative clustering algorithms. This means that we begin with every job title occupying its own cluster, then iteratively combine clusters based on a set of criteria. This allows for complete flexibility of the number of clusters. We update this taxonomy periodically to adjust to the changing occupational landscape.

  • Role_kn (categorical): Aggregated position role with n discrete levels. We can provide roles at several levels of aggregation, including the following: role_k50, role_k150, role_k300, role_k500, role_k1250.

  • Region (categorical): The most coarse geographical granularity can be defined at region level. The 15 region names are as follows:

    • Northern America

    • Central America

    • Southern America

    • Northern Europe

    • Southern Europe

    • Eastern Europe

    • Western Europe

    • Southern Asia

    • South-Eastern Asia

    • Eastern Asia

    • Central and Western Asia

    • Pacific Islands

    • Arab States

    • Northern Africa

    • Sub-Saharan Africa

  • Country (categorical): The granularity can be specified at the country level for 247 distinct countries.

  • State (categorical): For international locations, the granularity can be specified at the state level.

  • Metro_area (categorical): For international locations, the most granular geographical granularity is the Metropolitan Area.

  • Seniority (ordinal): Seniority ranges from 1 to 7. 1 is the most junior, and 7 is the most senior (see the Methodology section for more details). Our seniority model predicts seniority based on the title, company, industry, age, previous seniority, and position history.

  • Gender (categorical): Gender is calculated as a probability based on the likelihood of the first name being male or female.

  • Ethnicity (categorical): Ethnicity is estimated based on the likelihood of both the first and last name as well as an individual’s location.

  • Month (categorical): The month and year of the position are provided in “YYYY-MM” format. Each deliverable file contains monthly data up to the previous month’s end.

  • Count (float): The total number of employees for a specific level of granularity for each month.

  • Inflow/Outflow (float): We also estimate the total inflow count (people joining) and outflow count (people leaving) in a given month.

  • Salary (float): We predict the salary for each position based on role, seniority, company, and country using a regression-based model. We train this model using over 200 million salaries from job postings and publicly available labor certification applications, and use country-level inflation rates to estimate the change in salary over time. We get an out-of-sample root mean squared error (RMSE) of 14%. The Salary column in long_file shows the sum of salaries of employees in the particular granularity level.

Statistics that can be included are as follows:

  • Levels of Aggregation:

    • Rcid (categorical): Revelio Labs company ID

    • Company (categorical): Company name

    • Job_category (categorical): Aggregated position role with 7 discrete levels

    • Role_k50 (categorical): Aggregated position role with 50 discrete levels

    • Role_k150 (categorical): Aggregated position role with 150 discrete levels

    • Region (categorical): The most coarse geographical granularity with 16 discrete levels

    • Country (categorical): 247 different countries

    • State (categorical): State level location for all international locations

    • Metro_area (categorical): Metropolitan area for all international locations

    • Seniority (ordinal): Seniority level with 7 discrete levels

    • Gender (categorical): Gender is calculated as a probability based on the likelihood of the first name being male or female

    • Ethnicity (categorical): Ethnicity is estimated based on the likelihood of both the first and last name as well as an individual’s location

    • Month (categorical): The month and year of the position, provided in “YYYY-MM” format

  • Outcomes:

    • Count (float): Headcount of employees at each granularity level for a given month

    • Inflow/Outflow (float): Total inflow and outflow counts of employees at each granularity level for a given month

    • Salary (float): Sum of estimated annual salaries of the specified granularity level (in USD)

    • Prestige (float): Average prestige score of the specified granularity level

    • Duration (float): Average tenure of employees of the specified granularity level in years

See the FAQ section for additional outcomes and granularities.

Transitions

  • User_id (categorical): Revelio Labs user ID

  • Prev_rcid (categorical): Revelio Labs company ID of previous company

  • Prev_position_id (categorical): Previous position ID

  • Prev_company (categorical): Previous company name

  • Prev_seniority (ordinal): Previous seniority level with 7 discrete levels

  • Prev_region (categorical): Previous region

  • Prev_country (categorical): Previous country

  • Prev_state (categorical): Previous state

  • Prev_metro_area (categorical): Previous metropolitan area

  • Prev_jobtitle (categorical): Previous job title

  • Prev_job_category (categorical): Aggregated previous position role with 7 discrete levels

  • Prev_role_k50 (categorical): Aggregated previous position role with 50 discrete levels

  • Prev_role_k150 (categorical): Aggregated previous position role with 150 discrete levels

  • Prev_enddate (time): End date of previous position

  • Prev_salary (float): Estimated annual salary of the previous role (in USD)

  • new_position_id (categorical): New position ID

  • New_rcid (categorical): Revelio Labs company ID of new company

  • New_company (categorical): New company name

  • New_seniority (ordinal): New seniority level with 7 discrete levels

  • New_region (categorical): New region

  • New_country (categorical): New country

  • New_state (categorical): New state

  • New_metro_area (categorical): New metropolitan area

  • New_jobtitle (categorical): New job title

  • New_job_category (categorical): Aggregated new position role with 7 discrete levels

  • New_role_k50 (categorical): Aggregated new position role with 50 discrete levels

  • New_role_k150 (categorical): Aggregated new position role with 150 discrete levels

  • New_startdate (time): Start date of new position

  • New_salary (float): Estimated annual salary of the new role (in USD)

Job Postings

Job Posting Dynamics

This dataset contains aggregated job posting statistics. Every row is a distinct level of aggregation and month combination. Generally, the broadest configuration of this dataset is the company and month level. Each row would correspond to a company and month combination. For more information on the levels of aggregation, please refer to the Workforce Dynamics section.

  • Rcid (categorical): Revelio Labs company ID

  • Company (categorical): Company name

  • Country (categorical): Country location of job posting

  • State (categorical): State location of job posting

  • Job_category (categorical): Aggregated posting role with 7 discrete levels

  • Role_k50 (categorical): Aggregated posting role with 50 discrete levels

  • Role_k150 (categorical): Aggregated posting role with 150 discrete levels

  • Month (categorical): The month and year provided in “YYYY-MM” format

  • Active_posting (float): Number of active postings during that month

  • New_posting (float): Number of new postings during that month

  • Removed_posting (float): Number of postings removed during that month:

  • Active_salary_avg (float): Average salary for active postings during that month

  • New_salary_avg (float): Average salary for new postings during that month

  • Removed_salary_avg (float): Average salary for postings that got removed during that month

  • Filling_time_avg (float): Average time to fill, in days

Individual Job Postings

Revelio Labs also provides individual level job postings data. These files contain posting-level information on current and historical job postings such as posting date, location, role, and salary.

  • Job_id (categorical): Posting key

  • Rcid (categorical): Revelio Labs company ID

  • Company (categorical): Company name

  • Post_date (categorical): Date at which the job was posted

  • Remove date (categorical): Date at which the job was removed. If null, it hasn’t been removed yet.

  • Role_k150 (categorical): Aggregated position role with 150 discrete levels

  • Role_k50 (categorical): Aggregated position role with 50 discrete levels

  • Job_category (categorical): Aggregated position role with 7 discrete levels

  • Salary (float): Salary information from the posting.

  • State, country (categorical): Listed location for posting

Sentiment

Revelio Labs provides company review data with the following information. Note that not all rating fields are required to be filled out by the reviewer. Also, some ratings (ie., ‘culture and values’ and ‘diversity and inclusion’) were added more recently.

  • Rcid (categorical): Revelio Labs company ID

  • Company (categorical): Company name

  • Review_id (categorical): Review ID

  • Job_title_raw (categorical): Reviewer’s raw position title

  • Location_raw (categorical): Reviewer’s raw location

  • Region (categorical): Reviewer’s region

  • Country (categorical): Reviewer’s country

  • State (categorical): Reviewer’s state

  • Metro_area (categorical): Reviewer’s metropolitan area

  • Review_language_id (categorical): Language of the review

  • Review_date_time (time): Posting date of the review

  • Review_iscovid19 (boolean): Indicates whether review mentions the Covid-19 pandemic

  • Reviewer_current_job (boolean): Indicates whether the reviewer is a current or former employee

  • Reviewer_employment_status (categorical): Reviewer’s employment type (freelance, part time, intern, contract, regular)

  • Reviewer_job_ending_year (integer): Final year of the reviewer’s employment with the company

  • Reviewer_length_of_employment (integer): Number of years that the reviewer worked at the company

  • Rating_overall (integer): Reviewer’s overall rating of the company (integer values from 1 to 5, with 5 being the best)

  • Rating_career_opportunities (float): Reviewer’s rating of the company’s career opportunities (from 1 to 5, with half-points awarded, and 5 being the best)

  • Rating_compensation_and_benefits (float): Reviewer’s rating of the company’s compensation and benefits (from 1 to 5, with half-points awarded, and 5 being the best)

  • Rating_culture_and_values (integer): Reviewer’s rating of the company’s culture and values (integer values from 1 to 5, with 5 being the best)

  • Rating_diversity_and_inclusion (integer): Reviewer’s rating of the company’s diversity and inclusion (integer values from 1 to 5, with 5 being the best)

  • Rating_senior_leadership (float): Reviewer’s rating of the company’s senior management (from 1 to 5, with half-points awarded, and 5 being the best)

  • Rating_work_life_balance (float): Reviewer’s rating of the company’s work-life balance (from 1 to 5, with half-points awarded, and 5 being the best)

  • Rating_business_outlook (categorical): Reviewer’s rating of the company’s business outlook (positive, negative, neutral)

  • Rating_ceo (categorical): Reviewer’s approval rating of the company’s CEO (approve, disapprove, no opinion)

  • Rating_recommend_to_friend (categorical): Indicates whether the reviewer would recommend the company to a friend (positive, negative)

  • Review_summary (string): Title of review

  • Review_pros (string): Reviewer’s positive comments about the company

  • Review_cons (string): Reviewer’s negative comments about the company

  • Review_count_helpful (integer): Number of users who found the review helpful

  • Review_count_not_helpful (integer): Number of users who found the review unhelpful

  • ultimate_parent_rcid (categorical): Revelio Labs company ID for the parent company

  • ultimate_parent_company_name (categorical): Name of the parent company

Sentiment Scores

This dataset contains employee sentiment scores that were generated using our sentiment model. This model uses Natural Language Processing to capture employee sentiment on specific topics such as management and diversity. For each review, we compute a weighted sentiment score based on how relevant a given topic was for the positive or negative portion of the review, assigning a positive (negative) score to topics that had an overall positive (negative) impact on the review. These scores are then aggregated to arrive at a company-wide sentiment score. Each row contains the sentiment scores for a given company.

  • Rcid (categorical): Revelio Labs company ID

  • Company (categorical): Company name

  • Management_sentiment (float): Management sentiment score

  • Innovative_technology_sentiment (float): Innovative technology sentiment score

  • Work_life_balance_sentiment (float): Work life balance sentiment score

  • Mentorship_sentiment (float): Mentorship sentiment score

  • Career_advancement_sentiment (float): Career advancement sentiment score

  • Diversity_and_inclusion_sentiment (float): Diversity and inclusion sentiment score

  • Coworkers_sentiment (float): Coworkers sentiment score

  • Compensation_sentiment (float): Compensation sentiment score

  • Culture_sentiment (float): Culture sentiment score

  • Company_and_division_size_sentiment (float): Company and division size sentiment score

  • Perks_and_benefits_sentiment (float): Perks and benefits sentiment score

  • Onboarding_sentiment (float): Onboarding sentiment score

  • Remote_work_sentiment (float): Remote work sentiment score

  • Num_reviews (integer): Number of reviews factored into the scores

Layoff Notices

We also collect WARN layoff data, which details whenever a firm is planning to lay off a significant portion of its workforce. The WARN Act (Worker Adjustment and Retraining Notification) ensures that mass layoffs and plant closures are registered with states and the Department of Labor in advance to allow for the provision of compliance assistance materials to help workers and employers understand their rights and responsibilities.

We provide the WARN data at the notice level, where each row represents a layoff notice.

  • Rcid (categorical): Revelio Labs company ID

  • Company (categorical): Name of company registering layoff

  • State (categorical): State where layoff is occurring

  • City (categorical): City where layoff is occurring

  • Layoff_date (categorical): Date as of which layoffs will be effective

  • Num_employees (integer): Number of employees to be laid off

  • ultimate_parent_rcid (categorical): Revelio Labs company ID for the parent company

  • ultimate_parent_company_name (categorical): Name of the parent company

Individual Level Data

Revelio Labs also provides individual level position data. These files contain user-level information on current and historical positions, educational history, name, and demographics information.

position_file

This file contains the individual level position data. Each row is a position held by an individual.

  • Position_id (categorical): Revelio Labs position ID

  • User_id (categorical): Revelio Labs user ID

  • Location_raw (categorical): location of position (raw from online profile)

  • Region (categorical): Region of position (Ex. Southern Asia, Western Europe)

  • Country (categorical): Country of position (imputed from location)

  • State (categorical): State of position (if missing, we infer it from the user’s current state)

  • Metro_area (categorical): Metropolitan area of position (if missing, we infer it from the user’s current location)

  • Rcid (categorical): Revelio Labs company ID

  • Company_name (categorical): Company name (mapped)

  • Company_raw (categorical): Company name (raw from online profile)

  • Company_linkedin_url (categorical): URL for employer (from online profile)

  • Company_cleaned (categorical): Company name (from online profile, cleaned of special characters)

  • Jobtitle_raw (categorical): Position title (raw from online profile)

  • Mapped_role (categorical): Position title (Revelio Labs mapped)

  • Job_category (categorical): Aggregated position role with 7 discrete levels (also available at other levels of aggregation)

  • Seniority (ordinal): Seniority level with 7 discrete levels

  • Salary (float): Modeled annual salary for the position (in USD)

  • Startdate (categorical): Position start date if reported, null otherwise

  • Enddate (categorical): Position end date if reported, null otherwise

  • Rn (integer): Chronological order of a position in a user’s profile

  • ultimate_parent_rcid (categorical): Revelio Labs company ID for the parent company

  • ultimate_parent_company_name (categorical): Name of the parent company

user_file

This file contains the individual level user data. Each row is an individual’s public profile.

  • User_id (categorical): Revelio Labs user ID

  • Firstname (categorical): First name (parsed from fullname)

  • Lastname (categorical): Last name (parsed from fullname)

  • Fullname (categorical): Name reported on online profile

  • F_prob (float): Probability of user being female

  • M_prob (float): Probability of user being male

  • Api_prob (float): Probability of user being Asian/Pacific Islander

  • Black_prob (float): Probability of user being Black or African American

  • Hispanic_prob (float): Probability of user being Hispanic or Latino

  • Multiple_prob (float): Probability of user being two or more races

  • Native_prob (float): Probability of user being American Indian or Alaskan Native

  • White_prob (float): Probability of user being Non-Hispanic White

  • Highest_degree (categorical): The highest level of education reported (Ex. Bachelor, High School)

education_file

This file contains the individual level education data. Each row is an educational record.

  • User_id (categorical): Revelio Labs user ID

  • School (categorical): Campus name (university)

  • Startdate (categorical): Start date

  • Enddate (categorical): End date

  • Degree (categorical): Degree title (Revelio Labs mapped)

  • Degree_raw (categorical): Degree title (raw from online profile)

  • Field (categorical): Degree field (Revelio Labs mapped)

  • Field_raw (categorical): Degree field (raw from online profile)

skill_file

This file contains the individual level skills data. Revelio Labs uses proprietary algorithms to cluster the skill universe into distinct clusters of skills. The clustering can be as coarse as 25 groups and as fine as over 20,000 groups. The default skill clustering is done at 50 groups.

  • User_id (categorical): Revelio Labs user ID

  • Skill (categorical): Single skill from profile (raw from online profile)

  • Skill_mapped (categorical): Skill from profile (Revelio Labs mapped)

  • Skill_k75 (categorical): Aggregated skill with 75 discrete levels (also available at other levels of aggregation)

company_ref

This file contains information on all of the companies that are covered by the delivered data.

  • Rcid (categorical): Revelio Labs company ID

  • Company (categorical): Company name

  • Factset_entity_id (categorical): FactSet company ID

  • Year_founded (categorical): Year in which the company was founded

  • Ticker (categorical): Ticker of the company

  • Exchange_name (categorical): The stock exchange that the company is listed on

  • Sedol (categorical): SEDOL code

  • Isin (categorical): ISIN code

  • Cusip (categorical): CUSIP number

  • Url (categorical): Company’s website URL

  • Naics_code (categorical): Company’s NAICS industry code

  • Cik (categorical): CIK number

  • Lei (categorical): LEI code

  • Linkedin_url (categorical): Company LinkedIn URL

  • Child_rcid (categorical): Revelio Labs company ID of largest subsidiary company

  • Child_company (categorical): Company name of largest subsidiary company

  • Child_linkedin_url (categorical): Company LinkedIn URL of largest subsidiary company