Skip to main content
GET
/
v1
/
company
/
employee-reviews
Employee Reviews
curl --request GET \
  --url https://api.akta.pro/api/v1/company/employee-reviews \
  --header 'x-api-key: <api-key>'
{
    "data": {
        "uuid": "00000jw-canva",
        "employee_reviews": {
            "overall_rating": {
                "glassdoor": 3.9
            },
            "other_ratings": [
                {
                    "type": "business_outlook",
                    "provider": "glassdoor",
                    "value": 0.7
                },
                {
                    "type": "ceo",
                    "provider": "glassdoor",
                    "value": 0.84
                },
                {
                    "type": "recommend_to_friend",
                    "provider": "glassdoor",
                    "value": 0.69
                },
                {
                    "type": "compensation_and_benefits",
                    "provider": "glassdoor",
                    "value": 3.9
                },
                {
                    "type": "culture_and_values",
                    "provider": "glassdoor",
                    "value": 3.7
                },
                {
                    "type": "diversity_and_inclusion",
                    "provider": "glassdoor",
                    "value": 4
                },
                {
                    "type": "senior_management",
                    "provider": "glassdoor",
                    "value": 3.1
                },
                {
                    "type": "work_life_balance",
                    "provider": "glassdoor",
                    "value": 3.7
                }
            ],
            "reviews": {
                "data": [
                    {
                        "id": 104118495,
                        "summary": "Decent pay amid constant changes",
                        "pros": "Pay is still somewhat decent",
                        "cons": "Things are changing too drastically.",
                        "rating": 2,
                        "review_link": "https://www.glassdoor.com/Reviews/Employee-Review--RVW104118495.htm",
                        "job_title": "Customer Service Representative",
                        "review_date": "",
                        "employment_status": "REGULAR",
                        "is_current_employee": true,
                        "years_of_employment": 6,
                        "location": "Austin, TX",
                        "country_code": "",
                        "helpful_count": 0,
                        "not_helpful_count": 0,
                        "career_opportunities_rating": 2,
                        "ceo_rating": "APPROVE",
                        "compensation_and_benefits_rating": 2,
                        "culture_and_values_rating": 1,
                        "diversity_and_inclusion_rating": 4,
                        "senior_management_rating": 1,
                        "work_life_balance_rating": 2,
                        "language": "eng",
                        "provider": "glassdoor"
                    },
                    {
                        "id": 104093537,
                        "summary": "Great benefits and work-life balance, but slow career growth",
                        "pros": "Great benefits. Employer friendly. Great work life balance",
                        "cons": "Career progression is very hard",
                        "rating": 4,
                        "review_link": "https://www.glassdoor.com/Reviews/Employee-Review--RVW104093537.htm",
                        "job_title": "Technical Lead",
                        "review_date": "",
                        "employment_status": "REGULAR",
                        "is_current_employee": true,
                        "years_of_employment": 0,
                        "location": "Melbourne",
                        "country_code": "",
                        "helpful_count": 0,
                        "not_helpful_count": 0,
                        "career_opportunities_rating": 3,
                        "ceo_rating": null,
                        "compensation_and_benefits_rating": 4,
                        "culture_and_values_rating": 4,
                        "diversity_and_inclusion_rating": 4,
                        "senior_management_rating": 3,
                        "work_life_balance_rating": 4,
                        "language": "eng",
                        "provider": "glassdoor"
                    }
                ],
                "total": 1068,
                "total_by_provider": {
                    "glassdoor": 1068
                }
            }
        }
    },
    "limit": 10,
    "offset": 0,
    "credits_consumed": 1.5
}

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-key request header.

Request

Request Parameters

Header Parameters

x-api-key
string
required
Your API key.

URL Parameters

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

Example Request

GET /v1/company/employee-reviews?company=canva.com&limit=10&offset=0
x-api-key: <your_api_key>
GET /v1/company/employee-reviews?company=3fa85f64-5717-4562-b3fc-2c963f66afa6
x-api-key: <your_api_key>

Response

Successful Response Fields

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

Employee Reviews Object Fields

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

Other Rating Object

type
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.
provider
string
Review provider identifier. Example: glassdoor.
value
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

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

Review Object Fields

id
integer
Unique identifier for the review.
summary
string
Review headline or summary.
pros
string
Pros described by the reviewer.
cons
string
Cons described by the reviewer.
rating
integer
Overall star rating given by the reviewer.
Link to the original review on the provider’s site.
job_title
string
Job title of the reviewer. May be an empty string when not disclosed.
review_date
string
Publication date of the review. May be an empty string when not provided.
employment_status
string
Employment type of the reviewer. Example values: REGULAR, CONTRACT.
is_current_employee
boolean
true if the reviewer was a current employee at the time of writing.
years_of_employment
integer
Reviewer’s tenure at the company in years.
location
string
Location of the reviewer. May be an empty string when not disclosed.
country_code
string
Country code of the reviewer’s location. May be an empty string when not disclosed.
helpful_count
integer
Number of users who marked the review as helpful.
not_helpful_count
integer
Number of users who marked the review as not helpful.
career_opportunities_rating
integer
Reviewer’s rating for career opportunities. null when not provided.
ceo_rating
string
Reviewer’s CEO sentiment. Example values: APPROVE, DISAPPROVE. null when not provided.
compensation_and_benefits_rating
integer
Reviewer’s rating for compensation and benefits. null when not provided.
culture_and_values_rating
integer
Reviewer’s rating for culture and values. null when not provided.
diversity_and_inclusion_rating
integer
Reviewer’s rating for diversity and inclusion. null when not provided.
senior_management_rating
integer
Reviewer’s rating for senior management. null when not provided.
work_life_balance_rating
integer
Reviewer’s rating for work-life balance. null when not provided.
language
string
Language code of the review. Example: eng.
provider
string
Review provider identifier. Example: glassdoor.
{
    "data": {
        "uuid": "00000jw-canva",
        "employee_reviews": {
            "overall_rating": {
                "glassdoor": 3.9
            },
            "other_ratings": [
                {
                    "type": "business_outlook",
                    "provider": "glassdoor",
                    "value": 0.7
                },
                {
                    "type": "ceo",
                    "provider": "glassdoor",
                    "value": 0.84
                },
                {
                    "type": "recommend_to_friend",
                    "provider": "glassdoor",
                    "value": 0.69
                },
                {
                    "type": "compensation_and_benefits",
                    "provider": "glassdoor",
                    "value": 3.9
                },
                {
                    "type": "culture_and_values",
                    "provider": "glassdoor",
                    "value": 3.7
                },
                {
                    "type": "diversity_and_inclusion",
                    "provider": "glassdoor",
                    "value": 4
                },
                {
                    "type": "senior_management",
                    "provider": "glassdoor",
                    "value": 3.1
                },
                {
                    "type": "work_life_balance",
                    "provider": "glassdoor",
                    "value": 3.7
                }
            ],
            "reviews": {
                "data": [
                    {
                        "id": 104118495,
                        "summary": "Decent pay amid constant changes",
                        "pros": "Pay is still somewhat decent",
                        "cons": "Things are changing too drastically.",
                        "rating": 2,
                        "review_link": "https://www.glassdoor.com/Reviews/Employee-Review--RVW104118495.htm",
                        "job_title": "Customer Service Representative",
                        "review_date": "",
                        "employment_status": "REGULAR",
                        "is_current_employee": true,
                        "years_of_employment": 6,
                        "location": "Austin, TX",
                        "country_code": "",
                        "helpful_count": 0,
                        "not_helpful_count": 0,
                        "career_opportunities_rating": 2,
                        "ceo_rating": "APPROVE",
                        "compensation_and_benefits_rating": 2,
                        "culture_and_values_rating": 1,
                        "diversity_and_inclusion_rating": 4,
                        "senior_management_rating": 1,
                        "work_life_balance_rating": 2,
                        "language": "eng",
                        "provider": "glassdoor"
                    },
                    {
                        "id": 104093537,
                        "summary": "Great benefits and work-life balance, but slow career growth",
                        "pros": "Great benefits. Employer friendly. Great work life balance",
                        "cons": "Career progression is very hard",
                        "rating": 4,
                        "review_link": "https://www.glassdoor.com/Reviews/Employee-Review--RVW104093537.htm",
                        "job_title": "Technical Lead",
                        "review_date": "",
                        "employment_status": "REGULAR",
                        "is_current_employee": true,
                        "years_of_employment": 0,
                        "location": "Melbourne",
                        "country_code": "",
                        "helpful_count": 0,
                        "not_helpful_count": 0,
                        "career_opportunities_rating": 3,
                        "ceo_rating": null,
                        "compensation_and_benefits_rating": 4,
                        "culture_and_values_rating": 4,
                        "diversity_and_inclusion_rating": 4,
                        "senior_management_rating": 3,
                        "work_life_balance_rating": 4,
                        "language": "eng",
                        "provider": "glassdoor"
                    }
                ],
                "total": 1068,
                "total_by_provider": {
                    "glassdoor": 1068
                }
            }
        }
    },
    "limit": 10,
    "offset": 0,
    "credits_consumed": 1.5
}

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>