> ## 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 (Bulk)
* **Input:** Provide a list of up to **`50business_ids`**.
* **Processing:** The system retrieves company rating data for all submitted businesses in a **single request**.
* **Output:** A structured response with employer reputation and employee satisfaction metrics.
```shell Bash theme={null}
curl --request POST \
--url https://api.explorium.ai/v1/businesses/company_ratings_by_employees/bulk_enrich \
--header 'accept: application/json' \
--header 'api_key: your_api_key_here' \
--header 'content-type: application/json' \
--data '{
"business_ids": [
"8adce3ca1cef0c986b22310e369a0793",
"a34bacf839b923770b2c360eefa26748"
]
}'
```
* **Assess workplace culture and employee satisfaction.**
* **Compare company ratings across industries.**
* **Track trends in employer reputation over time.**
**For additional enrichment options, explore related API endpoints below.**
## Body Params - Try Me Example
```
business_ids: ["8adce3ca1cef0c986b22310e369a0793",
"a34bacf839b923770b2c360eefa26748"]
```
## OpenAPI
````yaml post /v1/businesses/company_ratings_by_employees/bulk_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/bulk_enrich:
post:
tags:
- BulkBusinessEnrichments
summary: Company Ratings By Employees
operationId: businesses_company_ratings_by_employees_bulk_enrich
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/BusinessesBulkEnrichRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: >-
#/components/schemas/BusinessesBulkEnrichResponse_CompanyRatingsByEmployeesOutputSchema_
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- APIKeyHeader: []
- APIKeyHeader: []
components:
schemas:
BusinessesBulkEnrichRequest:
properties:
request_context:
type: object
title: Request Context
example: null
nullable: true
parameters:
type: object
title: Parameters
nullable: true
business_ids:
items:
type: string
pattern: ^[a-f0-9]{32}$
type: array
maxItems: 50
minItems: 1
title: Business Ids
additionalProperties: false
type: object
required:
- business_ids
title: BusinessesBulkEnrichRequest
BusinessesBulkEnrichResponse_CompanyRatingsByEmployeesOutputSchema_:
properties:
response_context:
$ref: '#/components/schemas/ResponseContext'
data:
items:
$ref: >-
#/components/schemas/BusinessesBulkEnrichRow_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
total_results:
type: integer
title: Total Results
type: object
required:
- response_context
- total_results
title: BusinessesBulkEnrichResponse[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
BusinessesBulkEnrichRow_CompanyRatingsByEmployeesOutputSchema_:
properties:
business_id:
type: string
pattern: ^[a-f0-9]{32}$
title: Business Id
data:
$ref: '#/components/schemas/CompanyRatingsByEmployeesOutputSchema'
type: object
required:
- business_id
title: BusinessesBulkEnrichRow[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.
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
securitySchemes:
APIKeyHeader:
type: apiKey
in: header
name: api_key
````