Glassdoor Company API Documentation | Glassdoor

Glassdoor uses cookies to improve your site experience. By continuing, you agree to our use of cookies. OK | Learn More

Glassdoor data helps people everywhere find jobs they love. Check out our public API.

Companies Actions

The companies actions are used to search for employers. There are 4 actions currently supported:

  • Company Search: Search for companies by name, keyword, job title, location, or industry.

Attribution

You must use the following attribution when displaying Glassdoor's API results. Copy the code below and paste it near the results on your web page:

powered by

Company Search

A company search request must specify "employers" for the action parameter in addition to the other required parameters, and then can optionally scope the search using the parameters below. A typical call will look like this:

http://api.glassdoor.com/api/api.htm?t.p=5317&t.k=n07aR34Lk3Y&userip=0.0.0.0&useragent=&format=json&v=1&action=employers

Parameters

ParameterExplanationRequired?
vThe API version. The current version is 1 except for jobs, which is currently version 1.1Yes
formatEither xml or json as you preferYes
t.pYour partner id, as assigned by GlassdoorYes
t.kYour partner key, as assigned by GlassdoorYes
useripThe IP address of the end user to whom the API results will be shownYes
useragentThe User-Agent (browser) of the end user to whom the API results will be shown. Note that you can can obtain this from the "User-Agent" HTTP request header from the end-userYes
callbackIf json is the requested format, you may specify a jsonp callback here, allowing you to make cross-domain calls to the glassdoor API from your client-side javascript. See the JSONP wikipedia entry for more information on jsonp.No
actionMust be set to employersYes
qQuery phrase to search for - can be any combination of employer or occupation, but location should be in l param.No
lScope the search to a specific location by specifying it here - city, state, or country.No
cityScope the search to a specific city by specifying it here.No
stateScope the search to a specific state by specifying it here.No
countryScope the search to a specific country by specifying it here.No
pnPage number to retrieve. Default is 1.No
psPage size, i.e. the number of jobs returned on each page of results. Default is 20.No

Response Structure

A typical employers json response will look like this:

{
    "success": true,
    "status": "OK",
    "response": {
        "currentPageNumber": 1,
        "totalNumberOfPages": 151,
        "totalRecordCount": 1510,
        "employers": [
            {
                "id": 354,
                "name": "IBM",
                "website": "www.ibm.com",
                "isEEP": false,
                "exactMatch": false,
                "industry": "",
                "numberOfRatings": 0,
                "squareLogo": "http://media.glassdoor.com/sqll/354/ibm-squarelogo.png",
                "overallRating": 0,
                "ratingDescription": "Not Applicable",
                "cultureAndValuesRating": "3.6",
                "seniorLeadershipRating": "2.9",
                "compensationAndBenefitsRating": "2.6",
                "careerOpportunitiesRating": "2.9",
                "workLifeBalanceRating": "3.5",
                "featuredReview": {
                    "id": 3855871,
                    "currentJob": false,
                    "reviewDateTime": "2014-03-12 04:56:58.41",
                    "jobTitle": "Employee",
                    "location": "",
                    "headline": "an extremly good compagny with very high benefits and perfectly committed to its employees with a great compagny culture",
                    "pros": "an extremly good compagny with very high benefits and perfectly committed to its employees with a great compagny culture",
                    "cons": "opportunities to travel to conference have been reduced"
                },
                "ceo": {
                    "name": "Virginia Rometty",
                    "title": "CEO",
                    "image": {
                        "src": "http://media.glassdoor.com/people/ceo/354/ibm-virginia-rometty.png",
                        "height": 50,
                        "width": 40
                    },
                    "numberOfRatings": 0,
                    "pctApprove": 0,
                    "pctDisapprove": 0
                }
            }
        ]
    }
}