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:

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

Parameter	Explanation	Required?
v	The API version. The current version is 1 except for jobs, which is currently version 1.1	Yes
format	Either xml or json as you prefer	Yes
t.p	Your partner id, as assigned by Glassdoor	Yes
t.k	Your partner key, as assigned by Glassdoor	Yes
userip	The IP address of the end user to whom the API results will be shown	Yes
useragent	The 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-user	Yes
callback	If 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
action	Must be set to employers	Yes
q	Query phrase to search for - can be any combination of employer or occupation, but location should be in l param.	No
l	Scope the search to a specific location by specifying it here - city, state, or country.	No
city	Scope the search to a specific city by specifying it here.	No
state	Scope the search to a specific state by specifying it here.	No
country	Scope the search to a specific country by specifying it here.	No
pn	Page number to retrieve. Default is 1.	No
ps	Page 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
                }
            }
        ]
    }
}