/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>"
  }
]

/reed

/reed/jobs/search

Search Reed jobs by keywords and location. Returns job cards: id, url, title, description, salary, location, remote option, posting company and dates. Filter by distance, salary range, job type, who posted, sector, remote, date posted and graduate/visa-sponsorship/easy-apply/early-bird/hide-training-jobs flags.

Price: 10 credits per 25 results

💡 AI Hint: Search Reed jobs. Provide keywords (required) and optional location. Each result has id (feed to reed/jobs for full detail), url, title, description, created_at/updated_at/display_date/expiry_date, location_name, county, remote_option, job_type, salary_from/salary_to/salary_type, currency_id, payment_model, taxonomy_level_1/2, is_full_time/is_part_time/is_easy_apply/is_promoted/is_featured/is_training_job/is_early_bird/is_priority/is_top_job/is_survey_job/is_ats_direct_apply, eligible_uk_only, external_url, ou_id/ou_name/ou_type/ou_tier_id/ou_url, profile_id/profile_name, alias and image. Narrow with distance (miles), salary_from/salary_to (GBP/year), job_type, posted_by (agency/employer/reed), sector (industry), remote_only, date_posted and graduate/visa_sponsorship/easy_apply/early_bird/hide_training_jobs.

POST

api

reed

jobs

/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

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_featured

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

/reed/jobs /reed/jobs/similar