Developer Network Home - Help

HotJobs Web Services

HotJobs RSS Feed

The Yahoo! HotJobs RSS feed enables you to get 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 web site or client application. The HotJobs RSS feed is a dynamically-generated feed; start with the base URL, add parameters for your location, the category of job you're looking for or other keywords and get back just the information you wish to see.

This page describes the format of the HotJobs RSS request URL and the RSS response for developers. It contains these sections:

RSS Request

The HotJobs RSS request URL comes in two flavors:

Basic Request

The basic HotJobs RSS feed request URL looks like this:

http://hotjobs.yahoo.com/rss/version/country/state/ city/category/keywords

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 (+).

For example, this URL searches for Java jobs all across the US:

http://hotjobs.yahoo.com/rss/0/USA/-/-/-/java

This URL searches for any jobs in Sunnyvale, CA:

http://hotjobs.yahoo.com/rss/0/USA/CA/Sunnyvale/-/-

And this example searches for legal jobs in San Jose.

http://hotjobs.yahoo.com/rss/0/USA/CA/San+Jose/LEG/-

See the table below for the possible values for each of the parameters.

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.

Parameter Value Description
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.
country string The country database to search in. The possible values are:

 

  • ALB: Albania
  • ASM: American Samoa
  • ATA: Antarctica
  • ARG: Argentina
  • ARM: Armenia
  • AUS: Australia
  • AUT: Austria
  • AZE: Azerbaijan
  • BHS: Bahamas
  • BHR: Bahrain
  • BEL: Belgium
  • BRA: Brazil
  • CAN: Canada
  • CHL: Chile
  • CHN: China
  • COL: Colombia
  • CUB: Cuba
  • CZE: Czech Republic
  • DNK: Denmark
  • DMA: Dominica
  • DOM: Dominican Republic
  • EGY: Egypt
  • FIN: Finland
  • FRA: France
  • DEU: Germany
  • GIB: Gibraltar
  • GUM: Guam
  • HKG: Hong Kong
  • HUN: Hungary
  • IND: India
  • IDN: Indonesia
  • IRQ: Iraq
  • IRL: Ireland
  • ISR: Israel
  • ITA: Italy
  • JPN: Japan
  • PRK: Korea, Democratic People's Republic OF
  • KOR: Korea, Republic Of
  • KWT: Kuwait
  • LUX: Luxembourg
  • MYS: Malaysia
  • MEX: Mexico
  • NLD: Netherlands
  • ANT: Netherlands Antilles
  • NZL: New Zealand
  • NGA: Nigeria
  • MNP: Northern Mariana Islands
  • OMN: Oman
  • PAK: Pakistan
  • PHL: Philippines
  • POL: Poland
  • PRT: Portugal
  • PRI: Puerto Rico
  • QAT: Qatar
  • RUS: Russian Federation
  • WSM: Samoa
  • SAU: Saudi Arabia
  • SGP: Singapore
  • ZAF: South Africa
  • ESP: Spain
  • SWE: Sweden
  • CHE: Switzerland
  • TWN: Taiwan
  • THA: Thailand
  • UGA: Uganda
  • UKR: Ukraine
  • ARE: United Arab Emirates
  • GBR: United Kingdom
  • UMI: United States Minor Outlying Islands
  • VEN: Venezuela
  • VIR: Virgin Islands (U.S.)
  • YUG: Yugoslavia
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.
category string (category) The job category or industry. HotJobs supports 30 possible categories:

 

  • FIN: Accounting/Finance
  • ADV: Advertising/Public Relations
  • ART: Arts/Entertainment/Publishing
  • BAM: Banking/Mortgage
  • ADM: Clerical/Administrative
  • CON: Construction/Facilities
  • CUS: Customer Service
  • EDU: Education/Training
  • ENG: Engineering/Architecture
  • GOV: Government/Military
  • HEA: Healthcare
  • HOS: Hospitality/Travel
  • HRS: Human Resources
  • INS: Insurance
  • NEW: Internet/New Media
  • LAW: Law Enforcement/Security
  • LEG: Legal
  • MCO: Management Consulting
  • MAN: Manufacturing/Operations
  • MAR: Marketing
  • NON: Non-Profit/Volunteer
  • SCI: Pharmaceutical/Biotech
  • RLE: Real Estate
  • RFS: Restaurant/Food Service
  • PUR: Retail
  • SAL: Sales
  • MIS: Technology
  • TEL: Telecommunications
  • TRA: Transportation/Logistics
  • OTH: Other
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.

Advanced Request

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 .

For the HotJobs advanced request, the base URL is:

hhttp://hotjobs.yahoo.com/api/jobsearch/search_results_rss.html?

For example, to get job postings in San Jose, CA, containing the keyword "writer", you would use this URL

http://hotjobs.yahoo.com/api/jobsearch/search_results_rss.html?keywords_all=writer&city1=San+Jose &state1=CA

This request contains three parameters:

See the table below for the parameter names and possible values.

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.

Parameter Value Description
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.
country1
string The country database to search in. The possible values are:

 

  • ALB: Albania
  • ASM: American Samoa
  • ATA: Antarctica
  • ARG: Argentina
  • ARM: Armenia
  • AUS: Australia
  • AUT: Austria
  • AZE: Azerbaijan
  • BHS: Bahamas
  • BHR: Bahrain
  • BEL: Belgium
  • BRA: Brazil
  • CAN: Canada
  • CHL: Chile
  • CHN: China
  • COL: Colombia
  • CUB: Cuba
  • CZE: Czech Republic
  • DNK: Denmark
  • DMA: Dominica
  • DOM: Dominican Republic
  • EGY: Egypt
  • FIN: Finland
  • FRA: France
  • DEU: Germany
  • GIB: Gibraltar
  • GUM: Guam
  • HKG: Hong Kong
  • HUN: Hungary
  • IND: India
  • IDN: Indonesia
  • IRQ: Iraq
  • IRL: Ireland
  • ISR: Israel
  • ITA: Italy
  • JPN: Japan
  • PRK: Korea, Democratic People's Republic OF
  • KOR: Korea, Republic Of
  • KWT: Kuwait
  • LUX: Luxembourg
  • MYS: Malaysia
  • MEX: Mexico
  • NLD: Netherlands
  • ANT: Netherlands Antilles
  • NZL: New Zealand
  • NGA: Nigeria
  • MNP: Northern Mariana Islands
  • OMN: Oman
  • PAK: Pakistan
  • PHL: Philippines
  • POL: Poland
  • PRT: Portugal
  • PRI: Puerto Rico
  • QAT: Qatar
  • RUS: Russian Federation
  • WSM: Samoa
  • SAU: Saudi Arabia
  • SGP: Singapore
  • ZAF: South Africa
  • ESP: Spain
  • SWE: Sweden
  • CHE: Switzerland
  • TWN: Taiwan
  • THA: Thailand
  • UGA: Uganda
  • UKR: Ukraine
  • ARE: United Arab Emirates
  • GBR: United Kingdom
  • UMI: United States Minor Outlying Islands
  • VEN: Venezuela
  • VIR: Virgin Islands (U.S.)
  • YUG: Yugoslavia
state1
state2		 string The two-character state code, for example, CA or AZ. If you specify multiple cities and states job listings in either location are included
city1
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).
industry1
industry2
industry3 		string (category) The job category or industry. If you specify more than one category, job listings for all categories are included. HotJobs supports 30 possible categories:

 

  • FIN: Accounting/Finance
  • ADV: Advertising/Public Relations
  • ART: Arts/Entertainment/Publishing
  • BAM: Banking/Mortgage
  • ADM: Clerical/Administrative
  • CON: Construction/Facilities
  • CUS: Customer Service
  • EDU: Education/Training
  • ENG: Engineering/Architecture
  • GOV: Government/Military
  • HEA: Healthcare
  • HOS: Hospitality/Travel
  • HRS: Human Resources
  • INS: Insurance
  • NEW: Internet/New Media
  • LAW: Law Enforcement/Security
  • LEG: Legal
  • MCO: Management Consulting
  • MAN: Manufacturing/Operations
  • MAR: Marketing
  • NON: Non-Profit/Volunteer
  • SCI: Pharmaceutical/Biotech
  • RLE: Real Estate
  • RFS: Restaurant/Food Service
  • PUR: Retail
  • SAL: Sales
  • MIS: Technology
  • TEL: Telecommunications
  • TRA: Transportation/Logistics
  • OTH: Other
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.
exp_level%5B%5D string The experience level requested for the job posting (%5E and %5D are the URL encoded values for [] and are part of the parameter name). The possible values are:

 

  • ENT: Entry level
  • INT: Internship
  • MID: Mid-Senior
  • EXE: Executive
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.
updated_since string Return only job listings posted or updated within a certain amount of time. Possible values are:

 

  • twodays: Within the past 2 days
  • week: Within the past 7 days
  • month: Within the past 30 days
  • sixtydays: Within the past 60 days
  • anytime: At any time

RSS Response Elements

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.  

Top-Level Elements

Element Description
xml The HotJobs RSS feed conforms to XML 1.0. No child elements.
rss The HotJobs RSS feed conforms to RSS 2.0.
Child elements: channel

Channel Elements

The channel element contains metadata about the feed and its contents.

Element Description
title The title of the feed, which includes the search criteria. For example "Yahoo! HotJobs: java, Sunnyvale, CA"
link A URL for the general location and category of the job search, for example, http://hotjobs.yahoo.com/jobs/CA/Sunnyvale/Accounting-Finance-jobs. For uncategorized searches, the category is All-jobs. The possible response categories are:
  • Accounting-Finance
  • Advertising-Public-Relations
  • Arts-Entertainment-Publishing
  • Banking-Mortgage
  • Clerical-Administrative
  • Construction-Facilities
  • Customer-Service
  • Education-Training
  • Engineering-Architecture
  • Government-Military
  • Healthcare
  • Hospitality-Travel
  • Human-Resources
  • Insurance
  • Internet-New-Media
  • Law-Enforcement-Security
  • Legal
  • Management-Consulting
  • Manufacturing-Operations
  • Marketing
  • Non-Profit-Volunteer
  • Pharmaceutical-Biotech
  • Real-Estate
  • Restaurant-Food-Service
  • Retail
  • Sales
  • Technology
  • Telecommunications
  • Transportation-Logistics
  • Other
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"
copyright The Yahoo! copyright statement for this feed.  
lastBuildDate The last time the feed was updated (the current date and time).
image The image used to identify this feed. See Image Elements for element descriptions
Child elements: url, title, link, width, height
ttl Time to Live; how long in minutes this feed should be cached.
webMaster The contact Email for this feed (webmaster-rss@hotjobs.com)
item A job listing. Each HotJobs feed contains multiple item elements for each job listing. See Item Elements for element descriptions.
Child elements: title, link, description, guid, pubDate

Image Elements

The image element describes an image or icon used to identify the feed.

Element Description
title The title of the image, for example "Hotjobs.com weblogs "
link The URL of the current search (same as the link element in the parent container)
url The URL of the image
width The width of the image, in pixels
height The height of the image, in pixels

Item Elements

Each item element contains a job listing.

Element Description
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.

Examples

To get job postings in San Jose containing the keyword "writer":

http://hotjobs.yahoo.com/rss/0/USA/CA/San+Jose/-/writer

To get job postings in San Jose containing the keywords "writer" and "java"

http://hotjobs.yahoo.com/rss/0/USA/CA/San+Jose/-/writer+java

To get job postings anywhere in the USA, in the Technology industry, containing the keyword "html":

http://hotjobs.yahoo.com/rss/0/USA/-/-/MIS/html

For job postings in San Jose containing the keyword "writer" using the advanced request format:

http://hotjobs.yahoo.com/api/jobsearch/search_results_rss.html?keywords_all=writer &city1=San+Jose &state1=CA

To get job postings anywhere in the USA, in the Technology industry, containing the keyword "html":

http://hotjobs.yahoo.com/api/jobsearch/search_results_rss.html?&keywords_all=html &industry1=MIS &country1=USA

For the same request as above, only searching for the keyword "html" in job titles only, and for postings updated only in the last 7 days:

http://hotjobs.yahoo.com/api/jobsearch/search_results_rss.html?&keywords_all=html &industry1=MIS &country1=USA &type=title &updated_since=week

A sample RSS response is shown below:

Acceptable Use

The Yahoo! HotJobs RSS Feed is limited to non-commercial use only. See information on our Usage Policy to learn about acceptable uses.

Copyright © 2008 Yahoo! Inc. All rights reserved.

Privacy Policy - Terms of Service - Copyright Policy - Job Openings