Welcome, guest Sign In

Job Post

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
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:

Request XML Sample for HotJobs Apply Job

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

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

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

Error Response XML Sample

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

Table of Contents

Copyright © 2009 Yahoo! Inc. All rights reserved. Copyright | Privacy Policy

Help us continue to improve the Yahoo! Developer Network: Send Your Suggestions