JobToday Scraper

Extract structured job listings from JobToday — the mobile-first job platform for hospitality, retail, and blue-collar work — across 5 markets: UK, Spain, France, USA and Italy.

Each result includes the job title, full company profile, salary range, GPS coordinates, employment type, easy-apply flag, and the complete job description in both plain text and Markdown.

---

Features

• 5 markets: UK (gb), Spain (es), France (fr), USA (us), Italy (it)
• Keyword search — search by job title or role
• Location filter — narrow by city or region
• Employment type — Full-time or Part-time
• Easy apply — only jobs you can apply to directly on JobToday
• Immediate start — jobs available right away
• No experience required — entry-level only
• Language filter — filter by required job language (en, es, fr, it, de)
• daysOld filter — only jobs posted within N days
• maxItems cap — control spend exactly
• Built-in deduplication — no duplicate jobs within a single run
• Multi-country — scrape multiple markets in one run

---

Input parameters

Parameter	Type	Default	Description
countries	array	["gb"]	Markets to scrape: gb, es, fr, us, it
keyword	string	""	Job title or search term. Empty = all jobs
location	string	""	City or region (e.g. London, Madrid)
employmentTypes	array	[]	FULL_TIME, PART_TIME, or both
easyApply	boolean	false	Only jobs with direct in-app application
immediateStart	boolean	false	Only jobs with an immediate start
noExperience	boolean	false	Only entry-level / no experience required
languageCodes	array	[]	Filter by required language: en, es, fr, it, de
maxItems	integer	0	Max results (0 = unlimited)
daysOld	integer	0	Max job age in days (0 = no limit)

Example inputs

Search UK hospitality jobs in London:

{
  "countries": ["gb"],
  "keyword": "chef",
  "location": "london",
  "maxItems": 500
}

All easy-apply, no-experience jobs in Spain:

{
  "countries": ["es"],
  "easyApply": true,
  "noExperience": true,
  "maxItems": 200
}

Multi-market sweep — UK + Spain + France:

{
  "countries": ["gb", "es", "fr"],
  "employmentTypes": ["FULL_TIME"],
  "daysOld": 7,
  "maxItems": 1000
}

---

Output schema

Each item represents one job listing:

{
  "jobId": "mBzZO8",
  "title": "Head Chef",
  "companyName": "The Ivy Collection",
  "companyBusinessCategory": "Restaurant",
  "companySize": "51-200 employees",
  "companyUrl": "https://jobtoday.com/gb/company/...",
  "location": "London, England, United Kingdom",
  "city": "London",
  "state": "England",
  "country": "United Kingdom",
  "postalCode": "EC1M 7AD",
  "latitude": 51.5236,
  "longitude": -0.0981,
  "employmentType": "FULL_TIME",
  "salaryMin": 45000,
  "salaryMax": 52000,
  "salaryCurrency": "GBP",
  "salaryPeriod": "YEARLY",
  "salaryExtra": "Tronc system included",
  "salarySource": "structured",
  "immediateStart": false,
  "experienceNotRequired": false,
  "easyApply": true,
  "urgent": false,
  "isVerified": true,
  "isExternalJob": false,
  "categories": ["Chefs & Cooks"],
  "categoryCode": "chef",
  "description": "We are looking for a Head Chef...",
  "descriptionMarkdown": "## Head Chef\n\nWe are looking for...",
  "applyUrl": "https://jobtoday.com/gb/job/head-chef-mBzZO8",
  "imageUrl": "https://cdn.jobtoday.com/img/...",
  "postedAt": "2026-03-31T08:19:58.000Z",
  "updatedAt": "2026-03-31T08:19:58.000Z",
  "postedSecondsAgo": 1905,
  "market": "gb",
  "scrapedAt": "2026-03-31T09:00:00.000Z"
}

---

Pricing

$1.00 per 1,000 results — you only pay for successfully extracted jobs. Failed retries are never charged.

Results	Estimated cost
100	~$0.10
1,000	~$1.00
10,000	~$10.00
100,000	~$100.00

Flat-rate alternatives typically charge $25–$49/month regardless of usage. At 1,000 results/month, this scraper costs significantly less with no commitment.

Use the Max results cap in the input to control your spend exactly.

---

Performance

Scenario	Results	Time
Single market, no filter	2,400	~35s
Keyword + location, UK	~500	~10s
5 markets, maxItems=1,000	1,000	~15s

Throughput: ~100 results/second with concurrent pagination.

---

Technical details

• Memory: 256 MB
• Retry: Automatic retry on network errors, exponential backoff, 3 attempts per request
• Dedup: jobId-based deduplication within each run

---

Known limitations

• Apply URL: links to the JobToday job detail page. Direct external application links are not available.
• Salary: Not published by all employers — will be null when unavailable. When no structured salary exists, the scraper attempts to extract a range from the job description text (e.g. "Typical earnings: £500–£2,000/month"). Use salarySource to distinguish: "structured" = set by employer, "description" = parsed from description text, null = no salary found.
• Language filter: Only meaningful when the target market has jobs in that language (e.g. languageCodes: ["es"] works for countries: ["es"]).
• Markets: Only gb, es, fr, us and it are active. Other country codes return no results.

---

Additional services

Need a custom actor, additional filters, scheduled runs, or integration support? Send an email to info@unfencedgroup.nl — we build on request.

---

Built by unfenced-group