/reed/jobs

curl --request POST \
  --url https://api.anysite.io/api/reed/jobs \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "job": "<string>",
  "timeout": 300
}
'

[
  {
    "id": 123,
    "@type": "@reed_job",
    "url": "<string>",
    "title": "<string>",
    "description": "<string>",
    "created_at": "<string>",
    "updated_at": "<string>",
    "display_date": "<string>",
    "expiry_date": "<string>",
    "next_refresh_date": "<string>",
    "taxonomy": "<string>",
    "breadcrumbs": [],
    "skills": [],
    "screening_questions": [],
    "contract_type": "<string>",
    "cover_letter_preference": "<string>",
    "recruiter_tier": "<string>",
    "application_eligibility": "<string>",
    "is_full_time": true,
    "is_part_time": true,
    "is_permanent": true,
    "is_temp": true,
    "is_contract": true,
    "is_agency": true,
    "is_employer": true,
    "is_reed": true,
    "is_featured": true,
    "is_promoted": true,
    "is_graduate": true,
    "is_early_bird": true,
    "is_easy_apply": true,
    "is_training_job": true,
    "is_live": true,
    "is_public": true,
    "is_suspended": true,
    "is_redirect": true,
    "is_manage_exec": true,
    "is_multilingual": true,
    "has_eligibility_to_work_in_uk": true,
    "salary": {
      "@type": "@reed_job_salary",
      "display": "<string>",
      "currency_id": 123,
      "salary_from": 123,
      "salary_to": 123,
      "from_per_annum": 123,
      "to_per_annum": 123,
      "type": "<string>",
      "is_ote": true,
      "has_included_benefits": true,
      "is_pro_rata": true,
      "is_negotiable": true
    },
    "location": {
      "@type": "@reed_job_location",
      "location_name": "<string>",
      "town_name": "<string>",
      "county_name": "<string>",
      "region_name": "<string>",
      "sub_country_name": "<string>",
      "country_name": "<string>",
      "country_code": "<string>",
      "post_code": "<string>",
      "is_remote": true,
      "inferred_location_type": "<string>"
    },
    "owner": {
      "@type": "@reed_job_owner",
      "ou_id": 123,
      "ou_name": "<string>",
      "ou_type": 123,
      "organisation_id": 123,
      "profile_id": 123,
      "profile_name": "<string>",
      "alias": "<string>",
      "company_profile_id": 123,
      "company_profile_url": "<string>",
      "reference": "<string>",
      "image": "<string>",
      "banner": "<string>"
    },
    "sector": {
      "@type": "@reed_job_sector",
      "id": 123,
      "name": "<string>",
      "parent_id": 123,
      "parent_name": "<string>"
    }
  }
]

/reed

/reed/jobs

Get full Reed job details by job ID (or job URL): title, full description, salary, location, posting company, sector, contract type, employment hours, posting/expiry dates and job flags.

Price: 10 credits

💡 AI Hint: Fetch a single Reed job by numeric ID or a job URL. Returns one item with id, url, title, description, created_at/updated_at/display_date/expiry_date/next_refresh_date, taxonomy, breadcrumbs, skills, screening_questions (text, expected_answer), contract_type, cover_letter_preference, recruiter_tier, application_eligibility, is_full_time/is_part_time, is_permanent/is_temp/is_contract, is_agency/is_employer/is_reed, is_featured/is_promoted/is_graduate/is_early_bird/is_easy_apply/is_training_job/is_live/is_public/is_suspended/is_redirect/is_manage_exec/is_multilingual, has_eligibility_to_work_in_uk, salary (display, salary_from/salary_to, type, is_negotiable), location (town/county/region/country, post_code, is_remote), owner (ou_name, organisation_id, profile_name, alias, image, banner) and sector.

⚠️ Common errors: 412: Job not found (well-formed but nonexistent or expired listing)

POST

api

reed

jobs

/reed/jobs

curl --request POST \
  --url https://api.anysite.io/api/reed/jobs \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "job": "<string>",
  "timeout": 300
}
'

[
  {
    "id": 123,
    "@type": "@reed_job",
    "url": "<string>",
    "title": "<string>",
    "description": "<string>",
    "created_at": "<string>",
    "updated_at": "<string>",
    "display_date": "<string>",
    "expiry_date": "<string>",
    "next_refresh_date": "<string>",
    "taxonomy": "<string>",
    "breadcrumbs": [],
    "skills": [],
    "screening_questions": [],
    "contract_type": "<string>",
    "cover_letter_preference": "<string>",
    "recruiter_tier": "<string>",
    "application_eligibility": "<string>",
    "is_full_time": true,
    "is_part_time": true,
    "is_permanent": true,
    "is_temp": true,
    "is_contract": true,
    "is_agency": true,
    "is_employer": true,
    "is_reed": true,
    "is_featured": true,
    "is_promoted": true,
    "is_graduate": true,
    "is_early_bird": true,
    "is_easy_apply": true,
    "is_training_job": true,
    "is_live": true,
    "is_public": true,
    "is_suspended": true,
    "is_redirect": true,
    "is_manage_exec": true,
    "is_multilingual": true,
    "has_eligibility_to_work_in_uk": true,
    "salary": {
      "@type": "@reed_job_salary",
      "display": "<string>",
      "currency_id": 123,
      "salary_from": 123,
      "salary_to": 123,
      "from_per_annum": 123,
      "to_per_annum": 123,
      "type": "<string>",
      "is_ote": true,
      "has_included_benefits": true,
      "is_pro_rata": true,
      "is_negotiable": true
    },
    "location": {
      "@type": "@reed_job_location",
      "location_name": "<string>",
      "town_name": "<string>",
      "county_name": "<string>",
      "region_name": "<string>",
      "sub_country_name": "<string>",
      "country_name": "<string>",
      "country_code": "<string>",
      "post_code": "<string>",
      "is_remote": true,
      "inferred_location_type": "<string>"
    },
    "owner": {
      "@type": "@reed_job_owner",
      "ou_id": 123,
      "ou_name": "<string>",
      "ou_type": 123,
      "organisation_id": 123,
      "profile_id": 123,
      "profile_name": "<string>",
      "alias": "<string>",
      "company_profile_id": 123,
      "company_profile_url": "<string>",
      "reference": "<string>",
      "image": "<string>",
      "banner": "<string>"
    },
    "sector": {
      "@type": "@reed_job_sector",
      "id": 123,
      "name": "<string>",
      "parent_id": 123,
      "parent_name": "<string>"
    }
  }
]

Authorizations

access-token

string

header

required

API token from the dashboard

Headers

access-token

string

required

Body

application/json

job

string

required

Reed job ID or a job URL containing it

Minimum string length: 1

Examples:

"56531217"

"https://www.reed.co.uk/jobs/python-developer/56531217"

timeout

integer

default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500

Response

Successful Response

integer

required

@type

string

default:@reed_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

next_refresh_date

string | null

taxonomy

string | null

breadcrumbs

string[]

skills

string[]

screening_questions

ReedScreeningQuestion · object[]

Show child attributes

contract_type

string | null

cover_letter_preference

string | null

recruiter_tier

string | null

application_eligibility

string | null

is_full_time

boolean | null

is_part_time

boolean | null

is_permanent

boolean | null

is_temp

boolean | null

is_contract

boolean | null

is_agency

boolean | null

is_employer

boolean | null

is_reed

boolean | null

is_featured

boolean | null

is_promoted

boolean | null

is_graduate

boolean | null

is_early_bird

boolean | null

is_easy_apply

boolean | null

is_training_job

boolean | null

is_live

boolean | null

is_public

boolean | null

is_suspended

boolean | null

is_redirect

boolean | null

is_manage_exec

boolean | null

is_multilingual

boolean | null

has_eligibility_to_work_in_uk

boolean | null

salary

ReedJobSalary · object

Show child attributes

location

ReedJobLocation · object

Show child attributes

owner

ReedJobOwner · object

Show child attributes

sector

ReedJobSector · object

Show child attributes

/reed/companies /reed/jobs/search