Vexaloom Labs
Actors/Reed.co.uk UK Job Listings & Pay Extractor

Reed.co.uk UK Job Listings & Pay Extractor

Search live Reed.co.uk vacancies by keyword and location and get structured job records with parsed pay ranges, job type, remote status and job descriptions.

Open on ApifyGitHub source

Input schema

Input fields, types, required flags, descriptions, defaults, and prefills come from the published definition. Prefill examples are distinct from defaults.

FieldTypeRequiredDescription
modestringoptionalSearch Reed's job listings, or scrape specific Reed search/job URLs.
keywordsstringoptionalJob title, skill or phrase to search for (mode=search).
searchQueriesarrayoptionalRun several keyword searches in one run (mode=search). When set, this replaces Keywords.
Show all input fields
FieldTypeRequiredDescription
modestringoptionalSearch Reed's job listings, or scrape specific Reed search/job URLs.
keywordsstringoptionalJob title, skill or phrase to search for (mode=search).
searchQueriesarrayoptionalRun several keyword searches in one run (mode=search). When set, this replaces Keywords.
locationstringoptionalUK town, city, region or postcode (mode=search). Leave blank for UK-wide.
sectorstringoptionalLimit results to one of Reed's parent sectors (mode=search).
proximitystringoptionalRadius around the location (mode=search).
salaryFromintegeroptionalAnnual salary floor in pounds (mode=search). Reed matches jobs whose salary range overlaps this floor.
salaryTointegeroptionalAnnual salary ceiling in pounds (mode=search). Reed matches jobs whose salary range overlaps this ceiling.
postedWithinstringoptionalOnly return jobs posted in this window (mode=search).
postedBystringoptionalFilter by who advertised the job (mode=search).
remoteOptionstringoptionalFilter by remote, hybrid or on-site work (mode=search).
permanentbooleanoptionalOnly permanent contracts (mode=search).
contractbooleanoptionalOnly contract roles (mode=search).
temporarybooleanoptionalOnly temporary roles (mode=search).
fullTimebooleanoptionalOnly full-time roles (mode=search).
partTimebooleanoptionalOnly part-time roles (mode=search).
graduateOnlybooleanoptionalOnly graduate roles (mode=search).
easyApplyOnlybooleanoptionalOnly jobs with Reed Easy Apply (mode=search).
visaSponsorshipbooleanoptionalOnly jobs Reed marks as offering visa sponsorship (mode=search).
hideNoSalarybooleanoptionalExclude listings where no salary is displayed (mode=search).
hideTrainingJobsbooleanoptionalExclude training-course adverts (mode=search).
hideSurveyJobsbooleanoptionalExclude survey-job adverts (mode=search).
searchUrlsarrayoptionalOne or more Reed search URLs (mode=byUrl). Their filters are preserved; other filters here are added when absent.
jobUrlsarrayoptionalOne or more Reed job URLs or numeric job IDs (mode=byUrl).
fetchDetailsbooleanoptionalOpen each job page for the full description, display salary, per-annum pay and location details. Turn off for a faster listing-only run.
maxItemsintegeroptionalMaximum number of job records to return (1-10,000). Reed exposes at most 10,000 results per search.

Download the published input schema

View complete JSON
{
  "description": "Search Reed.co.uk by keywords, location, pay, job type, remote option and posting date, or scrape specific Reed search and job URLs. No account or API key needed.",
  "properties": {
    "contract": {
      "default": false,
      "description": "Only contract roles (mode=search).",
      "prefill": false,
      "title": "Contract jobs",
      "type": "boolean"
    },
    "easyApplyOnly": {
      "default": false,
      "description": "Only jobs with Reed Easy Apply (mode=search).",
      "prefill": false,
      "title": "Easy Apply only",
      "type": "boolean"
    },
    "fetchDetails": {
      "default": true,
      "description": "Open each job page for the full description, display salary, per-annum pay and location details. Turn off for a faster listing-only run.",
      "prefill": true,
      "title": "Fetch full details",
      "type": "boolean"
    },
    "fullTime": {
      "default": false,
      "description": "Only full-time roles (mode=search).",
      "prefill": false,
      "title": "Full-time",
      "type": "boolean"
    },
    "graduateOnly": {
      "default": false,
      "description": "Only graduate roles (mode=search).",
      "prefill": false,
      "title": "Graduate jobs",
      "type": "boolean"
    },
    "hideNoSalary": {
      "default": false,
      "description": "Exclude listings where no salary is displayed (mode=search).",
      "prefill": false,
      "title": "Hide jobs without pay",
      "type": "boolean"
    },
    "hideSurveyJobs": {
      "default": false,
      "description": "Exclude survey-job adverts (mode=search).",
      "prefill": false,
      "title": "Hide survey ads",
      "type": "boolean"
    },
    "hideTrainingJobs": {
      "default": false,
      "description": "Exclude training-course adverts (mode=search).",
      "prefill": false,
      "title": "Hide training ads",
      "type": "boolean"
    },
    "jobUrls": {
      "description": "One or more Reed job URLs or numeric job IDs (mode=byUrl).",
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "title": "Reed job URLs or IDs",
      "type": "array"
    },
    "keywords": {
      "description": "Job title, skill or phrase to search for (mode=search).",
      "editor": "textfield",
      "prefill": "software engineer",
      "title": "Keywords",
      "type": "string"
    },
    "location": {
      "description": "UK town, city, region or postcode (mode=search). Leave blank for UK-wide.",
      "editor": "textfield",
      "title": "Location",
      "type": "string"
    },
    "maxItems": {
      "default": 50,
      "description": "Maximum number of job records to return (1-10,000). Reed exposes at most 10,000 results per search.",
      "maximum": 10000,
      "minimum": 1,
      "prefill": 3,
      "title": "Max jobs",
      "type": "integer"
    },
    "mode": {
      "default": "search",
      "description": "Search Reed's job listings, or scrape specific Reed search/job URLs.",
      "editor": "select",
      "enum": [
        "search",
        "byUrl"
      ],
      "enumTitles": [
        "Search jobs",
        "Scrape specific URLs"
      ],
      "prefill": "search",
      "title": "Mode",
      "type": "string"
    },
    "partTime": {
      "default": false,
      "description": "Only part-time roles (mode=search).",
      "prefill": false,
      "title": "Part-time",
      "type": "boolean"
    },
    "permanent": {
      "default": false,
      "description": "Only permanent contracts (mode=search).",
      "prefill": false,
      "title": "Permanent jobs",
      "type": "boolean"
    },
    "postedBy": {
      "default": "any",
      "description": "Filter by who advertised the job (mode=search).",
      "editor": "select",
      "enum": [
        "any",
        "agency",
        "employer",
        "reed"
      ],
      "enumTitles": [
        "Anyone",
        "Recruitment agency",
        "Direct employer",
        "Reed"
      ],
      "prefill": "any",
      "title": "Posted by",
      "type": "string"
    },
    "postedWithin": {
      "default": "anytime",
      "description": "Only return jobs posted in this window (mode=search).",
      "editor": "select",
      "enum": [
        "anytime",
        "today",
        "lastThreeDays",
        "lastWeek",
        "lastTwoWeeks"
      ],
      "enumTitles": [
        "Anytime",
        "Today",
        "Last 3 days",
        "Last week",
        "Last 2 weeks"
      ],
      "prefill": "anytime",
      "title": "Posted within",
      "type": "string"
    },
    "proximity": {
      "default": "10",
      "description": "Radius around the location (mode=search).",
      "editor": "select",
      "enum": [
        "0",
        "1",
        "3",
        "5",
        "10",
        "15",
        "20",
        "30",
        "50"
      ],
      "enumTitles": [
        "Exact location",
        "1 mile",
        "3 miles",
        "5 miles",
        "10 miles",
        "15 miles",
        "20 miles",
        "30 miles",
        "50 miles"
      ],
      "prefill": "10",
      "title": "Distance (miles)",
      "type": "string"
    },
    "remoteOption": {
      "default": "any",
      "description": "Filter by remote, hybrid or on-site work (mode=search).",
      "editor": "select",
      "enum": [
        "any",
        "remote",
        "hybrid",
        "onSite"
      ],
      "enumTitles": [
        "Any",
        "Remote",
        "Hybrid",
        "On-site"
      ],
      "prefill": "any",
      "title": "Work arrangement",
      "type": "string"
    },
    "salaryFrom": {
      "description": "Annual salary floor in pounds (mode=search). Reed matches jobs whose salary range overlaps this floor.",
      "maximum": 500000,
      "minimum": 0,
      "title": "Minimum salary (GBP)",
      "type": "integer"
    },
    "salaryTo": {
      "description": "Annual salary ceiling in pounds (mode=search). Reed matches jobs whose salary range overlaps this ceiling.",
      "maximum": 500000,
      "minimum": 0,
      "title": "Maximum salary (GBP)",
      "type": "integer"
    },
    "searchQueries": {
      "description": "Run several keyword searches in one run (mode=search). When set, this replaces Keywords.",
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "title": "Multiple searches",
      "type": "array"
    },
    "searchUrls": {
      "description": "One or more Reed search URLs (mode=byUrl). Their filters are preserved; other filters here are added when absent.",
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "title": "Reed search URLs",
      "type": "array"
    },
    "sector": {
      "default": "any",
      "description": "Limit results to one of Reed's parent sectors (mode=search).",
      "editor": "select",
      "enum": [
        "any",
        "100",
        "30",
        "90",
        "146",
        "52",
        "24",
        "12",
        "2",
        "3",
        "34",
        "117",
        "18",
        "11",
        "1962",
        "1755",
        "168",
        "66",
        "68",
        "36",
        "6",
        "5",
        "27",
        "338",
        "1722",
        "169",
        "101",
        "1700",
        "16",
        "500",
        "71",
        "1961",
        "92",
        "21",
        "1963",
        "89",
        "1909",
        "1964"
      ],
      "enumTitles": [
        "Any sector",
        "Accountancy (Qualified)",
        "Sales",
        "Retail",
        "Construction & Property",
        "IT & Telecoms",
        "Human Resources",
        "Engineering",
        "Accountancy",
        "Admin, Secretarial & PA",
        "Social Care",
        "Financial Services",
        "Marketing & PR",
        "Transport & Logistics",
        "Estate Agency",
        "Strategy & Consultancy",
        "Manufacturing",
        "Customer Service",
        "Education",
        "Health & Medicine",
        "Hospitality & Catering",
        "Banking",
        "Purchasing",
        "Recruitment Consultancy",
        "FMCG",
        "Graduate Training & Internships",
        "Legal",
        "Motoring & Automotive",
        "General Insurance",
        "Charity & Voluntary",
        "Media, Digital & Creative",
        "Energy",
        "Leisure & Tourism",
        "Other",
        "Security & Safety",
        "Scientific",
        "Training",
        "Apprenticeships"
      ],
      "prefill": "any",
      "title": "Sector",
      "type": "string"
    },
    "temporary": {
      "default": false,
      "description": "Only temporary roles (mode=search).",
      "prefill": false,
      "title": "Temporary jobs",
      "type": "boolean"
    },
    "visaSponsorship": {
      "default": false,
      "description": "Only jobs Reed marks as offering visa sponsorship (mode=search).",
      "prefill": false,
      "title": "Visa sponsorship",
      "type": "boolean"
    }
  },
  "required": [],
  "schemaVersion": 1,
  "title": "Reed.co.uk Jobs & Pay Input",
  "type": "object"
}

Output schema

Published result links and storage locations. This schema is not an exhaustive contract for every field in a dataset record.

FieldTypeRequiredDescription
jobsstringoptionalDataset containing all scraped Reed.co.uk job listings.

Download the published output schema

View complete JSON
{
  "actorOutputSchemaVersion": 1,
  "description": "Reed.co.uk job listings with full descriptions, parsed pay ranges, employer and location metadata, sector, skills and direct job URLs.",
  "properties": {
    "jobs": {
      "description": "Dataset containing all scraped Reed.co.uk job listings.",
      "template": "{{links.apiDefaultDatasetUrl}}/items",
      "title": "Reed.co.uk job listings",
      "type": "string"
    }
  },
  "title": "Reed.co.uk UK Job Listings & Pay Extractor Output"
}

Dataset schema

Published dataset views and any declared field definitions. A view can select only a subset of the returned record fields.

Download the published dataset schema

View complete JSON
{
  "actorSpecification": 1,
  "fields": {
    "properties": {
      "category": {
        "description": "Top-level Reed role category",
        "nullable": true,
        "type": "string"
      },
      "companyLogoUrl": {
        "description": "Employer logo image URL",
        "nullable": true,
        "type": "string"
      },
      "companyName": {
        "description": "Hiring employer or recruitment agency",
        "nullable": true,
        "type": "string"
      },
      "companyUrl": {
        "description": "Employer's Reed jobs/profile page",
        "nullable": true,
        "type": "string"
      },
      "country": {
        "description": "Country name",
        "nullable": true,
        "type": "string"
      },
      "countryCode": {
        "description": "ISO country code, normally GB",
        "nullable": true,
        "type": "string"
      },
      "county": {
        "description": "County of the job",
        "nullable": true,
        "type": "string"
      },
      "datePosted": {
        "description": "Creation date in ISO 8601 UTC",
        "nullable": true,
        "type": "string"
      },
      "dateUpdated": {
        "description": "Last update date in ISO 8601 UTC",
        "nullable": true,
        "type": "string"
      },
      "description": {
        "description": "Full job description as plain text",
        "nullable": true,
        "type": "string"
      },
      "descriptionHtml": {
        "description": "Full job description as HTML",
        "nullable": true,
        "type": "string"
      },
      "displayDate": {
        "description": "Reed's display date in ISO 8601 UTC",
        "nullable": true,
        "type": "string"
      },
      "eligibilityRequirement": {
        "description": "Reed's raw eligibility requirement",
        "nullable": true,
        "type": "string"
      },
      "eligibleUkOnly": {
        "description": "True when the search listing is marked UK-only",
        "type": "boolean"
      },
      "expiryDate": {
        "description": "Listing expiry date in ISO 8601 UTC",
        "nullable": true,
        "type": "string"
      },
      "externalUrl": {
        "description": "Legacy field; Reed's public pages do not expose an external apply URL",
        "nullable": true,
        "type": "string"
      },
      "isEarlyBird": {
        "description": "True when the listing is an early-bird advert",
        "type": "boolean"
      },
      "isEasyApply": {
        "description": "True when Reed Easy Apply is available",
        "type": "boolean"
      },
      "isFeatured": {
        "description": "True when the listing is featured",
        "type": "boolean"
      },
      "isFullTime": {
        "description": "True when the role is full-time",
        "type": "boolean"
      },
      "isGraduate": {
        "description": "True when Reed marks the role as graduate",
        "type": "boolean"
      },
      "isLive": {
        "description": "True when the detail page says the job is live",
        "type": "boolean"
      },
      "isPartTime": {
        "description": "True when the role is part-time",
        "type": "boolean"
      },
      "isPromoted": {
        "description": "True when the listing is promoted",
        "type": "boolean"
      },
      "isRedirect": {
        "description": "True when applications leave Reed",
        "type": "boolean"
      },
      "isRemote": {
        "description": "True when Reed marks the role as remote",
        "type": "boolean"
      },
      "isSurveyJob": {
        "description": "True when the listing is a survey advert",
        "type": "boolean"
      },
      "isTrainingJob": {
        "description": "True when the listing is a training advert",
        "type": "boolean"
      },
      "jobId": {
        "description": "Reed's numeric job identifier",
        "type": "string"
      },
      "jobType": {
        "description": "Permanent, Contract or Temporary",
        "nullable": true,
        "type": "string"
      },
      "location": {
        "description": "Display location as shown by Reed",
        "nullable": true,
        "type": "string"
      },
      "postCode": {
        "description": "Postcode when the employer publishes one",
        "nullable": true,
        "type": "string"
      },
      "postedBy": {
        "description": "Agency, Employer or Reed",
        "nullable": true,
        "type": "string"
      },
      "recordType": {
        "description": "Always job",
        "type": "string"
      },
      "recruiterReference": {
        "description": "Recruiter's own job reference",
        "nullable": true,
        "type": "string"
      },
      "region": {
        "description": "UK region from the detail page",
        "nullable": true,
        "type": "string"
      },
      "remoteWorking": {
        "description": "Remote, Hybrid or On-site",
        "nullable": true,
        "type": "string"
      },
      "requiresUkEligibility": {
        "description": "True when the job requires UK work eligibility",
        "type": "boolean"
      },
      "salaryCurrency": {
        "description": "ISO currency code, normally GBP",
        "nullable": true,
        "type": "string"
      },
      "salaryDescription": {
        "description": "Salary text as displayed by Reed",
        "nullable": true,
        "type": "string"
      },
      "salaryFrom": {
        "description": "Lower salary bound in the stated period",
        "nullable": true,
        "type": "number"
      },
      "salaryFromPerAnnum": {
        "description": "Lower bound normalised to a full year",
        "nullable": true,
        "type": "number"
      },
      "salaryIsCompetitive": {
        "description": "True when Reed labels the pay as competitive",
        "type": "boolean"
      },
      "salaryIsNegotiable": {
        "description": "True when Reed labels the pay as negotiable",
        "type": "boolean"
      },
      "salaryIsOte": {
        "description": "True when the pay includes OTE",
        "type": "boolean"
      },
      "salaryIsProRata": {
        "description": "True when the salary is pro rata",
        "type": "boolean"
      },
      "salaryTo": {
        "description": "Upper salary bound in the stated period",
        "nullable": true,
        "type": "number"
      },
      "salaryToPerAnnum": {
        "description": "Upper bound normalised to a full year",
        "nullable": true,
        "type": "number"
      },
      "salaryType": {
        "description": "Pay period: Per hour, Per day, Per week, Per month or Per annum",
        "nullable": true,
        "type": "string"
      },
      "scrapedAt": {
        "description": "UTC timestamp when the record was collected",
        "type": "string"
      },
      "searchLocation": {
        "description": "Location search that produced this record",
        "nullable": true,
        "type": "string"
      },
      "searchQuery": {
        "description": "Keyword search that produced this record",
        "nullable": true,
        "type": "string"
      },
      "sector": {
        "description": "Detailed Reed sector from the job page",
        "nullable": true,
        "type": "string"
      },
      "sectorParent": {
        "description": "Parent Reed sector",
        "nullable": true,
        "type": "string"
      },
      "skills": {
        "description": "Skills Reed associates with the job",
        "items": {
          "type": "string"
        },
        "type": "array"
      },
      "sourceUrl": {
        "description": "Canonical Reed job page URL",
        "type": "string"
      },
      "subcategory": {
        "description": "Reed role specialism",
        "nullable": true,
        "type": "string"
      },
      "title": {
        "description": "Job title",
        "type": "string"
      },
      "town": {
        "description": "Town or city from the detail page",
        "nullable": true,
        "type": "string"
      }
    },
    "type": "object"
  },
  "title": "Reed.co.uk jobs",
  "views": {
    "overview": {
      "display": {
        "component": "table",
        "properties": {
          "sourceUrl": {
            "format": "link",
            "label": "Job URL"
          }
        }
      },
      "title": "Jobs",
      "transformation": {
        "fields": [
          "title",
          "companyName",
          "location",
          "salaryDescription",
          "jobType",
          "remoteWorking",
          "datePosted",
          "sourceUrl"
        ]
      }
    },
    "payAndDetails": {
      "display": {
        "component": "table",
        "properties": {
          "description": {
            "format": "text",
            "label": "Description"
          },
          "skills": {
            "format": "array",
            "label": "Skills"
          },
          "sourceUrl": {
            "format": "link",
            "label": "Job URL"
          }
        }
      },
      "title": "Pay and details",
      "transformation": {
        "fields": [
          "title",
          "companyName",
          "postedBy",
          "location",
          "salaryFrom",
          "salaryTo",
          "salaryType",
          "salaryFromPerAnnum",
          "salaryToPerAnnum",
          "salaryCurrency",
          "jobType",
          "remoteWorking",
          "sector",
          "skills",
          "datePosted",
          "expiryDate",
          "description",
          "sourceUrl"
        ]
      }
    }
  }
}

Key-value schema

Published key-value store definitions, when provided by this build.

This definition is not present in the default published build. See the published README for available documentation.

Published README

Read the full published documentation

Reed.co.uk UK Job Listings & Pay Extractor

Pull live UK vacancies from Reed.co.uk into a clean dataset with full job descriptions, parsed pay ranges, employer details, location metadata and direct job links. Search by keyword, location, salary band, contract type, work arrangement and posting date, or scrape Reed search and job URLs you already have.

What this actor does

  • Searches Reed.co.uk by keyword and location, with filters for salary, job type, full/part-time, remote/hybrid/on-site, date posted, agency vs employer, graduate roles, Easy Apply, visa sponsorship and 37 sectors
  • Runs one search or several keyword searches in a single run, and accepts Reed search URLs or individual job URLs/IDs
  • Opens each job page to capture the full description, the displayed salary, annualised pay for hourly/daily/weekly/monthly roles, postcode, region, sector, skills and recruiter reference
  • Returns up to 10,000 jobs per search, deduplicated by Reed's job ID, with canonical job and employer URLs
  • Omits fields Reed does not publish for a job, so every record contains only real data

Output per job

Identity and links:

  • jobId — Reed's numeric job identifier
  • sourceUrl — canonical Reed job page
  • title, companyName, companyUrl, companyLogoUrl
  • recordType — always job
  • scrapedAt — collection timestamp

Location:

  • location, town, county, region, country, countryCode, postCode
  • remoteWorking — Remote, Hybrid or On-site
  • isRemote

Pay:

  • salaryDescription — the salary text Reed displays
  • salaryFrom, salaryTo — hourly, daily, weekly, monthly or annual bounds
  • salaryFromPerAnnum, salaryToPerAnnum — annualised bounds for easy comparison
  • salaryCurrency, salaryType
  • salaryIsNegotiable, salaryIsCompetitive, salaryIsOte, salaryIsProRata

Job and employer:

  • jobType — Permanent, Contract or Temporary
  • postedBy — Agency, Employer or Reed
  • recruiterReference
  • isFullTime, isPartTime, isEasyApply
  • category, subcategory, sector, sectorParent
  • skills

Description and dates:

  • description — full plain-text description
  • descriptionHtml — full HTML description
  • datePosted, dateUpdated, displayDate, expiryDate

Flags and provenance:

  • isGraduate, isPromoted, isFeatured, isEarlyBird, isTrainingJob, isSurveyJob
  • eligibleUkOnly, requiresUkEligibility, eligibilityRequirement
  • isLive, isRedirect
  • searchQuery, searchLocation
  • externalUrl — kept for compatibility; Reed's public pages do not expose an external apply URL, so it is normally omitted

Input

Field Type Default Description
mode string search search for keyword search, byUrl for Reed search/job URLs
keywords string – Keywords for one search (mode=search)
searchQueries array – Several keyword searches; replaces keywords (mode=search)
location string – UK town, city, region or postcode (mode=search)
sector string any One of 37 Reed parent sectors (mode=search)
proximity string 10 Radius around the location in miles (mode=search)
salaryFrom integer – Annual GBP salary floor (mode=search)
salaryTo integer – Annual GBP salary ceiling (mode=search)
postedWithin string anytime anytime, today, lastThreeDays, lastWeek, lastTwoWeeks (mode=search)
postedBy string any any, agency, employer, reed (mode=search)
remoteOption string any any, remote, hybrid, onSite (mode=search)
permanent, contract, temporary boolean false Contract-type filters (mode=search)
fullTime, partTime boolean false Working-hours filters (mode=search)
graduateOnly boolean false Graduate roles only (mode=search)
easyApplyOnly boolean false Reed Easy Apply only (mode=search)
visaSponsorship boolean false Visa-sponsorship roles only (mode=search)
hideNoSalary boolean false Exclude jobs without displayed pay (mode=search)
hideTrainingJobs, hideSurveyJobs boolean false Exclude training and survey adverts (mode=search)
searchUrls array – Reed search URLs; their filters are preserved (mode=byUrl)
jobUrls array – Reed job URLs or numeric IDs (mode=byUrl)
fetchDetails boolean true Open each job page for the full description and detailed pay/location
maxItems integer 50 Maximum records (1–10,000)

Example: software jobs in London with pay data

{
  "mode": "search",
  "keywords": "software engineer",
  "location": "London",
  "salaryFrom": 55000,
  "postedWithin": "lastWeek",
  "fetchDetails": true,
  "maxItems": 200
}

Example: remote nursing roles across the UK

{
  "mode": "search",
  "keywords": "registered nurse",
  "remoteOption": "remote",
  "postedBy": "employer",
  "maxItems": 100
}

Example: several searches in one run

{
  "mode": "search",
  "searchQueries": ["data analyst", "business analyst", "product analyst"],
  "location": "Manchester",
  "permanent": true,
  "maxItems": 300
}

Example: scrape a Reed search page and specific jobs

{
  "mode": "byUrl",
  "searchUrls": [
    "https://www.reed.co.uk/jobs/warehouse-jobs-in-leeds?permanent=true"
  ],
  "jobUrls": [
    "https://www.reed.co.uk/jobs/warehouse-operative/57400001",
    "57400002"
  ],
  "fetchDetails": true,
  "maxItems": 50
}

Use cases

  • Salary benchmarking — compare advertised pay for a role, region and contract type, including annualised day and hourly rates
  • Recruitment market monitoring — track live vacancy volumes by sector, employer and work arrangement
  • Job-board aggregation — feed Reed vacancies into a wider UK job search, newsletter or dashboard
  • Remote-work research — isolate remote and hybrid roles and compare their pay with on-site equivalents
  • Recruiter lead generation — find employers actively hiring in a skill area, city or salary band
  • Career planning — collect full descriptions and required skills for a target role before applications

FAQ

Do I need a Reed account or API key? No. The actor reads Reed.co.uk's public job pages. There is no login, key or cookie to supply.

Do I need to configure a proxy? No. The actor fetches Reed directly and can fall back to Apify's datacenter proxy automatically if Reed blocks the runner IP. There is no proxy setting to supply.

Why do some jobs have no salary fields? Reed lets employers hide pay. When a listing has no pay data, the salary fields are left out of that record rather than filled with a guess.

What does salaryFromPerAnnum add? It converts hourly, daily, weekly and monthly pay to an annual figure using Reed's own annualised values, so a £450/day contract can be compared with an £85,000 permanent role.

How many jobs can one search return? Reed exposes at most 10,000 results per search. The actor stops at that window and tells you in the run message; split a broad search by keyword, location or sector to collect more.

Why is externalUrl usually missing? Reed's public job pages do not include the employer's external application URL. The actor keeps the field for older integrations but does not invent a link.

Why are skills or postCode missing on some jobs? Reed only publishes them when the employer supplies them. The description, pay, location and dates are still returned.

Does fetchDetails: false still return descriptions? No. Turning details off makes runs faster and returns the listing fields only; the full description and detailed salary breakdown require opening the job page.

What happens if a job page is unavailable? The listing record is still returned with its title, company, location and search-page pay data; only the detail-only fields such as the full description are omitted.

Are duplicate jobs possible? The actor deduplicates by Reed's job ID across pages and searches. Reed's result order can shift slightly between requests, so this is necessary even on a single search.

Is this affiliated with Reed.co.uk? No. It is an independent tool that reads publicly available job listings and is not endorsed by or affiliated with Reed.co.uk.

Python quickstart

Use a schema-derived input and the Python standard library to start a run. An Apify account and token are required for execution.

Open the step-by-step Python guide →

Source build PXJc0ImTfiwpuWFBr. Documentation is regenerated from the default published build; private drafts are not included.