This API is now deprecated. Please use our new Job Posting API.
Posting jobs to reed.co.uk
The following information is intended to assist you in uploading jobs in an automated way to reed.co.uk.
The instructions require a high degree of technical knowledge. If you have any queries regarding the information provided, please contact us.
Setting up a reed.co.uk account
To integrate reed.co.uk HTTP posting you will require an existing reed.co.uk recruiter account. This account can be created at http://www.reed.co.uk/recruiter. Should you require assistance with your account creation please contact recruiter support.
Connections and Security
To integrate with reed.co.uk you should ensure that the system from which jobs will be posted, typically a server on workstation in the recruiter‟s office or datacentre, has access to reed.co.uk.
The client system should have access to ports 80 & 443 to www.reed.co.uk.
Below is a list of parameters that are accepted by reed.co.uk's HTTP Posting API.
Field name
Restriction on values?
Mandatory?
Example
Comments
txtService
Y
DEMO
A string to identify the job supplier. Please use the value of DEMO for testing purposes. This will prevent the job advert from posting on the site but will return the value SUCCESS if the process has been actioned correctly. When you wish to go live please contact us for a value for this field
The email address that online job applications will be sent to
txtRef
max length 64 chars
Y
3BX89
A job reference - should be unique to allow for future services such as job removal
txtExpiry
a whole number between 1 and 42
Y
42
The number of days that the job will remain on the reed.co.uk site. After this time the job will be automatically archived and will no longer appear on the site. Jobs can be renewed from the 'Jobs & Applications' page within the recruiter's account, and renewal notices will be sent to the job's email address 24 hours before expiry.
cboType
One of the ids from
Y
2
Indicates whether the position is permanent, temporary or contract. Please view the HTML source of this page to see the permissible value for cboType
cboWorkingHours
One of the ids from
Y
2
Indicates whether the position is full or part time. Please view the HTML source of this page to see the permissible value for cboWorkingHours
txtDuration
max length 64 chars
N
3 months
The expected duration of the job i.e. for contract or temp jobs
txtJobTitle
max length 64 chars
Y
Admin Assistant
The job title - only alpha-numeric characters will be permitted i.e. %, £, $ will not be allowed.
cboSector
One of the ids from
Y
52
Please view the HTML source of this page to see the permissible value for cboSector. If you have jobs that
do not match any of the job sectors in the list then please add the jobs with a value of 21 (i.e, Other) for
cboSector. These jobs will still be retrievable on the website by candidates using keyword searches.
optForGrad
"YES" or "NO"
N
YES
If a job has this field set to "YES" then the job will also appear on the recent graduates jobsite at www.reed.co.uk/graduates. This option is used to indicate that the job is a graduate trainee role and is usually aimed at candidates who have graduated within the last three years.
optPublicSector
"YES" or "NO"
N
YES
If a job has this field set to "YES" then the job will appear on the public sector jobsite at www.reed.co.uk/public and show in all searches which use the 'public sector' field. This option is used to indicate that the job is in the public sector.
txtTown
max length 255 chars
Y
Greenwich
The town or city for the vacancy. The DB uses an intelligent Town lookup table. Any entry in this field will take priority over the county settings where a recognised town is located.
cboCounty
One of the ids from
Y
154
The county, region or country location of the vacancy. Please view the HTML source of this page to see the permissible values for this field
txtSalMin
A number with optional pence
Y
12000
The minimum salary for the position. This can be the same as txtSalMax. If the salary is unknown please supply the value 0 (in both fields) and it will appear on the site as "not specified"
txtSalMax
A number with optional pence
Y
14000
The maximum salary for the position. This can be the same as txtSalMin. If the salary is unknown please supply the value 0 (in both fields) and it will appear on the site as "not specified"
cboCurrency
One of the ids from
N
1
The currency of the salary. Please view the HTML source of this page to see the permissible values for this field. If no value is supplied then the currency will default to GBP (United Kingdom Pounds)
cboSalaryType
One of the ids from
Y
5
The type or frequency of salary e.g. per hour, per annum. Please view the HTML source of this page to see the permissible value for this field
chkSalOTE
"YES" or ""
N
YES
If a job has this field set to "YES" then the job's salary will appear with "OTE" added. This field can be set along with chkSalIncBenefits, chkSalProRata and chkSalNegotiableShow.
chkSalIncBenefits
"YES" or ""
N
YES
If a job has this field set to "YES" then the job's salary will appear with "Inc Benefits" added. This field can be set along with chkSalOTE, chkSalProRata and chkSalNegotiableShow.
chkSalProRata
"YES" or ""
N
YES
If a job has this field set to "YES" then the job's salary will appear with "Pro-Rata" added. This field can be set along with chkSalOTE, chkSalIncBenefits and chkSalNegotiableShow.
chkSalNegotiableShow
"YES" or ""
N
YES
If a job has this field set to "YES" then the job's salary will appear with "Negotiable" added. This field can be set along with chkSalOTE, chkSalIncBenefits and chkSalProRata.
chkSalNegotiableHide
"YES" or ""
N
YES
If a job has this field set to "YES" then the job's salary will appear as "Negotiable". The actual salary will be hidden from display, although job searches in the correct salary range will still return the vacancy. NB: If this field is set then chkSalOTE, chkSalIncBenefits, chkSalProRata and chkSalNegotiableShow will be ignored.
chkHdnSalaryDescription
None or one of the ids from:
N
1
If a job has this field set to "0", "1" or "2" then the job's salary will appear as either "Negotiable", "Commission Only" or "Competitive". The actual salary will be hidden from display, although job searches in the correct salary range will still return the vacancy. NB: If this field is set then chkSalOTE, chkSalIncBenefits, chkSalProRata, chkSalNegotiableHide and chkSalNegotiableShow will be ignored.
memDescription
More than 150 chars Less than 6000 chars
Y
This high impact role requires solid knowledge of Java, ASP, C++, experience useful but not required...
The free text description of the job. New lines (including paragraphs) in the description will be displayed accordingly on the website. Please do not include HTML tags as they will be ignored and treated as text - so they will be visible to candidates on the websites. We also restrict use of contact details in this field e.g. email addresses, URLs, phone numbers.
chkAllowIneligibleApps
"YES" or ""
N
YES
If a job has this field set to "YES" then applications will be allowed from jobseekers who are ineligible to work in the UK. If no value is supplied then ineligible jobseekers will not be allowed to apply.
cboListingType
One of the ids from:
N
1
If no value is supplied, we will attempt to add to add a Premium job (2). If no Premium Job credits are available an attempt will be used to add a Standard job (1), if no credits avaialable for this an error will be returned.
txtExternalApplicationURL
Must be a valid link.
N
http://www.reed.co.uk
Link must be either HTTP or HTTPS. The account must be set up to do this by reed.co.uk, as this is a paid for service. If not set up on account, the applications will be sent to the email specified in the txtEmail field.
cboCoverLetterPreference
One of the ids from
N
1
If no value is supplied, the cover letter preference will default to 3 (Not required). This means the job doesn’t require job applicants to add cover letter. If a job has this field set to “1”, the job allows applicants to add cover letter but it is not compulsory. If a job has this field set to “2”, job applicants have to add cover letter to complete sending their application.
You can have up to 5 screening questions using the following format; Q1 can be replaced with the relevant no. - e.g. Q3 also acceptable
txtJobQ1
max length 100 chars
N
Do you have a full clean driving license?
A screening question seeking an affirmative response. This field requires a yes/no answer that candidates will be required to answer before applying for this job.
optJobQ1ExpectedAnswer
"YES" or ""
N
YES
Expected answer for screening question
chkJobQ1AutoReject
"YES" or ""
N
YES
Is this question a killer/auto reject question? Candidates failing to provide the specified Expected Answer will be automatically rejected.
You can have up to 10 skills using the following format; Skill1 can be replaced with the relevant no. - e.g. Skill3
txtSkill1
max length 150 chars
N
Project management OR Key Stage 2 OR Telesales
Adding skills to your job helps candidates decide whether to apply. It also allows you to sort applicants by Best Match if you use our applicant management system.
Testing
The reed.co.uk HTTP POST API provides the facility to test your integration before posting data to the live site. Testing requires an active recruiter account, 'Setting up a reed.co.uk account' section of this document. Once you have the username and password for a reed.co.uk account, you can proceed with testing.
To send test POST data to reed.co.uk you should ensure that the txtService field is set to 'DEMO'. This test also requires your live user account and password data.
If everything is setup correctly, you will receive a response containing the word 'SUCCESS'. Once you have received a txtService ID, and you post live jobs, you will be returned a unique job ID, which can be used to remove the job from reed.co.uk (see below).
Removing jobs from reed.co.uk
Jobs can be removed from reed.co.uk using the job ID provided in response to a successful job posting. The page to send HTTP POST requests to is:
https://www.reed.co.uk/recruiter/HttpManagement.aspx
As with job posting, all fields must be URL encoded. Below is an example of the code required to delete one / multiple jobs:
<FORM METHOD="post" ACTION="https://www.reed.co.uk/recruiter/HttpManagement.aspx">
<INPUT TYPE="hidden" name="txtService" value="{txt service name for http supplier}">
<INPUT TYPE="hidden" name="txtUserName" value="{Account username}">
<INPUT TYPE="hidden" name="txtPassword" value="{Account password}">
<INPUT TYPE="hidden" name="txtAction" value="1">
<INPUT TYPE="hidden" name="txtJobIds" value="{job id(s) you wish to delete}">
<input type="submit" />
</FORM>
Arranging a txtService ID
Once you have tested the service using the 'txtService' ID DEMO and no errors have been returned, your account will be ready to enable.
Just contact reed.co.uk, give us your organization's name and your contact details (contact name, email and phone number). If you are providing a service for your own clients, we still need your contact details for technical updates and news.
Once we have confirmation of your details we will enable your account and then provide you with a unique 'txtService' ID.
Relisting jobs
The day before jobs are due to expire, an email is sent to the email address provided on the job (added for application responses). The jobs can be relisted online through job management tools within your reed.co.uk recruiter account.
The easiest way to relist jobs remotely is to re-send (as an exact duplicate) them from your own database. However, to ensure quality standards are maintained, jobs can only be relisted within 4 days of their expiry date. These requests will be ignored until the conditional period has been completed.
For example, if an existing job with an expiry date in 3 days time were reposted, the job's expiry date would be extended by the value specified in the txtExpiry field - i.e. 3 days + the txtExpiry value. A further attempt to repost the vacancy would result in a duplicate job error - the job will not be relisted.
A job credit will be used whenever a job is added or successfully reposted.