Employee Data
🆕 Multi-source Employee Data

Dictionary: Multi-Source Employee Data

50min

On this page, you'll find detailed information about Coresignal's Multi-source Employee data. Each category includes a table listing the available data points, their explanations, data types, and sample code snippets.

If you want to check the dataset schema, fill rates, or sample, click here.

All personal/company information mentioned within this context is entirely fictional and is solely intended for illustrative purposes.

Data points in the example snippets are rearranged for better grouping.

Metadata

Data point

Description

Data type

created_at

The date and time when the employee record was created

String (date)

updated_at

The date and time when the employee record was last fully updated

String (date)

checked_at

The date and time when the employee record was last checked partially

String (date)

changed_at

The date and time when the employee record was last changed

String (date)

experience_change_last_identified_at

The date and time when the employee record change was last identified

String (date)

is_deleted

Marks if the employee record is deleted or private

1 - the record is deleted

0 - the record is not deleted

Number (integer)

is_parent

Notes if the employee record is the main employee profile:

1 - the record is parent (main)

0 - the record is not parent

Number (integer)

See a snippet of the dataset for reference:

Metadata


Identifiers and URLs

Data point

Description

Data type

id

Coresignal's identification key for an employee profile record.

Taken from the professional network dataset.

Number (integer)

parent_id

Parent category identification key

Number (integer)

historical_ids

Historical identification keys that are related to the same profile after URL change

Array of strings

professional_network_url

Most recent profile URL on professional network

String

professional_network_shorthand_names

Historical variations of shorthand names for the employee

Array of strings

See a snippet of the dataset for reference:

Identifiers & URLs


Employee information

Data point

Description

Data type

full_name

Employee's full name

String

first_name

Employee's first name

Parsed from the full_name

String

first_name_initial

First name initial Parsed from first_name

String

middle_name

Employee's middle name

Parsed from the full_name

String

middle_name_initial

Middle name initial Parsed from middle_name

String

last_name

Employee's last name

Parsed from the full_name

String

last_name_initial

Last name initial Parsed from last_name

String

picture_url

Picture URL

String

connections_count

Count of profile connections

Number (integer)

followers_count

Count of profile followers

Number (integer)

interests

Employee's interests

Array of strings

See a snippet of the dataset for reference:

Employee information


Professional contact information

Coresignal collects only publicly available, strictly business-related data published or released by companies or individuals at their discretion online. The contact information includes only professional emails.

No sensitive or private/ located within the login secured areas information is collected or transmitted.

Data point

Description

Data type

primary_professional_email

Employee's business email address tied to their workplace

String

primary_professional_email_status

The confidence level in the accuracy of the employee's business email address. The field will return four options: verified, matched_email, matched_pattern, orguessed_common_pattern.

String

professional_emails_ collection

Collection of employee's business email addresses

Array of structs

professional_email

Employee's business email address

String

professional_email_status

The confidence level in the accuracy of the employee's professional email address. The field will return four options:

  • verified – the email was matched and verified
  • matched_email – the email was matched but could not retrieve "verified" status
  • matched_pattern – the exact email was not matched, but it was guessed based on the matched email pattern for the company
  • guessed_common_pattern – neither the exact email nor the email pattern for that company was matched, but the most common global pattern was guessed

String

order_of_priority

Order of priority based on confidence in email validity

Number (integer)

See a snippet of the dataset for reference:

Professional contact information


Location

Data point

Description

Data type

location_country

Associated country

String

location_country_iso2

ISO 2-letter code of the location country, based on their location_country value.

String

location_country_iso3

ISO 3-letter code of the location country, based on their location_countryvalue.

String

location_full

Full location

String

location_regions

Associated geographical regions based on their location_country value

Array of strings

See a snippet of the dataset for reference:

Location


Experience and workplace

Active experience overview

Data point

Description

Data type

headline

Profile headline

String

summary

Main description (employee summary)

String

services

Offered services

String

is_working

Marks if the employee is currently employed

1 the employee is currently working

0 the employee is currently not working

Number (integer)

active_experience_company_id

Coresignal's identification key for a company to identify where the employee is currently working

Number (integer)

active_experience_title

Title of employee's current position

String

active_experience_description

Description of the current position

String

active_experience_department

A list of employee's departments, based on actve_position_title

String

active_experience_management_level

A list of employee's management levels, based on active_experience_title

String

is_decision_maker

Marks if the employee is a decision maker, based on active_experience_title

1 the employee is a decision maker

0 the employee is not a decision maker

Number (integer)

See a snippet of the dataset for reference:

Active experience overview


Skills

Data point

Description

Data type

inferred_skills

Lists employees' skills based on the descriptions from the profile

Array of strings

See a snippet of the dataset for reference:

Skills


Experience duration

Data point

Description

Data type

total_experience_duration_months

Total normalized experience duration of all Employee's experiences

Number (integer)

total_experience_duration_months_breakdown_department

 

 

Total normalized experience duration by employee's department

Array of structs

department

Department

String

total_experience_duration_months

Experience duration in months

String

total_experience_duration_months_breakdown_management_level

Total normalized experience duration by Employee's management level

Array of structs

management_level

Employee's management level

String

total_experience_duration_months

Experience duration in months

String

See a snippet of the dataset for reference:

Experience duration


Full experience information

Data point

Description

Data type

experience

Work experience the Employee has

Array of structs

active_experience

Identifies if this is a current (active) position

String

position_title

Employee's position title

String

department

Employees department

String

management_level

Employee's management level

String

location

Job/workplace location

String

date_from

Employment start date

String (date)

date_from_year

Employment start year

Integer

date_from_month

Employment start month

Integer

date_to

Employment end date

String (date)

date_to_year

Employment end year

Integer

date_to_month

Employment end month

Integer

duration_months

Employment duration in months

Integer

See a snippet of the dataset for reference:

Full experience information


Workplace details

Metadata and firmographics

Data point

Description

Data type

company_id

Company record identification key in Coresignal's database

Integer

company_name

Company name

String

company_type

Company type

String

company_founded_year

Founding year

String (date)

company_size_range

Company size based on employee count range (as selected by the company profile administrator)

String

company_employees_count

Number of employees that associated their experience with the company

Number (integer)

company_categories_and_ keywords

Categories and keywords are assigned to the company profile and products across various platforms

Array of strings

company_employees_count_ change_yearly_percentage

Company employee count change (percentage)

Number (integer)

company_industry

Company's industry

String

company_last_updated_at

The last update date of the record in the YYYY-MM-DD format

String (date)

company_is_b2b

Indicates if the company operates in a business-to-business model:

1 b2b company

0 b2c company

Number (integer)

order_in_profile

The order number of the workplace in the profile

Number (integer)

See a snippet of the dataset for reference:

Metadata & firmographics


Social media

Data point

Description

Data type

company_followers_count

Company's profile follower count on professional network

Integer

company_website

Company's website

String

company_facebook_url

Company's Facebook URL

Array of strings

company_twitter_url

Company's X (Twitter) URL

Array of strings

company_linkedin_url

Company's LinkedIn URL

String

See a snippet of the dataset for reference:

Social media


Financials

Data point

Description

Data type

company_annual_revenue_source_1

company_annual_revenue_source_5

Company's revenue from a specific source

Array of objects

company_annual_revenue_currency_ source_1

company_annual_revenue_currency_ source_5

Revenue currency

String

company_last_funding_round_date

Date when the last funding round was announced in YYYY-MM-DD format

String (date)

company_last_funding_round_amount_ raised

Amount raised in the last funding round

Integer (long)

company_stock_ticker

Company's stock ticker information

Array of objects

exchange

Stock exchange

String

ticker

Stock ticker

String

See a snippet of the dataset for reference:

Financials


Workplace locations

Data point

Description

Data type

company_hq_full_address

Full address of the company's headquarters

String

company_hq_country

The country where the company's headquarters is located

String

company_hq_regions

Detailed region where the company's headquarters is located

Array of strings

company_hq_country_iso2

ISO 2-letter code of the headquarters country

String

company_hq_country_iso3

ISO 3-letter code of the headquarters country

String

company_hq_city

Headquarters city

String

company_hq_state

Headquarters state

String

company_hq_street

Headquarters street address

String

company_hq_zipcode

Headquarters zip code

String

See a snippet of the dataset for reference:

Locations


Education

Data point

Description

Data type

last_graduation_date

Last graduation date

String (date)

education_degrees

List of education degrees held by the person

Array of strings

education

Employee's education

Array of objects

degree

Degree name

String

description

Degree description

String

institution_url

Institution's profile URL

String

institution_name

Institution's name

String

institution_full_address

Institution's full address

String

institution_country_iso2

ISO 2-letter code of the institution's country

String

institution_country_iso3

ISO 3-letter code of the institution's country

String

institution_regions

Institution's region

Array of strings

institution_city

Institution's city

String

institution_state

Institution's state

String

institution_street

Institution's street

String

institution_zipcode

Institution's zip code

String

date_from_year

Enrollment date

Number (integer)

date_to_year

Graduation date

String (date)

activities_and_societies

Activities and societies that are connected with the employee

String

order_in_profile

Order in profile

Number (integer)

See a snippet of the dataset for reference:

Education


Salary

Projected base salary

Data point

Description

Data type

projected_base_salary_p25

Minimum projected base salary for the current position (25th percentile)

Number (double)

projected_base_salary_median

Median projected base salary for the current position

Number (double)

projected_base_salary_p75

Maximum projected base salary for the current position (75th percentile)

Number (double)

projected_base_salary_period

Data collection period

String

projected_base_salary_currency

Salary currency

String

projected_base_salary_updated_at

Data last update date

String (date)

See a snippet of the dataset for reference:

Projected base salary


Projected additional salary

Data point

Description

Data type

projected_additional_salary

Projected additional salary

Array of structs

projected_additional_salary_type

Projected additional salary type for the current position

String

projected_additional_salary_p25

Minimum projected additional salary for the current position (25th percentile)

Number (double)

projected_additional_salary_median

Median projected additional salary for the current position

Number (double)

projected_additional_salary_p75

Maximum projected additional salary for the current position (75th percentile)

Number (double)

projected_additional_salary_period

Data collection period

String

projected_additional_salary_currency

Salary currency

String

projected_additional_salary_updated_at

Data last update date

String (date)

See a snippet of the dataset for reference:

Projected additional salary


Projected total salary

Data point

Description

Data type

projected_total_salary_p25

Minimum projected total salary value for the current position (25th percentile)

Number (double)

projected_total_salary_median

Median projected total salary value for the current position

Number (double)

projected_total_salary_p75

Maximum projected total salary value for the current position (75th percentile)

Number (double)

projected_total_salary_period

Data collection period

String

projected_total_salary_currency

Salary currency

String

projected_total_salary_updated_at

Data last update date

String (date)

See a snippet of the dataset for reference:

Projected total salary


Profile field changes

Data point

Description

Data type

profile_root_field_changes_summary

Summary of the field-level changes

Array of structs

field_name

Name of the data field

String

change_type

Type of the data field change

String

last_changed_at

Date of the last data field change

String (date)

profile_collection_field_changes_summary

Summary of changes in profile collection fields

Array of structs

field_name

Name of the collection data field

String

last_changed_at

Data of the last collection data field change

String

See a snippet of the dataset for reference:

Profile field changes


Recent experience changes

Data point

Description

Data type

experience_recently_started

Collection of identified recently started Employee experiences

Array of structs

company_id

Coresignal's identification key for a company record

String

company_name

Company name

String

company_url

URL of the company

String

company_shorthand_name

Shorthand name of the company's URL

String

date_from

Start date of the experience record

String

date_to

End date of the experience record

String

title

Position title in the company

String

identification_date

Date when experience change was identified

String

experience_recently_closed

Collection of employee experiences that ended recently

Array of structs

company_id

Coresignal's identification key for a company record

String

company_name

Company name

String

company_url

URL of the company

String

company_shorthand_name

Shorthand name of the company's URL

String

date_from

Start date of the experience record

String

date_to

End date of the experience record

String

title

Position title in the company

String

identification_date

Date when experience change was identified

String

See a snippet of the dataset for reference:

Recent experience changes


GitHub information

Data point

Description

Data type

github_url

GitHub profile URL

String

github_username

GitHub profile username

String

github_mapping_confidence

Confidence level that the mapping to the GitHub profile is correct

  • 100 – high confidence level
  • 50 – medium confidence level

Number (integer)

github_contributions_count

Number of GitHub contributions

Number (integer)

github_repos_summary

Summary of GitHub repository information for a specific person

Array of structs

name

Repository name

String

summary

Repository summary

String

stars

Repository stars

Number (integer)

contributions_count

Number of GitHub contributions

Number (integer)

See a snippet of the dataset for reference:

GitHub Information


Recommendations

Data point

Description

Data type

recommendations_count

Number of recommendations from other users

Number (integer)

recommendations

List of recommendations received

Array of structs

recommendation

Recommendation text

String

referee_full_name

The full name of the person who wrote the recommendation

String

referee_url

The URL of the profile of the person who wrote the recommendation

String

order_in_profile

The exact position of the recommendation in the profile

Number (integer)

See a snippet of the dataset for reference:

Recommendations


Activity

Data point

Description

Data type

activity

User's activity (posts)

Array of structs

activity_url

Post URL

String

title

Post title

String

action

Activity type

String

order_in_profile

The exact position of the activity in the profile

Number (integer)

See a snippet of the dataset for reference:

Activity


Awards

Data point

Description

Data type

awards

Awards held by the person

Array of structs

title

Award title

String

issuer

Award issuer

String

description

Award description

String

date

Award date

String

date_year

Award year

StringNumber (integer)

date_month

Award month

Number (integer)

order_in_profile

The exact position of the award in the profile

Number (integer)

See a snippet of the dataset for reference:

Awards


Courses

Data point

Description

Data type

courses

Courses

Array of structs

organizer

Course organizer

String

title

Course title

String

order_in_profile

The exact position of the course in the profile

Number (integer)

See a snippet of the dataset for reference:

Courses


Certifications

Data point

Description

Data type

certifications

Certifications

Array of structs

title

Certification title

String

issuer

Certification issuer

String

issuer_url

Issuer profile URL

String

credential_id

Credential identification key

String

certificate_url

Certification URL

String

date_from

Certification issue date

String (date)

date_from_year

Issue year

Number (integer)

date_from_month

Issue month

Number (integer)

date_to

Certification expiry date

String (date)

date_to_year

Expiry year

Number (integer)

date_to_month

Expiry month

Number (integer)

order_in_profile

The exact position of the certification in the profile

Number Array

See a snippet of the dataset for reference:

Certifications


Languages

Data point

Description

Data type

languages

Language knowledge

Array of structs

language

Listed language

String

proficiency

Language proficiency

String

order_in_profile

The exact position of the language in the profile

Number (integer)

See a snippet of the dataset for reference:

Languages


Patents

Data point

Description

Data type

patents_count

Number of authored patents

Number (integer)

patents_topics

Patent topics

Array of strings

patents

Authored patents

Array of structs

title

Patent title

String

status

Patent status

String

description

Patent description

String

patent_url

Patent URL

String

date

Patent filing date

String (date)

date_year

Filling year

Number (integer)

date_month

Filling month

Number (integer)

patent_number

Patent number

String

order_in_profile

The exact position of the patent in the profile

Number (integer)

See a snippet of the dataset for reference:

Patents count


Publications

Data point

Description

Data type

publications_count

Count of publications authored by the employee

Number (integer)

publications_topics

Publication topics

Array of strings

publications

Authored publications

Array of structs

title

Publication title

String

description

Publication description

String

publication_url

Publication website URL

String

publisher_name

Publication publisher

Array of strings

date

Publication release date

String (date)

date_year

Release year

Number (integer)

date_month

Release month

Number (integer)

order_in_profile

The exact position of the publication in the profile

Number (integer)

See a snippet of the dataset for reference:

Publications


Projects

Data point

Description

Data type

projects_count

Count of total projects listed in the profile

Number (integer)

projects_topics

Topics related to the projects listed in the profile

Array of strings

projects

Projects created by the profile

Array of structs

name

Project name

String

description

Project description

String

project_url

Project website URL

String

date_from

Project start date

String (date)

date_from_year

Project start year

Number (integer)

date_from_month

Project start month

Number (integer)

date_to

Project end date

String (date)

date_to_year

Project end year

Number (integer)

date_to_month

Project end month

Number (integer)

order_in_profile

The exact position of the project in the profile

Number (integer)

See a snippet of the dataset for reference:

Projects


Organizations

Data point

Description

Data type

organizations

Memberships in organizations

Array of structs

organization_name

Organization title

String

position

Position in the organization

String

description

Description of the activity/experience in the organization

String

date_from

Membership start date

String (date)

date_from_year

Membership start year

Number (integer)

date_from_month

Membership start month

Number (integer)

date_to

Membership end date

String (date)

date_to_year

Membership end year

Number (integer)

date_to_month

Membership end month

Number (integer)

order_in_profile

The exact position of the organization in the profile

Number (integer)

See a snippet of the dataset for reference:

Organizations