Skip to main content
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: /api/v1/company/employee-reviews

Authentication requirements

  • Include a valid API key in the x-api-key request header.

Request

Request Parameters

Header Parameters

string
required
Your API key.

URL Parameters

string
required
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.
integer
Maximum number of reviews to return.Default = 10Max value = 100
integer
Number of reviews to skip before returning records. Use with limit for pagination.Default = 0

Example Request

Response

Successful Response Fields

Returns a JSON object with the following structure:
object
Container object holding the company’s employee review data.
integer
Limit applied to the request.
integer
Offset applied to the request.
float
Credits consumed by the request.

Employee Reviews Object Fields

object
Overall company rating per review provider. Keys are provider identifiers (e.g. glassdoor), values are floats.
array of objects
Dimension-level ratings broken out per provider. See Other Rating Object below.
object
Reviews container. See Reviews Object Fields below.

Other Rating Object

string
Rating dimension. Example values: business_outlook, ceo, recommend_to_friend, compensation_and_benefits, culture_and_values, diversity_and_inclusion, senior_management, work_life_balance.
string
Review provider identifier. Example: glassdoor.
float
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

array of objects
List of individual review objects. See Review Object Fields below.
integer
Total number of reviews available for the company across all providers.
object
Total review count broken down by provider. Keys are provider identifiers (e.g. glassdoor), values are integer counts.

Review Object Fields

integer
Unique identifier for the review.
string
Review headline or summary.
string
Pros described by the reviewer.
string
Cons described by the reviewer.
integer
Overall star rating given by the reviewer.
Link to the original review on the provider’s site.
string
Job title of the reviewer. May be an empty string when not disclosed.
string
Publication date of the review. May be an empty string when not provided.
string
Employment type of the reviewer. Example values: REGULAR, CONTRACT.
boolean
true if the reviewer was a current employee at the time of writing.
integer
Reviewer’s tenure at the company in years.
string
Location of the reviewer. May be an empty string when not disclosed.
string
Country code of the reviewer’s location. May be an empty string when not disclosed.
integer
Number of users who marked the review as helpful.
integer
Number of users who marked the review as not helpful.
integer
Reviewer’s rating for career opportunities. null when not provided.
string
Reviewer’s CEO sentiment. Example values: APPROVE, DISAPPROVE. null when not provided.
integer
Reviewer’s rating for compensation and benefits. null when not provided.
integer
Reviewer’s rating for culture and values. null when not provided.
integer
Reviewer’s rating for diversity and inclusion. null when not provided.
integer
Reviewer’s rating for senior management. null when not provided.
integer
Reviewer’s rating for work-life balance. null when not provided.
string
Language code of the review. Example: eng.
string
Review provider identifier. Example: glassdoor.

Authorizations

x-api-key
string
header
required

API key obtained from your Akta account.

Query Parameters

company
string
required

Company website (e.g. 'canva.com') or a company UUID. The UUID can be obtained from the Company Search API.

limit
integer
default:10

Maximum number of reviews to return.

Required range: x <= 100
offset
integer
default:0

Number of reviews to skip before returning records. Use with limit for pagination.

Response

Employee reviews returned

data
object
limit
integer
offset
integer
credits_consumed
number<float>