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
}
}
]
}
}