Indeed Job Search

Last Updated 7/1/2015

The Indeed API searches several websites, job boards, staffing firms, associations and company pages and aggredates the results into a single XML list to display. To use the Indeed API, you must create a Publisher account to receive an API key. To do this use the following link: https://ads.indeed.com/jobroll/signup​​

Attribution

​You must use the following attribution when displaying Indeed's job search results.

<span id=indeed_at><a href="http://www.indeed.com/">jobs</a> by <a href="http://www.indeed.com/" title="Job Search"><img ​src="http://www.indeed.com/p/jobsearch.gif" style="border: 0; vertical-align: middle;" alt="Indeed job search"></a></span>​

DNS Caching

To maintain redundancy across multiple geographic regions, your application should regularly update the api.indeed.com IP address from our DNS servers.​

publisher
Publisher ID. Your publisher ID is "xxxxAPI Keyxxxxx". This is assigned when you register as a publisher.
v
Version. Which version of the API you wish to use. All publishers should be using version 2. Currently available versions are 1 and 2. This parameter is required.
format
Format. Which output format of the API you wish to use. The options are "xml" and "json." If omitted or invalid, the XML format is used.
callback
Callback. The name of a javascript function to use as a callback to which the results of the search are passed. This only applies when format=json. For security reasons, the callback name is restricted letters, numbers, and the underscore character.
q
Query. By default terms are ANDed. To see what is possible, use our advanced search page to perform a search and then check the url for the q value.
l
Location. Use a postal code or a "city, state/province/region" combination.
sort
Sort by relevance or date. Default is relevance.
radius
Distance from search location ("as the crow flies"). Default is 25.
st
Site type. To show only jobs from job boards use 'jobsite'. For jobs from direct employer websites use 'employer'.
jt
Job type. Allowed values: "fulltime", "parttime", "contract", "internship", "temporary".
start
Start results at this result number, beginning with 0. Default is 0.
limit
Maximum number of results returned per query. Default is 10
fromage
Number of days back to search.
highlight
Setting this value to 1 will bold terms in the snippet that are also present in q. Default is 0.
filter
Filter duplicate results. 0 turns off duplicate job filtering. Default is 1.
latlong
If latlong=1, returns latitude and longitude information for each job result. Default is 0.
co
Search within country specified. Default is the United States (us). See below for a complete list of supported countries.
chnl
Channel Name: Group API requests to a specific channel
userip
The IP number of the end-user to whom the job results will be displayed. This field is required.
useragent
The User-Agent (browser) of the end-user to whom the job results will be displayed. This can be obtained from the "User-Agent" HTTP request header from the end-user. This field is required.

Sample Request

Sample format of an xml request:

http://api.indeed.com/ads/apisearch?​publisher=APIKey&q=java&l=austin%2C+tx&sort=&radius=&st=&jt=&start=&limit=&fromage=&filter=&latlong=1&co=us&chnl=&userip=1.2.3.4&useragent=Mozilla/%2F4.0%28Firefox%29&v=2

IOER Site Footer

Copyright © 2012 - 2017 Illinois Department of Commerce and Economic Opportunity and Illinois State Board of Education

WEB11 | 2017-06-28a