Skip to main content
POST
/
api
/
reed
/
jobs
/
similar
/reed/jobs/similar
curl --request POST \
  --url https://api.anysite.io/api/reed/jobs/similar \
  --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 to find similar jobs for

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

id
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[]
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_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
location
ReedJobLocation · object
owner
ReedJobOwner · object
sector
ReedJobSector · object