Resumé Search

Welcome, guest Sign In

My Projects
Tools & Services
APIs and Services
- Flickr
- Geo
- Mail
- Search
- Social
- Updates
- YAP
- YQL
Developer Tools
- Hadoop
- YUI
- YSlow
- View all »
Resources
- Blog
- YDN Theater
- Hack U

YDN Resumé Search

Prev — Authentication

Modify Search — Next

Resumé Search

This web service allows you to provide your search criteria to the Yahoo! HotJobs resumé search API. Please note that results will not be returned immediately on calling this web service, but will be available once a call is made for the Search Results web service with the search ID available as a result of this call. You can use a variety of criteria for searching the candidates, the details of which are available below. It is noteworthy that the search ID available to you can also be used to modify the search criteria that you have provided.

As already mentioned, please note that you need to have a valid resumé search license to get search results; otherwise you will receive appropriate error messages. Also, please note that you can have a maximum of one search active per HotJobs user session – if you create a new search, the older search ID is automatically deactivated.

This web service will also return the number of candidates that you can expect as a result of your query, if your query is a success.

URI

http://hj.yahooapis.com/v1/ResumeFilters

HTTP Method

POST

HTTP Request Body

Resumé Search XML Request

HTTP Custom Headers

X-Yahoo-HJAuth-Token
This is session token returned by Authentication web service.

X-Yahoo-HJAuth-Timestamp
This should be the request timestamp in Unix Timestamp format, which is the difference, measured in milliseconds, between the current time and midnight, January 1, 1970 UTC.

X-Yahoo-HJAuth-Signature
The signature is MD5 hash (in Hexadecimal format) of the concatenation of the XML request, request timestamp, token and the license key. For example,

XML Request = <?xml version="1.0" encoding="UTF-8"?><SearchCriteria><SearchCriterion><CriterionName>Keywords</CriterionName><CriterionValue>Software Engineer</CriterionValue></SearchCriterion></SearchCriteria>
Request Timestamp = 1234567890
Token = ABC123xyz--
License Key = b0ab1bfdd898b7588142e820a2af1a07

Hash string (XML Request + Request Timestamp + Token + License Key) = <?xml version="1.0" encoding="UTF-8"?><SearchCriteria><SearchCriterion><CriterionName>Keywords</CriterionName><CriterionValue>Software Engineer</CriterionValue></SearchCriterion></SearchCriteria>1234567890ABC123xyz--b0ab1bfdd898b7588142e820a2af1a07
Signature (MD5 hash of the hash string) = 71f59ffdabe7dd977eace08b18713594

Request XML for Resumé Search

Valid values for NAME field

Please note that the NAME field can have the following values -

Keywords
Location (Maximum of 3 Occurrences)
Relocation (Maximum of 3 Occurrences)
USSecurityClearance
WorkAuthCountry (Maximum of 3 Occurrences)
JobCategory (Maximum of 10 Occurrences)
EditedWithin
SinceLastSignIn
Experience (Maximum of 5 Occurrences)
MinSalary
MaxSalary
SalaryUnspecified
MostRecentJobTitle
MostRecentEmployer
Education (Maximum of 3 Occurrences)
School (Maximum of 3 Occurrences)
Language (with proficiency) (Maximum of 3 Occurrences)
FirstName
LastName
Email
PositionType (Maximum of 4 Occurrences)
Commitment (Maximum of 2 Occurrences)
BasicQualifications
AdditionalDetails

The VALUE for Location should be specified in following XML format:

Please note that if any location is not provided, a worldwide search will be performed.

The VALUE for Language should be specified in following XML format:

The attribute ‘Proficiency’ should be left blank or omitted to find all candidates irrespective of their proficiency preference.

Value Parameters

Table 2. Bold - Indicates default value
Parameter	Data Type	Valid Values	Max Length	Description
Keywords	String	Text	256	Keywords separated by spaces, phrases in quotes, or Boolean expressions. Options available for supporting basic Boolean operators such as AND, NOT, OR & exact phrases.
Municipality (City)	String	Text	70	City in which the job seeker resides. If a city is specified, then a state or country must be specified.
Region (State)	String	See Valid Values 2-letter state abbreviations	2	State where the job seeker resides. Required, if a city in the US is specified.
Region (Province)	String	See Valid Values 2-letter province abbreviations	2	Province/ Territory where the job seeker resides. Applicable to Canada only. Required, if a city in Canada is specified.
Region (International State)	String	Text	70	Applicable to any country other than US or Canada.
PostalCode (Zip)	String	Text	5	5-digit postal code. Applicable to US only.
Radius	Number	Any one of the following values 0 5 10 15 20 25 50 100 500 1000	4	Sub-option for location search. Search also includes the surrounding metropolitan area. This option is available for US and Canada only. In addition, the radius is in Miles for US and Kilometers for Canada. 0 implies that the candidate must reside in the location provided.
CountryCode	String	View Valid Values 3-letter country abbreviations	3	Country where the job seeker resides.
Relocation	String	View Valid Values	6	DMA (Demographic Metropolitan Area) / State / Country relocation codes where the job seeker is willing to relocate to.
USSecurityClearance	Boolean	Yes / No	3	US security clearance.
WorkAuthCountry	String	View valid values 3-letter ISO code	3	Country where the job seeker is authorized to work. Up to three countries may be selected.
JobCategory	String	View valid values 3-letter code	3	Job category specified by the job seeker. Up to 10 categories may be specified.
EditedWithin	String	Any one of the following values 0 1 2 3 4 5 7 14 30 60 90 120 365 INT1 INT2 INT3 INT4 INT5 INT6 INT7	4	Range of resumes to search. Key for terms is (in order) Any Age Last 1 day Last 2 days Last 3 days Last 4 days Last 5 days Last 7 days Last 14 days Last 30 days Last 60 days Last 90 days Last 120 days Last 365 days Last 30-60 days Last 60-90 days Last 90-120 days Last 120-365 days Last 1-2 years Last 2-3 years Last 3+ years
SinceLastSignIn	Number	1 = Yes 0 = No	1	Show resumes edited since last sign-in.
Experience	String	All 0-1 1-2 2-5 5-10 10-15 15+	5	Experience level of the job seeker. All values may be selected. Key for terms is, in order All years 0-1 years 1-2 years 2-5 years 5-10 years 10-15 years 15+ years
MinSalary	Number	20000 25000 30000 35000 40000 45000 50000 55000 60000 65000 70000 75000 80000 85000 90000 95000 100000 110000 120000 130000 140000 150000 160000 175000 200000	6	Lower limit for approximate salary.
MaxSalary	Number	Same as above	6	Upper limit for approximate salary.
SalaryUnspecified	Number	1 = Yes 0 = No	1	Include resumes where annual salary is unspecified.
MostRecentJobTitle	String	Text	256	Most recent job title. Boolean operators are supported.
MostRecentEmployer	String	Text	256	Most recent employer name. Boolean operators are not supported.
Education	String	Any one of the following values: HS A BS BA BBA JD MS MA MD MBA MFA B M PhD OTH	3	Education level of the job seeker. Up to three Education levels may be specified. If no value is specified, all candidates will be considered. Key for terms (in order): High School Associate Bachelor of Science Bachelor of Arts Bachelor of Business Administration Juris Doctorate Master of Science Master of Arts Medical Doctor Master of Business Administration Master of Fine Arts Bachelors Degree Masters Degree PhD Other
School	String	Text	256	School(s) attended by the job seeker. Up to three schools may be specified.
Language	String	US UK CN HK TW B5 DK DT AU CA H1 IN NZ SG AA FI CF FR DE GR IT JP KR MA NO BR AR MX ES E1 SE	2	up to three language and proficiency combinations may be specified. If no value is specified, all candidates will be selected, irrespective of their language preferences. Key for terms (in order): English – United States English – United Kingdom Chinese – China (Mainland) Chinese – Hong Kong Chinese – Taiwan Chinese – US and other Danish – Denmark Dutch – Netherlands English – Australia English – Canada English – Hong Kong English – India English – New Zealand English – Singapore English – Other Asia Finnish – Finland French – Canada French – France German – Germany Greek – Greece Italian – Italy Japanese – Japan Korean – Korea Malay – Malaysia Norwegian – Norway Portuguese – Brazil Spanish – Argentina Spanish – Mexico Spanish – Spain Spanish – US & Other Swedish – Sweden
Proficiency (Attribute)	String	Basic Intermediate Fluent	12	up to three language and proficiency combinations may be specified.
FirstName	String	Text	256	First name of a job seeker.
LastName	String	Text	256	Last name of a job seeker.
Email	String	Text	256	Email ID of a job seeker.
PositionType	String	ALL PERM CONT TEMP TEMPHIRE	8	Key for terms in order: All Types Permanent Contract Temp Temp-to-hire
Commitment	String	FT PT	2	Key for terms in order is – Full time Part time
BasicQualifications	String	Text	256	Basic qualifications expected of the candidate(s). This is useful ONLY for OFCCP (Office of Federal Contact Compliance Programs) customers.
AdditionalDetails	String	Text	256	E.g. Job ID of position for which search is being made, data management techniques, etc. This is useful ONLY for OFCCP customers.

Request XML Sample for Resumé Search

<?xml version="1.0" encoding="UTF-8"?>
<SearchCriteria>
   
    <SearchCriterion>
        <CriterionName>Keywords</CriterionName>
        <CriterionValue>Unix C++</CriterionValue>
    </SearchCriterion>

<SearchCriterion>
        <CriterionName>Location</CriterionName>
        <CriterionValue>
        <Location>
            <Municipality>Sunnyvale</Municipality>
            <Region>CA</Region>
            <CountryCode>USA</CountryCode>
            <Radius>0</Radius>
        </Location>
        </CriterionValue>
    </SearchCriterion>

<SearchCriterion>
        <CriterionName>Location</CriterionName>
        <CriterionValue>
        <Location>
            <Municipality>New york</Municipality>
            <Region>NY</Region>
            <CountryCode>USA</CountryCode>
        </Location>
        </CriterionValue>
    </SearchCriterion>

<SearchCriterion>
        <CriterionName>Relocation</CriterionName>
        <CriterionValue>CA_828</CriterionValue>
    </SearchCriterion>

<SearchCriterion>
        <CriterionName>USSecurityClearance</CriterionName>
        <CriterionValue>Yes</CriterionValue>
    </SearchCriterion>

<SearchCriterion>
        <CriterionName>WorkAuthCountry</CriterionName>
        <CriterionValue>USA</CriterionValue>
    </SearchCriterion>

<SearchCriterion>
        <CriterionName>WorkAuthCountry</CriterionName>
        <CriterionValue>CAN</CriterionValue>
    </SearchCriterion>

<SearchCriterion>
        <CriterionName>JobCategory</CriterionName>
        <CriterionValue>AVI</CriterionValue>
    </SearchCriterion>
    
    <SearchCriterion>
        <CriterionName>JobCategory</CriterionName>
        <CriterionValue>FIN</CriterionValue>
    </SearchCriterion>
    
    <SearchCriterion>
        <CriterionName>EditedWithin</CriterionName>
        <CriterionValue>0</CriterionValue>
    </SearchCriterion>
    
    <SearchCriterion>
        <CriterionName>SinceLastSignIn</CriterionName>
        <CriterionValue>1</CriterionValue>
    </SearchCriterion>

<SearchCriterion>
        <CriterionName>Experience</CriterionName>
        <CriterionValue>1-2</CriterionValue>
    </SearchCriterion>

<SearchCriterion>
        <CriterionName>Experience</CriterionName>
        <CriterionValue>2-5</CriterionValue>
    </SearchCriterion>

<SearchCriterion>
        <CriterionName>MinSalary</CriterionName>
        <CriterionValue>25000</CriterionValue>
    </SearchCriterion>

<SearchCriterion>
        <CriterionName>MaxSalary</CriterionName>
        <CriterionValue>50000</CriterionValue>
    </SearchCriterion>

<SearchCriterion>
        <CriterionName>SalaryUnspecified</CriterionName>
        <CriterionValue>1</CriterionValue>
    </SearchCriterion>

<SearchCriterion>
        <CriterionName>MostRecentJobTitle</CriterionName>
        <CriterionValue>Software Engineer</CriterionValue>
    </SearchCriterion>

<SearchCriterion>
        <CriterionName>Education</CriterionName>
        <CriterionValue>PhD</CriterionValue>
    </SearchCriterion>

<SearchCriterion>
        <CriterionName>Education</CriterionName>
        <CriterionValue>M</CriterionValue>
    </SearchCriterion>

<SearchCriterion>
        <CriterionName>School</CriterionName>
        <CriterionValue>MIT, Boston</CriterionValue>
    </SearchCriterion>

<SearchCriterion>
        <CriterionName>Language</CriterionName>
        <CriterionValue> 
            <Language Proficiency="Fluent">us</Language>
        </CriterionValue>
    </SearchCriterion>
    
    <SearchCriterion>
        <CriterionName>Language</CriterionName>
        <CriterionValue> 
            <Language>UK</Language>
        </CriterionValue>
    </SearchCriterion>

<SearchCriterion>
        <CriterionName>PositionType</CriterionName>
        <CriterionValue>PERM</CriterionValue>
    </SearchCriterion>

<SearchCriterion>
        <CriterionName>PositionType</CriterionName>
        <CriterionValue>CONT</CriterionValue>
    </SearchCriterion>

<SearchCriterion>
        <CriterionName>Commitment</CriterionName>
        <CriterionValue>FT</CriterionValue>
    </SearchCriterion>

</SearchCriteria>

Success Response XML

In above sample response ‘1234’ is the search ID (without quotes) to be used in Modify Search API and Search Results API described later.

ResumeCount specifies the maximum number of results that are available for the specific query.

Resumé Search

URI

HTTP Method

HTTP Request Body

HTTP Custom Headers

Request XML for Resumé Search

Valid values for NAME field

Value Parameters

Request XML Sample for Resumé Search

Success Response XML

Error Response XML

Table of Contents