JobToday Scraper

This actor extracts job listings from JobToday, a leading job board platform operating across multiple countries. It normalizes job metadata, company information, location data, and application details so you can monitor job opportunities across various industries and regions.

---

🚀 Key Features

• ✅ Flexible URL-based scraping from any JobToday job listing page
• ✅ Automated pagination with configurable record limits
• ✅ Comprehensive job metadata (title, description, company, location)
• ✅ Structured address information with country, state, and city details
• ✅ Job categories and classification data
• ✅ Application details (external URLs, easy apply status, urgency flags)
• ✅ Built-in rate limiting and retry handling for reliability

---

👤 Who Is This Actor For?

This actor is ideal for:

• Job aggregators collecting listings from multiple sources
• Recruitment agencies monitoring competitor job postings
• Market researchers analyzing job market trends and demand
• HR analytics platforms enriching job data for insights
• Career services providing comprehensive job search capabilities

---

❓ Why Is This Actor Important?

JobToday is a major job board platform with extensive coverage across multiple countries and industries. Access to standardized job listing data supports:

• Real-time job market monitoring and trend analysis
• Competitive intelligence for recruitment and hiring strategies
• Market research on salary trends, skill demand, and geographic distribution
• Integrations with job aggregation and career services platforms

---

Input Schema

Here's an example input:

{
  "startUrls": [
    {
      "url": "https://jobtoday.com/es/trabajos-camarero/madrid"
    }
  ],
  "maxItems": 10,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}

Input Parameters

Parameter	Type	Description	Example	Required
startUrls	Array	URLs to start scraping from.	[{ "url": "https://jobtoday.com/es/trabajos-camarero/madrid" }]	✅ Yes
maxItems	Number	The maximum number of items to scrape.	10	❌ No
proxyConfiguration	Object	Optional proxy setup for Apify runs	{ "useApifyProxy": false }	❌ No

---

Output Schema

{
  "key": "itee7c723afb48532510a30c40cfa19f955b9e40d9f7494d180651e9ac98771eeb",
  "id": "itee7c723afb48532510a30c40cfa19f955b9e40d9f7494d180651e9ac98771eeb",
  "role": "Junior Software Developer – Academy",
  "description": "Diventa Software Engineer: l'opportunità in Sistemi Informativi IBM, multinazionale tech, parte da qui a PALERMO!. Academy Software Engineer – PALERMO.",
  "companyName": "Best Engage",
  "company": {
    "name": "Best Engage"
  },
  "address": "Sicily",
  "addressInfo": {
    "countryCode": "it",
    "display": {
      "fullName": "Sicily",
      "primaryName": "Sicily",
      "secondaryName": "",
      "cityAddress": "",
      "cityArea": "",
      "state": "sicily",
      "stateCode": "sicily"
    },
    "type": "unknown"
  },
  "categories": [
    {
      "code": "information_technology",
      "label": "Information Technology",
      "value": "information_technology",
      "icon": "https://cdn.jobtoday.com/categories/32x32/ic-emj-information_technology-32.png",
      "iconLarge": "https://cdn.jobtoday.com/categories/72x72/ic-emj-information_technology-72.png"
    }
  ],
  "immediateStart": false,
  "experienceNotRequired": false,
  "isExternalJob": true,
  "urgent": false,
  "isVerified": false,
  "easyApply": false,
  "applicationSlotsStatus": 1,
  "updateDate": 1767340800000,
  "url": "https://via.jobtoday.com/v2?job=itee7c723afb48532510a30c40cfa19f955b9e40d9f7494d180651e9ac98771eeb&partner=8&ts=2026-01-05T13%3A28%3A31.681274459Z&company=Best+Engage&context=jsweb&pc=api&ic=false&x-nonce=ee66b50e-cea5-42b5-9050-1ffaaa2f8831&x-key-id=dd96fa30-d0df-4eee-b058-4244f3103b43&x-sign=CRxJFfFzCFNllklAPs%2B2xG6zOAIO5lu%2Fe6WgCRd0pFQ%3D",
  "externalUrl": "https://via.jobtoday.com/v2?job=itee7c723afb48532510a30c40cfa19f955b9e40d9f7494d180651e9ac98771eeb&partner=8&ts=2026-01-05T13%3A28%3A31.681274459Z&company=Best+Engage&context=jsweb&pc=api&ic=false&x-nonce=ee66b50e-cea5-42b5-9050-1ffaaa2f8831&x-key-id=dd96fa30-d0df-4eee-b058-4244f3103b43&x-sign=CRxJFfFzCFNllklAPs%2B2xG6zOAIO5lu%2Fe6WgCRd0pFQ%3D",
  "canonicalUrl": "",
  "clickBehaviour": "open-external-url",
  "imageUrl16x9": {
    "small": "https://cdn.jobtoday.com/defaults/640/default_company_main_image_3.jpg"
  }
}

Output Fields

Field	Type	Description
key	String	Unique job identifier key
id	String	Unique job identifier (same as key)
role	String	Job title/position name
description	String	Full job description text
companyName	String	Company name
company	Object	Company object containing name field
address	String	Job location address (short format)
addressInfo	Object	Detailed address information with country code, display names, state, and city details
categories	Array	Array of job category objects with code, label, value, and icon URLs
immediateStart	Boolean	Whether the job offers immediate start
experienceNotRequired	Boolean	Whether previous experience is required
isExternalJob	Boolean	Whether the job is posted externally (redirects to external application)
urgent	Boolean	Whether the job posting is marked as urgent
isVerified	Boolean	Whether the company posting is verified
easyApply	Boolean	Whether easy apply option is available
applicationSlotsStatus	Number	Application slots status indicator
updateDate	Number	Timestamp of when the job was last updated (Unix timestamp in milliseconds)
url	String	Direct URL to the job listing on JobToday or external application URL
externalUrl	String	External application URL (if isExternalJob is true)
canonicalUrl	String	Canonical URL for the job listing
clickBehaviour	String	Behavior when clicking the job (e.g., "open-external-url")
imageUrl16x9	Object	Object containing image URLs (e.g., small field with company/job image URL)

---

🔍 Data Coverage

• Job profile: Unique ID, job title, description, company information
• Location data: Address string, detailed address info with country code, state, city, and geographic coordinates
• Company information: Company name and verification status
• Job categories: Industry classification with icons and labels
• Application details: External URLs, easy apply status, application slots, click behavior
• Job metadata: Urgency flags, immediate start availability, experience requirements, update timestamps
• Media assets: Company/job images in various sizes
• Result limits: Use maxItems to cap output

---

👀 p.s.

Got feedback or need an extension?

Lexis Solutions is a certified Apify Partner. We can help you with custom solutions or data extraction projects.

Contact us over Email or LinkedIn

Support Our Work 💝

If you're happy with our work and scrapers, you're welcome to leave us a company review and leave a review for the scrapers you're subscribed to. It will take you less than a minute but it will mean a lot to us!