The Yahoo! HotJobs RSS feed delivers HotJobs search results as an RSS feed. You can then save those results in My Yahoo! or your favorite feed aggregator, or incorporate that data into your own website or client application. The HotJobs RSS feed is a dynamically-generated feed: start with the base URL, add parameters for your location, the job category you're looking for, or other relevant keywords. You'll get back just the information you've requested.
Where each of the values of version, country, state, city, category, and keywords are be replaced with search elements. Replace unused elements with a dash (-). The version is required and is currently 0. All values must be URL encoded; most often this means that any spaces (in state, city or between keywords) must be replaced with a plus sign (+).
And this example searches for legal jobs in San Jose.
Note that this is the same RSS URL that is generated by the HotJobs search page. You can enter search keys and a location into the form on that page and then copy the URL from the orange XML button on the results page to quickly generate a basic HotJobs RSS request URL.
Yahoo! HotJobs returns an RSS 2.0 feed in response to this request. You can subscribe to the request URL with My Yahoo! or another RSS feed aggregator, or you can incorporate the information in the RSS response into your own application. See RSS Response Elements for information on the elements contained in the RSS feed.
keywords string Keywords to search for. Matching job listings must contain all the keywords given.
version 0 Search release version. Currently the only version is 0.
state string The two-character state code, for example, CA or AZ.
city string The city name. City names with spaces should have spaces URL encoded with +, for example San+Jose.
To search in all categories in the basic request, use a dash (-) as the category.
keywords string Keywords to search for. Multiple keywords must be separated by +, for example perl+php.
The basic HotJobs request only enables you to specify location, category, and keywords. The advanced request enables many more options including different kinds of keyword searches (all of the words, any of the words, none of the words, exact match), multiple location and category searches, or whether to limit the results to those posted within a certain time period.
The HotJobs advanced RSS request follows HTTP GET syntax: start with a base URL and then add parameters and values after a question mark(?). The feed parameters have the form parameter=value. All parameter names and values must be URL encoded .
city1: for the city. Note that "San Jose" has been URL encoded (the space has been replaced with +).
See the table below for the parameter names and possible values.
keywords_all string Keywords to search for. Matching job listings must contain all the keywords given. All the keywords fields can be used in combination.
keywords_phrase string Keywords to search for. Matching job listings must contain the exact phrase. All the keywords fields can be used in combination.
keywords_any string Keywords to search for. Matching job listings may contain any of these keywords. All the keywords fields can be used in combination.
keywords_none string Keywords to search for. Matching job listings may not contain any of these keywords. All the keywords fields can be used in combination.
type 0 or title If the value is "title" only the job titles are searched. If 0, both title and job posting body are searched.
city2 string The city name. City names with spaces should have spaces URL encoded with +, for example San+Jose. If you specify multiple cities and states job listings in either location are included.
metro_area 0 or 1 Whether to search in the wider metropolitan area around the given location(s).
salary_minimum string The minimum salary required. You can specify the salary as a yearly (45000) or an hourly (10.50) amount.
salary_type year or hour The type of salary data given in salary_minimum. For a yearly salary, use year. For an hourly salary, use hour.
require_salary 0 or 1 Whether the search should include only postings with salary information. 0 for no, 1 for yes.
You may specify more than one experience level with multiple exp_level parameters.
search_corp 0 or 1 Whether direct employers should be included in the job search. 0 for no, 1 for yes.
search_agencies 0 or 1 Whether staffing agencies should be included in the job search. 0 for no, 1 for yes.
The HotJobs RSS feed is an XML document that conforms to the RSS 2.0 specification. RSS is an XML document containing a single channel element representing the feed, several elements containing metadata about the feed itself, and one or more item elements describing individual items within the feed.
xml The HotJobs RSS feed conforms to XML 1.0. No child elements.
rss The HotJobs RSS feed conforms to RSS 2.0.
title The title of the feed, which includes the search criteria. For example "Yahoo! HotJobs: java, Sunnyvale, CA"
language The language of the alert, for example, en-us for US English.
description The description of the feed including the search criteria (location, keywords, category), for example "Top HotJobs results for jobs matching: Sunnyvale, CA, Accounting/Finance"
lastBuildDate The last time the feed was updated (the current date and time).
item A job listing. Each HotJobs feed contains multiple item elements for each job listing. See Item Elements for element descriptions.
title The title of the image, for example "Hotjobs.com weblogs "
Each item element contains a job listing.
title The job title, company name, and location of the job listing, for example "Sr System Administrator - Bulkware Inc - San jose, CA USA"
link The HotJobs URL for the job listing.
description The company name of the job listing, for example, "Company: Bulkware, Inc"
guid Unique identifier for the item. For job listings the guid is the HotJobs ID for the listing. The attribute isPermaLink is false.
pubDate The date and time this job listing was posted, in the date format defined by RFC822 Section 5, for example Mon, 256 Sep 17:25:18 -0700.
To get job postings in San Jose containing the keywords "writer" and "java"
Questions and suggestions on the HotJobs web services are discussed on the Yahoo! HotJobs Developer Community forum. If you have questions or need technical support, please use this forum.
The Yahoo! HotJobs RSS Feed is limited to non-commercial use only. See information on our Usage Policy to learn about acceptable uses.