{
  "openapi": "3.0.1",
  "info": {
    "title": "Totaljobs Jobs Scraper | UK Job Listings and Salaries",
    "description": "Totaljobs scraper for UK job listings: 30 jobs in 38 seconds, 35 fields each. Search by keyword and UK town or paste totaljobs.com links. Get the full ad, salary as min and max, remote or hybrid, contract type, closing date, coordinates, employer profile and recruiter email or phone. No login.",
    "version": "1.0",
    "x-build-id": "q74LpGNSXPQePgcou"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/silentflow~totaljobs-jobs-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-silentflow-totaljobs-jobs-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/silentflow~totaljobs-jobs-scraper/runs": {
      "post": {
        "operationId": "runs-sync-silentflow-totaljobs-jobs-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/silentflow~totaljobs-jobs-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-silentflow-totaljobs-jobs-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": {
          "searchQueries": {
            "title": "🔎 Keywords",
            "type": "array",
            "description": "Job titles, skills or company names, one per line, searched the way the Totaljobs search box does. Each keyword is its own search, and the jobs found twice are delivered once.<br><br>Examples: <code>software engineer</code>, <code>nurse</code>, <code>project manager</code>, <code>c++ developer</code>. A common keyword in London returns several hundred jobs.",
            "items": {
              "type": "string"
            }
          },
          "location": {
            "title": "📍 Location",
            "type": "string",
            "description": "A UK town, city, county or region, applied to every keyword. Examples: <code>London</code>, <code>Manchester</code>, <code>Milton Keynes</code>, <code>West Yorkshire</code>. Leave it empty to search the whole of the UK."
          },
          "startUrls": {
            "title": "🔗 Totaljobs links",
            "type": "array",
            "description": "Paste links straight from totaljobs.com, as many as you like:<ul><li><b>Search result pages</b>, with every filter you set on the site, e.g. <code>https://www.totaljobs.com/jobs/nurse/in-leeds?radius=20&postedWithin=3</code>. They keep their own filters.</li><li><b>Job pages</b>, e.g. <code>https://www.totaljobs.com/job/data-scientist-generative-ai/experis-job108313380</code>. A job ID works as <code>https://www.totaljobs.com/job/108313380</code>.</li></ul>Every job page you paste is delivered, whatever the max jobs value.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "maxItems": {
            "title": "🔢 Max jobs",
            "minimum": 1,
            "type": "integer",
            "description": "The most jobs to collect from the keyword searches and the search links, shared between them. Job pages you paste are always delivered on top. Set it to what you need: each job is one row.",
            "default": 30
          },
          "radius": {
            "title": "📏 Radius",
            "enum": [
              "0",
              "5",
              "10",
              "20",
              "30",
              "50"
            ],
            "type": "string",
            "description": "How far around the location to search, in miles. Totaljobs searches 10 miles by default.",
            "default": "10"
          },
          "postedWithin": {
            "title": "📅 Posted within",
            "enum": [
              "any",
              "1",
              "3",
              "7",
              "14"
            ],
            "type": "string",
            "description": "Only jobs posted recently. Use <code>Last 24 hours</code> for a daily feed of new jobs.",
            "default": "any"
          },
          "jobType": {
            "title": "💼 Job type",
            "enum": [
              "any",
              "permanent",
              "contract",
              "temporary",
              "part-time",
              "work-from-home"
            ],
            "type": "string",
            "description": "Only one kind of job: permanent, contract, temporary, part time, or work from home.",
            "default": "any"
          },
          "companyType": {
            "title": "🏢 Employer type",
            "enum": [
              "any",
              "direct",
              "agency"
            ],
            "type": "string",
            "description": "Only jobs posted by the hiring company itself, or only jobs posted by recruitment agencies.",
            "default": "any"
          },
          "minSalary": {
            "title": "💷 Minimum salary",
            "minimum": 0,
            "type": "integer",
            "description": "Only jobs whose yearly salary reaches at least this amount, in pounds, e.g. <code>40000</code>. Totaljobs compares it with the top of the advertised range, so a <code>£35,000 - £45,000</code> job is kept, and a few ads that show \"Competitive\" can still come back: the <code>salaryMin</code> and <code>salaryMax</code> columns let you filter further. For day or hourly rates, set the filter on totaljobs.com and paste the search link."
          },
          "sort": {
            "title": "↕️ Sort by",
            "enum": [
              "relevance",
              "date",
              "salary_high",
              "salary_low",
              "distance"
            ],
            "type": "string",
            "description": "The order of the results. <code>Newest first</code> together with a small max jobs value gives the latest jobs only.",
            "default": "relevance"
          }
        }
      },
      "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}