> ## Documentation Index
> Fetch the complete documentation index at: https://developers.explorium.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Company Ratings By Employees
## Description
The **Company Ratings by Employees Enrichment** endpoint provides **insights into company reputation and workplace experience**. This dataset is based on online ratings and reviews published by **current and former employees, as well as interview candidates**.
These ratings cover various aspects of company culture, **management quality, work-life balance, salary satisfaction, and overall employee sentiment**. The data is sourced from leading job review platforms, ensuring **high credibility and relevance**.
* **Input:** Provide a `business_id` obtained from the **Match Businesses** API.
* **Processing:** The system retrieves aggregated ratings and structured feedback.
* **Output:** A structured response with key rating metrics and employee sentiment analysis.
* **Use company ratings** to evaluate employer reputation before partnerships, investments, or sales outreach.
* **Combine ratings with firmographic data** to create a holistic view of a company's stability and employee satisfaction.
* **Monitor trends over time** to detect shifts in employee sentiment and workplace culture.
* **Cross-reference ratings with workforce trends** for deeper insights into employee retention and hiring dynamics.
| SignalAPI | Name | Description | Data Type |
| :------------------------------ | :----------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------- | :-------- |
| company\_country | Company's country | The country where the company's headquarters are located. | string |
| company\_name | Company's name | The name of the company. | string |
| company\_region | Company's region | The state region where the company's headquarters are located. | string |
| company\_street | Company's street | The street name and number where the company's headquarters are located. | string |
| company\_url | Company's URL | The URL of the website associated with the company. | url |
| company\_zip\_code | Company Zip code | The postal code where the company's headquarters are located. | string |
| experience\_negative | Negative experience | Percentage out of interviewees who published reviews that reported having a negative sentiment following a job interview. | float |
| experience\_neutral | Neutral experience | Percentage out of interviewees who published reviews that reported having a neutral sentiment following a job interview. | float |
| experience\_positive | Positive experience | Percentage out of interviewees who published reviews that reported having a positive sentiment following a job interview. | float |
| ratings\_all\_reviews\_count | Number of ratings | Overall number of company ratings published by current and former employees. | float |
| ratings\_business\_outlook | Business outlook rating | The percentage out of current and former employees who published reviews that believe the company will succeed in the near future. | float |
| ratings\_career\_opportunities | Career opportunities rating | Current and former Employees rating between 1-5 of the personal career development opportunities at the company. \| 1=low rating, 5=high rating | float |
| ratings\_ceo\_approval | CEO approval rating | The percent of current and former employees that published reviews who approved of the company's CEO. | float |
| ratings\_ceo\_approval\_count | CEO approval ratings count | Number of CEO approval ratings collected. | float |
| ratings\_compensation\_benefits | Compensation benefits rating | Compensation and benefits rating between 1-5 published by its current and former employees. \| 1=low rating, 5=high rating | float |
| ratings\_cutlure\_values | Culture values rating | Culture values rating between 1-5 as rated by its current and former employees. \| 1=low rating, 5=high rating | float |
| ratings\_diversity\_inclusion | Diversity inclusion rating | Diversity inclusion rating between 1-5 as viewed by the company’s current and former employees. \| 1=low rating, 5=high rating | float |
| ratings\_overall | Overall Ratings | A company’s overall score between 1-5 rated by its employees, interviewees and former employees. \| 1=low rating, 5=high rating | float |
| ratings\_recommend\_to\_friend | Recommend to friend rating | The chance that a current or former employee will recommend a friend to work in said company. | float |
| ratings\_senior\_management | Senior management rating | Rating between 1-5 of the senior management as viewed by its current and former employees. \| 1=low rating, 5=high rating | float |
| ratings\_work\_life\_balance | Work life balance rating | Work life balance rating between 1-5 as viewed by its current and former employees. \| 1=low rating, 5=high rating | float |
| total\_reviews\_count | Total reviews count | Total number of company reviews published by current and former employees. | float |
| company\_score | Trend of company rating by employees | A dictionary listing the overall company score rated by current and former employees over the recent year between 1-5. \| 1=low rating, 5=high rating | array |
For additional enrichment options, explore related API endpoints below.
## Body Params - Try Me Example
```
business_id: 8adce3ca1cef0c986b22310e369a0793
```
## OpenAPI
````yaml post /v1/businesses/company_ratings_by_employees/enrich
openapi: 3.1.0
info:
title: Partner Service
version: 0.2.349
servers:
- url: https://api.explorium.ai
description: AgentSource Server
security: []
paths:
/v1/businesses/company_ratings_by_employees/enrich:
post:
tags:
- BusinessEnrichments
summary: Company Ratings By Employees
operationId: businesses_company_ratings_by_employees_enrich
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/BusinessesEnrichRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: >-
#/components/schemas/BusinessesEnrichResponse_CompanyRatingsByEmployeesOutputSchema_
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- APIKeyHeader: []
- APIKeyHeader: []
components:
schemas:
BusinessesEnrichRequest:
properties:
request_context:
type: object
title: Request Context
example: null
nullable: true
parameters:
type: object
title: Parameters
nullable: true
business_id:
type: string
pattern: ^[a-f0-9]{32}$
title: Business Id
additionalProperties: false
type: object
required:
- business_id
title: BusinessesEnrichRequest
BusinessesEnrichResponse_CompanyRatingsByEmployeesOutputSchema_:
properties:
response_context:
$ref: '#/components/schemas/ResponseContext'
data:
anyOf:
- $ref: '#/components/schemas/CompanyRatingsByEmployeesOutputSchema'
- items:
$ref: '#/components/schemas/CompanyRatingsByEmployeesOutputSchema'
type: array
title: Data
entity_id:
anyOf:
- type: string
pattern: ^[a-f0-9]{32}$
- type: string
pattern: ^[a-f0-9]{40}$
title: Entity Id
type: object
required:
- response_context
title: BusinessesEnrichResponse[CompanyRatingsByEmployeesOutputSchema]
description: 'This is base response model for all responses in partner service. '
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
ResponseContext:
properties:
correlation_id:
type: string
title: Correlation Id
request_status:
$ref: '#/components/schemas/RequestStatus'
time_took_in_seconds:
type: number
title: Time Took In Seconds
type: object
required:
- correlation_id
- request_status
- time_took_in_seconds
title: ResponseContext
CompanyRatingsByEmployeesOutputSchema:
properties:
company_name:
type: string
title: Company Name
company_city:
type: string
title: Company City
company_country_code:
type: string
pattern: >-
^(aw|af|ao|ai|ax|al|ad|ae|ar|am|as|aq|tf|ag|au|at|az|bi|be|bj|bq|bf|bd|bg|bh|bs|ba|bl|by|bz|bm|bo|br|bb|bn|bt|bv|bw|cf|ca|cc|ch|cl|cn|ci|cm|cd|cg|ck|co|km|cv|cr|cu|cw|cx|ky|cy|cz|de|dj|dm|dk|do|dz|ec|eg|er|eh|es|ee|et|fi|fj|fk|fr|fo|fm|ga|gb|ge|gg|gh|gi|gn|gp|gm|gw|gq|gr|gd|gl|gt|gf|gu|gy|hk|hm|hn|hr|ht|hu|id|im|in|io|ie|ir|iq|is|il|it|jm|je|jo|jp|kz|ke|kg|kh|ki|kn|kr|kw|la|lb|lr|ly|lc|li|lk|ls|lt|lu|lv|mo|mf|ma|mc|md|mg|mv|mx|mh|mk|ml|mt|mm|me|mn|mp|mz|mr|ms|mq|mu|mw|my|yt|na|nc|ne|nf|ng|ni|nu|nl|no|np|nr|nz|om|pk|pa|pn|pe|ph|pw|pg|pl|pr|kp|pt|py|ps|pf|qa|re|ro|ru|rw|sa|sd|sn|sg|gs|sh|sj|sb|sl|sv|sm|so|pm|rs|ss|st|sr|sk|si|se|sz|sx|sc|sy|tc|td|tg|th|tj|tk|tm|tl|to|tt|tn|tr|tv|tw|tz|ug|ua|um|uy|us|uz|va|vc|ve|vg|vi|vn|vu|wf|ws|xk|ye|za|zm|zw)$
title: Company Country Code
company_region:
type: string
title: Company Region
company_street:
type: string
title: Company Street
company_url:
type: string
maxLength: 2048
pattern: >-
^(https?:)?//(?:(?:[a-z0-9\u00a1-\uffff][a-z0-9\u00a1-\uffff_-]{0,62})?[a-z0-9\u00a1-\uffff]\.)+[a-z\u00a1-\uffff]{2,}\.?(?:[/?#]\S*)?$
format: uri
title: Company Url
company_zip_code:
type: string
maxLength: 15
minLength: 1
title: Company Zip Code
experience_negative:
type: number
title: Experience Negative
experience_neutral:
type: number
title: Experience Neutral
experience_positive:
type: number
title: Experience Positive
ratings_all_reviews_count:
type: number
title: Ratings All Reviews Count
ratings_business_outlook:
type: number
title: Ratings Business Outlook
ratings_career_opportunities:
type: number
title: Ratings Career Opportunities
ratings_ceo_approval:
type: number
title: Ratings Ceo Approval
ratings_ceo_approval_count:
type: number
title: Ratings Ceo Approval Count
ratings_compensation_benefits:
type: number
title: Ratings Compensation Benefits
ratings_culture_values:
type: number
title: Ratings Culture Values
ratings_diversity_inclusion:
type: number
title: Ratings Diversity Inclusion
ratings_overall:
type: number
title: Ratings Overall
ratings_recommend_to_friend:
type: number
title: Ratings Recommend To Friend
ratings_senior_management:
type: number
title: Ratings Senior Management
ratings_work_life_balance:
type: number
title: Ratings Work Life Balance
total_reviews_count:
type: number
title: Total Reviews Count
company_score:
items:
items:
- type: string
format: date-time
- type: number
type: array
maxItems: 2
minItems: 2
type: array
title: Company Score
type: object
title: CompanyRatingsByEmployeesOutputSchema
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
type: object
required:
- loc
- msg
- type
title: ValidationError
RequestStatus:
type: string
enum:
- success
- miss
- failure
title: RequestStatus
description: >-
The `RequestStatus` class is an enumeration that defines the possible
statuses of a request.
This enum is used to indicate whether a request was successful, missed,
or failed. It ensures
consistent handling of request statuses across the application.
Attributes:
SUCCESS: Indicates that the request was successfully processed.
MISS: Indicates that the request did not find any matching data.
FAILURE: Indicates that the request encountered an error or failure.
securitySchemes:
APIKeyHeader:
type: apiKey
in: header
name: api_key
````