Pricing

from $1.39 / 1,000 results

Try for free

Go to Apify Store

Totaljobs Scraper 💰 $1.39/1K — UK’s Largest Job Board

Try for free

Scrape totaljobs.com - UK’s largest job board. Extract salary data, employer contact details, and full job descriptions. Incremental mode detects new and changed listings for AI agents and MCP workflows.

Pricing

from $1.39 / 1,000 results

Rating

5.0

(1)

Developer

Black Falcon Data

Actor stats

Bookmarked

Total users

Monthly active users

16 hours

Issues response

7 days ago

Last modified

Categories

Jobs

Lead generation

Automation

You can access the Totaljobs Scraper 💰 $1.39/1K — UK’s Largest Job Board programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in Integrations settings in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "1.3",
    "x-build-id": "9h0gRCNySuUh8zHId"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/blackfalcondata~totaljobs-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-blackfalcondata-totaljobs-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/blackfalcondata~totaljobs-scraper/runs": {
      "post": {
        "operationId": "runs-sync-blackfalcondata-totaljobs-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/blackfalcondata~totaljobs-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-blackfalcondata-totaljobs-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "startUrls": {
            "title": "🔗 Start URLs",
            "type": "array",
            "description": "Direct Totaljobs search URLs to scrape. If provided, query and location are ignored.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "query": {
            "title": "🔍 Search Term(s)",
            "type": "string",
            "description": "Job search keyword (e.g., 'software-developer', 'data-analyst'). Not required when startUrls is provided."
          },
          "location": {
            "title": "📍 Location",
            "type": "string",
            "description": "Location filter (e.g., 'London', 'Manchester', 'Birmingham')"
          },
          "geo": {
            "title": "Portal",
            "type": "string",
            "description": "Fixed to Totaljobs (UK).",
            "default": "TOTALJOBS"
          },
          "sort": {
            "title": "🔀 Sort By",
            "enum": [
              "relevance",
              "date",
              "salary_low",
              "salary_high"
            ],
            "type": "string",
            "description": "Sort order for results",
            "default": "relevance"
          },
          "age": {
            "title": "Posted Within",
            "minimum": 1,
            "type": "integer",
            "description": "Only show jobs posted within this many days"
          },
          "remote": {
            "title": "🏠 Remote Only",
            "type": "boolean",
            "description": "Only show remote/home office positions"
          },
          "radius": {
            "title": "📡 Radius (km)",
            "enum": [
              "5",
              "10",
              "20",
              "30",
              "40",
              "50",
              "75",
              "100"
            ],
            "type": "string",
            "description": "Search radius around location in km (requires location)"
          },
          "minSalary": {
            "title": "Minimum Salary",
            "minimum": 0,
            "type": "integer",
            "description": "Minimum annual salary filter (GBP)"
          },
          "contractType": {
            "title": "📝 Contract Type",
            "enum": [
              "FULL_TIME",
              "PART_TIME",
              "CONTRACT",
              "TEMPORARY",
              "INTERNSHIP",
              "APPRENTICESHIP",
              "FREELANCE",
              "MINI_JOB",
              "WORKING_STUDENT",
              "VOLUNTEER",
              "THESIS",
              "DUAL_STUDY"
            ],
            "type": "string",
            "description": "Filter by contract/employment type"
          },
          "experience": {
            "title": "Experience Level",
            "enum": [
              "no",
              "required",
              "executive"
            ],
            "type": "string",
            "description": "Filter by experience level"
          },
          "workType": {
            "title": "Work Type",
            "enum": [
              "FULL_TIME",
              "PART_TIME"
            ],
            "type": "string",
            "description": "Filter by work schedule (full-time / part-time)"
          },
          "companyId": {
            "title": "Company ID",
            "minimum": 1,
            "type": "integer",
            "description": "Filter by StepStone company ID (numeric)"
          },
          "language": {
            "title": "🌐 Language",
            "type": "string",
            "description": "Filter by job posting language (e.g., 'en', 'de')"
          },
          "applicationMethod": {
            "title": "Application Method",
            "enum": [
              "INTERNAL",
              "EXTERNAL"
            ],
            "type": "string",
            "description": "Filter by how to apply (e.g., INTERNAL = apply on company site only)"
          },
          "excludeSponsored": {
            "title": "Exclude Sponsored",
            "type": "boolean",
            "description": "Skip sponsored/promoted listings. Filters out items where isSponsored=true.",
            "default": false
          },
          "includeDetails": {
            "title": "📋 Include Full Details",
            "type": "boolean",
            "description": "Fetch each job's detail page for full description, ISO dates, salary, and geo coordinates. Slower but much richer data.",
            "default": true
          },
          "detailEngine": {
            "title": "Detail Page Mode",
            "enum": [
              "auto",
              "cheerio",
              "playwright"
            ],
            "type": "string",
            "description": "Controls how job detail pages are fetched. Auto (recommended) lets the actor choose the best method automatically. Lightweight is faster but may fail on protected portals. Enhanced is heavier but more reliable.",
            "default": "auto"
          },
          "descriptionFormat": {
            "title": "Description Format",
            "enum": [
              "html",
              "text",
              "markdown",
              "original"
            ],
            "type": "string",
            "description": "Format for job description text (requires Include Detail Pages)",
            "default": "html"
          },
          "maxResults": {
            "title": "💯 Max Results",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum number of job listings to return (0 = unlimited)",
            "default": 100
          },
          "maxPages": {
            "title": "📄 Max Pages",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "Maximum number of search result pages to scrape. Automatically raised when Max Results requires more pages, so this is rarely a hard cap.",
            "default": 10
          },
          "mode": {
            "title": "⚙️ Mode",
            "enum": [
              "full",
              "incremental"
            ],
            "type": "string",
            "description": "full = return all jobs found. incremental = only return jobs not seen in previous runs (requires stateStoreName).",
            "default": "full"
          },
          "stateStoreName": {
            "title": "State Store Name",
            "type": "string",
            "description": "KV store name for incremental state. Use same name across scheduled runs. State is scoped per query+location+geo combination.",
            "default": "totaljobs-state"
          },
          "dedupStoreName": {
            "title": "Dedup Store Name",
            "type": "string",
            "description": "Named KV store for cross-run dedup. Same name across runs = only new jobs pushed."
          },
          "dedupKey": {
            "title": "Dedup Key",
            "type": "string",
            "description": "Field used as unique key for dedup (default: jobKey)",
            "default": "jobKey"
          },
          "datasetName": {
            "title": "Dataset Name",
            "type": "string",
            "description": "Custom dataset name. Supports masks: {DATE} = YYYYMMDD, {TIME} = HHMMSS"
          },
          "outputFields": {
            "title": "Output Fields",
            "type": "array",
            "description": "Select subset of output fields. Use dot notation for nested: 'ceSalary.min'. If empty: all fields returned."
          },
          "compact": {
            "title": "📦 Compact Output",
            "type": "boolean",
            "description": "When true, each result contains only the 11 most essential fields: jobKey, title, company, location, url, portalUrl, datePosted, workFromHome, unifiedSalary, geo, and description. Use this in AI-agent and MCP workflows where token budgets matter.",
            "default": false
          },
          "descriptionMaxLength": {
            "title": "✂️ Description Max Length",
            "minimum": 0,
            "maximum": 10000,
            "type": "integer",
            "description": "Truncate the description field to this many characters, appending '...' if truncated. 0 means no truncation. Use in AI-agent workflows to control context window usage. Pairs well with compact mode.",
            "default": 0
          },
          "telegramToken": {
            "title": "🤖 Telegram Bot Token",
            "type": "string",
            "description": "Telegram bot token from @BotFather. Required for Telegram notifications."
          },
          "telegramChatId": {
            "title": "💬 Telegram Chat ID",
            "type": "string",
            "description": "Telegram chat or channel ID where alerts are sent (e.g. \"-100123456789\" for a private group, or \"@yourchannel\")."
          },
          "discordWebhookUrl": {
            "title": "🎮 Discord Webhook URL",
            "type": "string",
            "description": "Discord incoming webhook URL. Get one from Server Settings → Integrations → Webhooks."
          },
          "slackWebhookUrl": {
            "title": "💼 Slack Webhook URL",
            "type": "string",
            "description": "Slack incoming webhook URL. Create at api.slack.com/messaging/webhooks."
          },
          "whatsappPhoneNumberId": {
            "title": "📱 WhatsApp Phone Number ID",
            "type": "string",
            "description": "WhatsApp Business phone number ID from Meta Business Manager (NOT the phone number itself — the numeric ID shown next to your business number). Free service-conversation messages within 24 hours of last user-initiated contact."
          },
          "whatsappAccessToken": {
            "title": "🔐 WhatsApp Access Token",
            "type": "string",
            "description": "Meta Cloud API access token with `whatsapp_business_messaging` scope. Get a permanent token from a system user in Meta Business Manager."
          },
          "whatsappTo": {
            "title": "📨 WhatsApp Recipient",
            "type": "string",
            "description": "Recipient phone in E.164 format (e.g. +447700900123). Recipient must have messaged your business number within the last 24 hours — outside that window, free-form text is rejected by Meta."
          },
          "webhookUrl": {
            "title": "🪝 Generic Webhook URL",
            "type": "string",
            "description": "Generic webhook URL that receives a JSON POST with the full job payload + run metadata. Universal escape hatch for n8n / Make / Zapier / your own backend."
          },
          "webhookHeaders": {
            "title": "🔑 Webhook Headers",
            "type": "object",
            "description": "Optional headers (e.g. {\"Authorization\": \"Bearer xyz\"}) sent with the webhook POST."
          },
          "notificationLimit": {
            "title": "📊 Max Jobs Per Notification",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "Maximum number of jobs included in each notification message (1–20). Excess jobs are still in the dataset; notifications get a summary line.",
            "default": 5
          },
          "notifyOnlyChanges": {
            "title": "🔄 Notify Only New/Updated",
            "type": "boolean",
            "description": "When Incremental Mode is on, only send notifications for NEW / UPDATED / REAPPEARED jobs. Has no effect outside incremental mode.",
            "default": false
          },
          "proxyConfiguration": {
            "title": "🛡️ Proxy Configuration",
            "type": "object",
            "description": "Proxy configuration. Some portals require enhanced proxy (handled automatically). Your Apify plan must include proxy access.",
            "default": {
              "useApifyProxy": true
            }
          },
          "_benchDelayMs": {
            "title": "[Internal] Benchmark Delay (ms)",
            "minimum": 0,
            "type": "integer",
            "description": "Override request delay for benchmarking. Internal use only — not for production."
          },
          "_benchFreshSession": {
            "title": "[Internal] Benchmark Fresh Session",
            "type": "boolean",
            "description": "Override fresh session flag for benchmarking. Internal use only — not for production."
          },
          "excludeEmptyFields": {
            "title": "Exclude empty fields from output",
            "type": "boolean",
            "description": "Drop null, empty-string, and empty-array fields from each record before push. Smaller payloads for AI agents and dashboards.",
            "default": false
          },
          "appConnector": {
            "title": "Send results to Notion (or another connected app)",
            "type": "string",
            "description": "Optional. Pick a connected app under Settings → API & Integrations to receive your results. Notion is supported today (a run-summary page); other MCP connectors are best-effort as Apify expands its catalog."
          },
          "mcpIssueTeam": {
            "title": "Issue tracker team",
            "type": "string",
            "description": "Only when the connected app is an issue tracker: the team (name or ID) the summary issue is created under, if that app requires one."
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Totaljobs Scraper | UK Job Listings & Salary Data OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for Totaljobs Scraper 💰 $1.39/1K — UK’s Largest Job Board from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

Totaljobs Scraper 💰 $1.39/1K — UK’s Largest Job Board API in Python

Totaljobs Scraper 💰 $1.39/1K — UK’s Largest Job Board API in JavaScript

Totaljobs Scraper 💰 $1.39/1K — UK’s Largest Job Board API through CLI

Totaljobs Scraper 💰 $1.39/1K — UK’s Largest Job Board API

Totaljobs UK Job Scraper

janbruinier/jan-totaljobs-scraper

Scrape job listings from Totaljobs.com. Extract job titles, salaries, locations, descriptions, and company info for UK job market analysis.

Jan Bruinier

Totaljobs Job Scraper — Search & Extract UK Job Listings

unfenced-group/totaljobs-scraper

Extract job listings from Totaljobs.com. Search by keyword and location across the UK. Returns structured job data including title, company, salary, location, and publication date. No API key needed.

Unfenced Group

Totaljobs Jobs Scraper (UK)

valig/totaljobs-jobs-scraper

$0.4/1K jobs | Scrape structured job listings from Totaljobs UK with advanced filtering and rich company data.

Vali G

Totaljobs Scraper

lexis-solutions/totaljobs-scraper

The Totaljobs scraper is a web scraping tool that retrieves job postings from Totaljobs, a job search website in the UK.

Lexis Solutions

2.9

Totaljobs Listing Scraper

powerbox/totaljobs-listing-scraper

Scrape job listings from totaljobs.com by providing a search URL, with automatic pagination and comprehensive job data extraction.

PowerBox

TotalJobs Scraper 🎯

easyapi/totaljobs-scraper

Scrape job listings from TotalJobs.com. Extract detailed job information including titles, companies, locations, salaries, and more. Perfect for job market analysis, recruitment research, and tracking employment trends.

EasyApi

Glassdoor Job Scraper - Salary & Reviews

blackfalcondata/glassdoor-job-scraper

Scrape glassdoor.com - the job board known for salary transparency and employer reviews. Verified salary estimates, employer ratings, and 20-market job coverage. Incremental mode detects new and changed listings on recurring runs.

Black Falcon Data

5.0

TotalJobs Scraper

moving_beacon-owner1/totaljobs-scraper

Scrape UK jobs from TotalJobs by keyword and location with filters for salary, contract type, hours, date, and sorting. Optional details include descriptions, skills, benefits, and apply links.

Jamshaid Arif

Totaljobs Jobs Scraper

orgupdate/totaljobs-jobs-scraper

The latest and most advanced Totaljobs Jobs Scraper. Our Totaljobs Jobs Scraper extracts real-time job postings at scale from all over the world. A new research tool built for recruitment, insights and HR.

Orgupdate

Jobat.be Jobs Scraper - Belgium Job Board

blackfalcondata/jobat-scraper

Scrape jobat.be - Belgium’s leading job board with 80K+ listings in Dutch and French. Structured salary, 3 description formats, and employer contact data. Incremental mode detects new and changed listings. Compact output for AI agents and MCP workflows.

Black Falcon Data