Job Post

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 Job Post

Prev — Authentication

Job Edit — Next

The Job Post API call allows you to post job ads on HotJobs in real time. You must supply a valid session token when posting a new job ad. The job ad can be posted as public or private. Jobs posted as public consume credit and are searchable by Job Seekers. Jobs posted as private do not consume credit and are not available to Job Seekers. The Hot Jobs Job Id and other job related details (see response xml below) are returned after a successful job post. The Hot Jobs Job Id is a unique auto-generated ID assigned by HotJobs. The Hot Jobs Job Id, user-specified Job ID, or IO/PO Number can be used for calling the Job Edit, Job Delete and Job Refresh API calls sequentially.

You can specify the process you want candidates to use when applying for the job in the ApplyType parameter. The default process is to apply through Yahoo! HotJobs i.e., HotJobs Apply. In this model, you let Yahoo! HotJobs capture candidate data, and view resumes online any time you want via Yahoo! HotJobs Recruitment Center. You can also specify email addresses where you want Yahoo! HotJobs to forward resumes. The other option is use to Direct Apply credit and request job seekers to contact your company directly. If you use the Direct Apply process, HotJobs cannot track job candidates or provide a complete picture as to how your job ad is performing.

URI

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

HTTP Method

POST

HTTP Request Body

Job Post XML Request

HTTP Custom Headers

X-Yahoo-HJAuth-Token
This is the session token returned by the Authentication API call
X-Yahoo-HJAuth-Timestamp
This must be the request timestamp in Unix Timestamp format: the difference, measured in milliseconds, between the current time and midnight, January 1, 1970 UTC.
X-Yahoo-HJAuth-Signature
The signature is a MD5 hash of the XML request, request timestamp, job id (empty for a new job), token and license key, in that order, encoded in hexadecimal format.

Parameters

Table 2. Job Information

Name	Type	Required?	Description
ListingType	String	Y	Asset to be consumed in job post. The specified asset must be allocated to the user posting the job. Otherwise, job post fails. This field is mandatory if this Public field is "True". Accepted Values: `SLOT, POST, PAYG`
Public	String	Y	The Job Status. Used to determine the Job listing visibility on the HotJobs site. Accepted Values: True—Sets Job status to "Posted" and lists job on the HotJobs site; False—Job status is set to ‘Not Posted’ and job not listed on HotJobs site. Job Status can be changed using the Edit Job API call.
PostDuration	Number	N	The length of time Job is listed on the HotJobs site. Applicable if ListingType is set to POST/ PAYG. Ignored if ListingType is set to SLOT or not present/ private job. Accepted Values: Number more than 0.
BoldJobDuration	Number	N	Bold Listing Asset must be allocated to the user posting the job. Otherwise this field will be ignored Accepted Values: 7, 14, 21, 28, 35, 42, 49, 56, 63
CompanyConfidential	String	N	Company Confidential Asset must be allocated to the user posting the job. Otherwise this field will be ignored. Accepted Values: Yes – CompanyConfidential Asset will be consumed and Employer name will be hidden in Job Ad No - CompanyConfidential Asset will not be consumed and Employer name will be visible in Job Ad
Title	String	Y	Job Title. Max Length: 100 characters
Id	String	N	User-defined Job ID / Job Label. This field may be used as unique job identifier. Max Length: 20 characters
IONumber	String	N	IO/PO Number. Used for Internal Billing purpose. This field may be used as unique job identifier. Max Length: 30
Industry	String	Y	3-letter Industry code. Refer to Job Category Values list for accepted values: `http://www.hotjobs.com/import/values-23.html`. One category is mandatory. Another category may be provided by repeating this field in the request XML, as in done is done in the following example: `<yjob:Industry>ADV</yjob:Industry> <yjob:Industry>CON</yjob:Industry>`
Function	String	Y	9-letter Function code. Refer to Job Function Values list for accepted values: `http://www.hotjobs.com/import/values-23.html`
Experience	String	N	Number of years of experience required for the job. Accepted Values: 0-1 1-2 2-5 5-10 10-15 15+ Unspecified If this element is blank or missing in the XML Request, "Unspecified" will be selected automatically.
Experience Level	String	N	Accepted Values: INT Internship ENT Entry Level MID Middle Level SEN Senior Level MGT Management DIR Director EXE Executive Level XML Sample for Experience & Experience Level: `<yjob:Experience level="MID">5-10</yjob:Experience>`
Degree	String	N	Accepted Values: HS High School A Associates BS Bachelor of Science BA Bachelor of Arts BBA Bachelor of Business Administration JD Juris Doctorate MS Master of Science MA Master of Arts MD Medical Doctor MBA Master of Business Administration MFA Master of Fine Arts B Bachelors Degree M Masters Degree PHD PhD OTH Other
Degree Pref	String	N	Accepted Values: NULL Not Specified 0 Required 1 Preferred 2 Lower XML Sample for Degree & Degree Pref: `<yjob:Degree pref="0">PHD</yjob:Degree>` If this element is blank or missing in the XML Request, "1" (Preferred) will be selected automatically.
Duration	String	N	Expected time commitment for the job. Accepted Values: FT Full-Time PT Part-Time If this element is blank or missing in the XML Request, "FT" (Full Time) will be selected automatically.
HireType	String	N	Position Type. Accepted Values: PERM Employee CONT Contract CONTHIRE Contract-to-Hire TEMP Temp TEMPHIRE Temp-to-Employee If this element is blank or missing in the XML Request, "PERM" (Employee) will be selected automatically.
SalaryType	String	N	Accepted Values: Salaried Annual Salary Hourly Hourly Wage SalaryBonus Annual Salary and Bonus/Commission If this element is blank or missing in the XML Request, "Salaried" will be selected automatically.
SalaryFrom	Number	N	Max Length: 10. Example: 50000 or 5.25.
SalaryTo	Number	N	Max Length: 10. Example: 100000 or 10.50
DisplaySalary	String	N	Accepted Values: True Salary will be displayed in the Job Ad False Salary will not be in the Job Ad If this element is blank or missing in the XML Request, "False" will be selected automatically.
AdditionalComp	String	N	Applicable if `SalaryType` is `SalaryBonus`. Max Length: 50
TravelAmount	Number	N	Accepted Values: 0 Negligible 25 Up to 25% 50 Up to 50% 100 Up to 100% If this element is blank or missing in the XML Request, "0" will be selected automatically

Table 3. Job Location – Upto six locations may be provided for a Job Slot

Name	Type	Required?	Description
Municipality	String	Y	City in which Job is located. Max Length: 70
Region	String	Y	2-letter State Code (if Country is US)- `Refer http://www.hotjobs.com/import/codes-22.html` 2-letter Province Code (if Country is Canada): AB Alberta BC British Columbia MB Manitoba NB New Brunswick NL Newfoundland NS Nova Scotia NT Northwest Territories NU Nunavut ON Ontario PE Prince Edward Island QC Quebec SK Saskatchewan YT Yukon Text for other countries (Max Length: 30)
CountryCode	String	Y	3-letter Country Code: `http://www.hotjobs.com/import/codes-22.html`
PostalCode	String	N	Zipcode. Max Length: 10

Table 4. Job Description

Name	Type	Required?	Description
Summary	String	N	Short Description. Max Length: 100
Content	Text (including HTML)	Y	Long Description. Max Length: 60000 chars Security Tip: Avoid email addresses in content as a anti-phishing measure.

Table 5. Employer Information

Name	Type	Required?	Description
EmployerProfileId	String	N	Employer company profile to be displayed to job seekers. Accepted Values: Company Profile Id - This can be found on the Accounts Tab > Company Profile > Name. If this element is blank or missing in the XML Request, "Default Company Profile" will be selected automatically.
EmployerName	String	N	Recruiting company’s name. Applicable if the account used for posting job is RAA or Staffing or Partner type account. Max Length:200
(PartnerContact) Given Name	String	N	Recruiting company’s contact details. Applicable if the account used for posting job is RAA or Partner type account. Max Length: 50
(PartnerContact) Family Name	String	N	Recruiting company’s contact details. Applicable if the account used for posting job is RAA or Partner type account. Max Length: 50
(PartnerContact) Phone	String	N	Recruiting company’s contact details. Applicable if the account used for posting job is RAA or Partner type account. Max Length: 10. Example: 1234567890 or 123-456-7890
(PartnerContact) Email	String	N	Recruiting company’s contact details. Applicable if the account used for posting job is RAA or Partner type account. Max Length: 30.

Table 6. Apply Process - HotJobs Apply Vs Direct Apply

Name	Type	Required?	Description
ApplyType	String	Y	Accepted Values: H HotJobs Apply O Direct Apply

Table 7. HotJobs Response Settings - these parameters are applicable if HotJobs Apply is selected

Name	Type	Required?	Description
Email	String	N	Applicable for HotJobs Apply only. Interested Job seekers resumes will be forwarded to this email id. Max Length: 30 Up to three Forwarding Email Ids may be specified as shown in this sample: `<yjob:ResponseSettings> <yjob:Email>recruiter1@company.com</yjob:Email> <yjob:Email>recruiter2@company.com</yjob:Email> <yjob:Email>recruiter3@company.com</yjob:Email> </yjob:ResponseSettings>` Leave this field blank if you don’t want to receive resumes via email.
AttachResume	String	N	Applicable if Forwarding Email Id is provided. Accepted Values: Yes Candidate resume will be included as an attachment in the email No Candidate resume will be included as inline text in the email If this element is blank or missing in the XML Request, "Yes" will be selected automatically.
Format	String	N	Email format. Applicable if Forwarding Email Id is provided. Accepted Values: Html Color and Graphics Text Plain Text If this element is blank or missing in the XML Request, "HTML" will be selected automatically.
HiringTest	String	N	Accepted Values: Questionnaire ID may be obtained from Tools Tab > Questionnaire Templates > Name 0 for Demographic Data Questions (applicable for OFCCP accounts only).
FilterResume	String	N	Applicable only if HiringTest is selected & Forwarding Email ID is provided. Accepted Values: No all resumes will be forwarded Yes only resumes of candidates who get the passing score will be forwarded If this element is blank or missing in the XML Request, "No" will be selected automatically.
EmploymentAuthorization	String	N	Applicable if forwarding email id is provided. Accepted Values: No all resumes will be forwarded Yes only resumes of candidates who are legally authorized to work in the country listed for this job will be forwarded If this element is blank or missing in the XML Request, "No" will be selected automatically.

Table 8. Direct Apply Settings - Contact Information OR Walk-in Location is required

Name	Type	Required?	Description
ApplyFax	String	N	Contact Info. Max Length: 10
ApplyEmail	String	N	Contact Info. Max Length: 30
ApplyURL	String	N	Contact Info. Re-direct URL to Company's website. Max Length: 50
LastName	String	N	Contact Info. Max Length: 100
FirstName	String	N	Contact Info. Max Length: 100
Phone	String	N	Contact Info. Max Length: 10
(ApplyAddress) AddressLine	String	Y	Walk-in Location. Max Length: 100
(ApplyAddress) Municipality	String	Y	Walk-in Location. Max Length: 70
(ApplyAddress) Region	String	Y	2-letter State Code (if Country is US)- `Refer http://www.hotjobs.com/import/codes-22.html` 2-letter Province Code (if Country is Canada): AB Alberta BC British Columbia MB Manitoba NB New Brunswick NL Newfoundland NS Nova Scotia NT Northwest Territories NU Nunavut ON Ontario PE Prince Edward Island QC Quebec SK Saskatchewan YT Yukon Text for other countries (Max Length: 30)
(ApplyAddress) CountryCode	String	Y	Walk-in Location. 3-letter Country Code. http://www.hotjobs.com/import/codes-22.html
(ApplyAddress) PostalCode	String	N	Walk-in Location. Max Length: 10

Request XML Sample for Direct Apply Job

The following is an example of a Direct Apply Job Post request for this API:

<?xml version="1.0" encoding="UTF-8"?>
<atom:feed xmlns:yheader="http://schemas.yahoo.com/ypost/jobsHeader/3.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:yjob="http://schemas.yahoo.com/ypost/jobs/3.0" xmlns:ycontrol="http://schemas.yahoo.com/ypost/control/1.0">
    
    <yjob:ListingType>SLOT</yjob:ListingType>
    <!—Employer company profile to be displayed to job seekers.  This can be found on the Accounts Tab under   
    Company Profile. Default company profile id is used if this is empty or missing. -->
    <yjob:EmployerProfileId>PROFILE_ID</yjob:EmployerProfileId>
    
    <atom:entry>
        <ycontrol:Operation>POST</ycontrol:Operation>
        <yjob:Public>true</yjob:Public>
        <yjob:PostDuration>30</yjob:PostDuration>
        <yjob:BoldJobDuration>7</yjob:BoldJobDuration>
        <yjob:CompanyConfidential>No</yjob:CompanyConfidential>

<atom:id>SWEngineer-SlotNew</atom:id>
        <yjob:IoNumber>IONUM-00001</yjob:IoNumber>
        <atom:title>Change-EDU/EXP</atom:title>
        
        <!— Hiring Company Name. Applicable to RAA, Staffing and partner type accounts -->        
        <yjob:EmployerName>HJTest</yjob:EmployerName>
       
        <!— Recruiting company’s contact details. Applicable to RAA and partner type accounts-->
        <yjob:PartnerContact>
            <yjob:Name Type="Family">Yahoo</yjob:Name>
            <yjob:Name Type="Given">HJ</yjob:Name>
            <yjob:Phone Type="business">5109360000</yjob:Phone>
            <yjob:Email Type="business">sswami@yahoo-inc.com</yjob:Email>
        </yjob:PartnerContact>
        
<!— To post job in multiple locations, repeat the yjob:location element as shown below. Maximum 6 locations can be provided for a slot job. Following logic will be applied for asset consumption in case of multiple locations: 
Job Posted with 1 or 2 locations – one Job Slot will be consumed
Job Posted with 3 or 4 locations – two Job Slots will be consumed
Job Posted with 5 or 6 locations – three Job Slots will be consumed
-->     
        <yjob:Location>
            <yjob:Municipality>New York</yjob:Municipality>
            <yjob:Region>NY</yjob:Region>
            <yjob:PostalCode>10001</yjob:PostalCode>
            <yjob:CountryCode>USA</yjob:CountryCode>
        </yjob:Location>

<yjob:Location>
            <yjob:Municipality>Sunnyvale</yjob:Municipality>
            <yjob:Region>CA</yjob:Region>
            <yjob:PostalCode>94089</yjob:PostalCode>
            <yjob:CountryCode>USA</yjob:CountryCode>
        </yjob:Location>

<yjob:Industry>MIS</yjob:Industry>
        <yjob:Function>MIS-SOFTW</yjob:Function>
        <yjob:HireType>CONT</yjob:HireType>
        <yjob:Duration>PT</yjob:Duration>
        <yjob:Experience level="MID">5-10</yjob:Experience>
        <yjob:Degree pref="0">PHD</yjob:Degree>
        
        <yjob:SalaryType>Salaried</yjob:SalaryType>
        <yjob:SalaryFrom Currency="USD">100000</yjob:SalaryFrom>
        <yjob:SalaryTo Currency="USD">120000</yjob:SalaryTo>
        <yjob:AdditionalComp>Negotiable</yjob:AdditionalComp>
        <yjob:DisplaySalary>true</yjob:DisplaySalary>
        <yjob:TravelAmount>0</yjob:TravelAmount>
        
        <yjob:EmploymentAuthorization>Yes</yjob:EmploymentAuthorization>
        <yjob:HiringTest></yjob:HiringTest>
                
        <yjob:ApplyType>O</yjob:ApplyType>
        
        <yjob:ApplySettings>
            <yjob:ApplyContact>
                <yjob:Name type=”First”>First Name</yjob:Name>
                <yjob:Name type=”Last”>Last Name</yjob:Name>
                <yjob:Phone type=”business”>111-111-1111</yjob:Phone>
            </yjob:ApplyContact>
            <yjob:ApplyFax>Apply FAX</yjob:ApplyFax>
            <yjob:ApplyURL>http://abc.com</yjob:ApplyURL>
            <yjob:ApplyEmail>bhaskarr@yahoo-inc.com</yjob:ApplyEmail>
            <yjob:ApplyAddress>
                <yjob:AddressLine>123 333rd Street</yjob:AddressLine>
                <yjob:AddressLine>5th floor</yjob:AddressLine
                <yjob:Municipality>Oakland</yjob:Municipality>
                <yjob:Region>CA</yjob:Region>
                <yjob:PostalCode>94089</yjob:PostalCode>
                <yjob:CountryCode>USA</yjob:CountryCode>
            </yjob:ApplyAddress>
        </yjob:ApplySettings>       
 
        <atom:summary type="text"> SHORT DESCRIPTION</atom:summary>
        <atom:content type="html">LONG DESCRIPTION</atom:content>
    </atom:entry>
</atom:feed>

Request XML Sample for HotJobs Apply Job

The following is an example of a HotJobs Apply Job Post request for this API:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<atom:feed xmlns:yheader="http://schemas.yahoo.com/ypost/jobsHeader/3.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:yjob="http://schemas.yahoo.com/ypost/jobs/3.0" xmlns:ycontrol="http://schemas.yahoo.com/ypost/control/1.0">

<yjob:ListingType>SLOT</yjob:ListingType>

<yjob:EmployerProfileId>Target</yjob:EmployerProfileId>

<atom:entry>
        <ycontrol:Operation>POST</ycontrol:Operation>
        <yjob:Public>true</yjob:Public>
        <yjob:PostDuration>30</yjob:PostDuration>
        <yjob:BoldJobDuration>7</yjob:BoldJobDuration>
        <yjob:CompanyConfidential>No</yjob:CompanyConfidential>

<atom:id>SWEngineer-SlotNew</atom:id>
        <yjob:IoNumber>IONUM-00001</yjob:IoNumber>
        <atom:title>Change-EDU/EXP</atom:title>
        
        <yjob:EmployerName>HJTest</yjob:EmployerName>

<yjob:PartnerContact>
            <yjob:Name Type="Family">Yahoo</yjob:Name>
            <yjob:Name Type="Given">HJ</yjob:Name>
            <yjob:Phone Type="business">5109360000</yjob:Phone>
            <yjob:Email Type="business">sswami@yahoo-inc.com</yjob:Email>
        </yjob:PartnerContact>
             
        <yjob:Location>
            <yjob:Municipality>New York</yjob:Municipality>
            <yjob:Region>NY</yjob:Region>
            <yjob:PostalCode>10001</yjob:PostalCode>
            <yjob:CountryCode>USA</yjob:CountryCode>
        </yjob:Location>
        
        <yjob:Industry>MIS</yjob:Industry>
        <yjob:Function>MIS-SOFTW</yjob:Function>
        <yjob:HireType>CONT</yjob:HireType>
        <yjob:Duration>PT</yjob:Duration>
        <yjob:Experience level="MID">5-10</yjob:Experience>
        <yjob:Degree pref="0">PHD</yjob:Degree>
        
        <yjob:SalaryType>Salaried</yjob:SalaryType>
        <yjob:SalaryFrom Currency="USD">100000</yjob:SalaryFrom>
        <yjob:SalaryTo Currency="USD">120000</yjob:SalaryTo>
        <yjob:AdditionalComp>Negotiable</yjob:AdditionalComp>
        <yjob:DisplaySalary>true</yjob:DisplaySalary>
        <yjob:TravelAmount>0</yjob:TravelAmount>
        
        <yjob:EmploymentAuthorization>Yes</yjob:EmploymentAuthorization>
        <yjob:HiringTest></yjob:HiringTest>
        
        <yjob:ApplyType>H</yjob:ApplyType>
        <yjob:ResponseSettings>
            <yjob:AttachResume>Yes</yjob:AttachResume>
            <yjob:Email>recruiter1@company.com</yjob:Email>
            <yjob:Email> recruiter2@company.com</yjob:Email>
            <yjob:Email> recruiter3@company.com</yjob:Email>
            <yjob:Format>text</yjob:Format>
        </yjob:ResponseSettings>

<yjob:FilterResume>No</yjob:FilterResume>
        <atom:summary type="text"> SHORT DESCRIPTION</atom:summary>
        <atom:content type="html">LONG DESCRIPTION</atom:content>

</atom:entry>
</atom:feed>

Success Response XML Sample for Direct Apply Job

The following is an example of a successful response to a Direct Apply Job Post API call:

Success Response XML Sample for HotJobs Apply Job