Employee Reviews
Employee Reviews API
Fetches a company’s employee review data including overall ratings, dimension-level ratings (culture, work-life balance, senior management and more) and individual employee reviews.
GET
Employee Reviews
Overview
The Employee Reviews API returns a company’s aggregated employee review signals along with individual reviews sourced from review providers such as Glassdoor. The response includes the overall rating, dimension-level ratings (culture, work-life balance, compensation, senior management, diversity and inclusion, business outlook, CEO approval, recommendation rate), and a paginated list of individual reviews with pros, cons, ratings, reviewer metadata and a link to the original review. Results are returned in the API response.Endpoint Details
- Method: GET
- Endpoint:
/v1/company/employee-reviews
Authentication requirements
- Include a valid API key in the
x-api-keyrequest header.
Request
Request Parameters
Header Parameters
Your API key.
URL Parameters
Company website (e.g.
canva.com) or a company UUID (e.g. 3fa85f64-5717-4562-b3fc-2c963f66afa6). The UUID can be obtained from the Company Search API.Maximum number of reviews to return.Default = 10Max value = 100
Number of reviews to skip before returning records. Use with
limit for pagination.Default = 0Example Request
Response
Successful Response Fields
Returns a JSON object with the following structure:Container object holding the company’s employee review data.
Limit applied to the request.
Offset applied to the request.
Credits consumed by the request.
Employee Reviews Object Fields
Overall company rating per review provider. Keys are provider identifiers (e.g.
glassdoor), values are floats.Dimension-level ratings broken out per provider. See Other Rating Object below.
Reviews container. See Reviews Object Fields below.
Other Rating Object
Rating dimension. Example values:
business_outlook, ceo, recommend_to_friend, compensation_and_benefits, culture_and_values, diversity_and_inclusion, senior_management, work_life_balance.Review provider identifier. Example:
glassdoor.Rating value. Sentiment-style dimensions (e.g.
business_outlook, ceo, recommend_to_friend) are returned as a 0 to 1 percentage; other dimensions are returned on a 0 to 5 scale.Reviews Object Fields
List of individual review objects. See Review Object Fields below.
Total number of reviews available for the company across all providers.
Total review count broken down by provider. Keys are provider identifiers (e.g.
glassdoor), values are integer counts.Review Object Fields
Unique identifier for the review.
Review headline or summary.
Pros described by the reviewer.
Cons described by the reviewer.
Overall star rating given by the reviewer.
Link to the original review on the provider’s site.
Job title of the reviewer. May be an empty string when not disclosed.
Publication date of the review. May be an empty string when not provided.
Employment type of the reviewer. Example values:
REGULAR, CONTRACT.true if the reviewer was a current employee at the time of writing.Reviewer’s tenure at the company in years.
Location of the reviewer. May be an empty string when not disclosed.
Country code of the reviewer’s location. May be an empty string when not disclosed.
Number of users who marked the review as helpful.
Number of users who marked the review as not helpful.
Reviewer’s rating for career opportunities.
null when not provided.Reviewer’s CEO sentiment. Example values:
APPROVE, DISAPPROVE. null when not provided.Reviewer’s rating for compensation and benefits.
null when not provided.Reviewer’s rating for culture and values.
null when not provided.Reviewer’s rating for diversity and inclusion.
null when not provided.Reviewer’s rating for senior management.
null when not provided.Reviewer’s rating for work-life balance.
null when not provided.Language code of the review. Example:
eng.Review provider identifier. Example:
glassdoor.Authorizations
API key obtained from your Akta account.
Query Parameters
Company website (e.g. 'canva.com') or a company UUID. The UUID can be obtained from the Company Search API.
Maximum number of reviews to return.
Required range:
x <= 100Number of reviews to skip before returning records. Use with limit for pagination.
.png?fit=max&auto=format&n=tMpg-r-6yeOIk-hz&q=85&s=e0cafcb914826d8adc60e5092187e1ca)
.png?fit=max&auto=format&n=tMpg-r-6yeOIk-hz&q=85&s=f214ebe0a940d8aa0f19a709a6bfd7fa)