API Overview

The Glassdoor API is a simple, lightweight REST API that responds to http requests with JSON (future support for XML is planned). Because it is a REST API, it is completely stateless. Requests are expected to be made in the form of a simple HTTP GET.

The APIs that are not provided publicly are available to our API partners. If you're interested in becoming an API partner, please contact us.

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:

Request Structure

All Glassdoor API requests share some common parameters, and a typical call will look like this:

http://api.glassdoor.com/api/api.htm?v=1&format=json&t.p=120&t.k=fz6JLNDfgVs&action=employers&q=pharmaceuticals&userip=192.168.43.42&useragent=Mozilla/%2F4.0

The common required parameters here are:

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	The particular API call that you would like to make - see jobs, reviews, salaries, etc. sub-sections for details	Yes
other	Each API action will require different parameters - in the example above, an employerId is passed in order to retrieve reviews.	Varies

Response Structure

All requests will return at least status information, and a typical json response will look like this:

{
    "success": true,
    "status": "OK",
    "response": {
        //Responsejsondependingontheaction
    }
}

Response Codes

You can always count on a high level success flag which will be either true or false, and status which will typically indicate additional information. If the call is successful, there will be a 'response' block. Common statuses are:

OK: request succeeded
Access-Denied: your partner id/key are not correct, or not specified. Check the t.p and t.k params in your request
Call-specific errors: for example on employer retrieval, it can return Employer-Not-Found