HTTP Upload Reference
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.

Testing Access

With a browser:

Use a web browser on the connecting system to view: https://www.reed.co.uk/recruiter/upload.aspx

With Telnet:

Use a telnet client from the connecting system and invoke the following commands:

telnet 217.64.230.225 80
GET / HTTP/1.1

This should return text akin to:

HTTP/1.1 400 Bad Request
Content-Type: text/html; charset=us-ascii
Server: Microsoft-HTTPAPI/2.0
Date: Fri, 05 Jun 2012 12:15:41 GMT
Connection: close

As long as you have been able to reproduce either of these outcomes, your calling system can access the reed.co.uk HTTP post API.

Location

The page to send HTTP POST requests to is: https://www.reed.co.uk/recruiter/upload.aspx

URL Encoding

All fields must be URL encoded, for example:

  • 'demo@reed.co.uk' will be sent as 'demo%40reed%2Eco%2Euk'
  • '£40000' will be sent as '%A340000'
Further details can be found at: http://www.w3schools.com/tags/ref_urlencode.asp

HTTP Posting Parameters

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
txtUserName Y yourusername User name of the recruiter as used to login at http://www.reed.co.uk/recruiter/
txtPassword Y yourpassword Password of the recruiter as used to login at http://www.reed.co.uk/recruiter/
txtEmail must be a valid address Y a.n.other@reed.co.uk 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.

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 5 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.