Skip to main content
POST
/
api
/
reed
/
jobs
/
search
/reed/jobs/search
curl --request POST \
  --url https://api.anysite.io/api/reed/jobs/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "keywords": "<string>",
  "count": 2,
  "timeout": 300,
  "location": "<string>",
  "distance": 25,
  "salary_from": 1,
  "salary_to": 1,
  "remote_only": false,
  "date_posted": "anytime",
  "graduate": false,
  "visa_sponsorship": false,
  "easy_apply": false,
  "early_bird": false,
  "hide_training_jobs": false
}
'
[
  {
    "id": 123,
    "@type": "@reed_search_job",
    "url": "<string>",
    "title": "<string>",
    "description": "<string>",
    "created_at": "<string>",
    "updated_at": "<string>",
    "display_date": "<string>",
    "expiry_date": "<string>",
    "location_name": "<string>",
    "county": "<string>",
    "remote_option": "<string>",
    "job_type": 123,
    "salary_from": 123,
    "salary_to": 123,
    "salary_type": "<string>",
    "currency_id": 123,
    "payment_model": "<string>",
    "taxonomy_level_1": "<string>",
    "taxonomy_level_2": "<string>",
    "is_full_time": true,
    "is_part_time": true,
    "is_easy_apply": true,
    "is_promoted": true,
    "is_featured": true,
    "is_training_job": true,
    "is_early_bird": true,
    "is_priority": true,
    "is_top_job": true,
    "is_survey_job": true,
    "is_ats_direct_apply": true,
    "eligible_uk_only": true,
    "external_url": "<string>",
    "ou_id": 123,
    "ou_name": "<string>",
    "ou_type": 123,
    "ou_tier_id": 123,
    "ou_url": "<string>",
    "profile_id": 123,
    "profile_name": "<string>",
    "alias": "<string>",
    "image": "<string>"
  }
]

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
keywords
string
required

Search keywords (job title, skill or company).

Minimum string length: 1
count
integer
required

Max number of results to return

Required range: x >= 1
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
location
string | null

Town, city or postcode to search near.

distance
integer | null

Search radius in miles around the location.

Required range: 0 <= x <= 50
salary_from
integer | null

Minimum annual salary (GBP).

Required range: x >= 0
salary_to
integer | null

Maximum annual salary (GBP).

Required range: x >= 0
job_type
enum<string> | null

Restrict to a job type.

Available options:
permanent,
contract,
temp,
part_time,
full_time
posted_by
enum<string> | null

Restrict to jobs posted by agencies or employers.

Available options:
agency,
employer,
reed
sector
enum<string> | null

Restrict to a job sector / industry.

Available options:
accountancy,
accountancy_qualified,
admin_secretarial_pa,
apprenticeships,
banking,
charity_voluntary,
construction_property,
customer_service,
education,
energy,
engineering,
estate_agency,
financial_services,
fmcg,
general_insurance,
graduate_training_internships,
health_medicine,
hospitality_catering,
human_resources,
it_telecoms,
legal,
leisure_tourism,
manufacturing,
marketing_pr,
media_digital_creative,
motoring_automotive,
other,
purchasing,
recruitment_consultancy,
retail,
sales,
scientific,
security_safety,
social_care,
strategy_consultancy,
training,
transport_logistics
remote_only
boolean
default:false

Only remote / work-from-home jobs.

date_posted
enum<string>
default:anytime

How recently the job was posted.

Available options:
anytime,
today,
lastthreedays,
lastweek,
lasttwoweeks
graduate
boolean
default:false

Only graduate-level jobs.

visa_sponsorship
boolean
default:false

Only jobs offering visa sponsorship.

easy_apply
boolean
default:false

Only easy-apply jobs.

early_bird
boolean
default:false

Only early-bird jobs (posted in the last 24 hours).

hide_training_jobs
boolean
default:false

Exclude training-course listings.

Response

Successful Response

id
integer
required
@type
string
default:@reed_search_job
url
string | null
title
string | null
description
string | null
created_at
string | null
updated_at
string | null
display_date
string | null
expiry_date
string | null
location_name
string | null
county
string | null
remote_option
string | null
job_type
integer | null
salary_from
number | null
salary_to
number | null
salary_type
string | null
currency_id
integer | null
payment_model
string | null
taxonomy_level_1
string | null
taxonomy_level_2
string | null
is_full_time
boolean | null
is_part_time
boolean | null
is_easy_apply
boolean | null
is_promoted
boolean | null
is_training_job
boolean | null
is_early_bird
boolean | null
is_priority
boolean | null
is_top_job
boolean | null
is_survey_job
boolean | null
is_ats_direct_apply
boolean | null
eligible_uk_only
boolean | null
external_url
string | null
ou_id
integer | null
ou_name
string | null
ou_type
integer | null
ou_tier_id
integer | null
ou_url
string | null
profile_id
integer | null
profile_name
string | null
alias
string | null
image
string | null