{
  "openapi": "3.0.1",
  "info": {
    "title": "Jobsite UK Scraper - Jobs, Salaries & Company Details",
    "description": "Scrape Jobsite.co.uk job listings at scale by keyword, location, filters or URL. Extract 35+ structured fields per job, including titles, salaries and company details. Optional enrichment adds full descriptions, GPS coordinates, employment types and company profiles.",
    "version": "1.0",
    "x-build-id": "hkbGOwph8Cr9bvulD"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/abotapi~jobsite-co-uk-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-abotapi-jobsite-co-uk-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/abotapi~jobsite-co-uk-scraper/runs": {
      "post": {
        "operationId": "runs-sync-abotapi-jobsite-co-uk-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/abotapi~jobsite-co-uk-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-abotapi-jobsite-co-uk-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",
        "required": [
          "mode"
        ],
        "properties": {
          "mode": {
            "title": "Mode",
            "enum": [
              "search",
              "url"
            ],
            "type": "string",
            "description": "How to find jobs: build a search from filters, or paginate URLs you paste.",
            "default": "search"
          },
          "locations": {
            "title": "Locations",
            "type": "array",
            "description": "Towns, cities, counties, or regions (Search mode). Examples: 'London', 'Manchester', 'Greater London', 'EC1'. One search runs per location. Leave empty for all of the UK.",
            "items": {
              "type": "string"
            }
          },
          "keywords": {
            "title": "Keywords",
            "type": "string",
            "description": "Job title, skill, or company to search for. Example: 'nurse', 'java developer', 'project manager'. Leave empty to list all jobs in the location."
          },
          "jobType": {
            "title": "Job type",
            "enum": [
              "any",
              "permanent",
              "contract",
              "temporary",
              "part-time",
              "work-from-home",
              "partTime",
              "workFromHome"
            ],
            "type": "string",
            "description": "Contract / working arrangement filter.",
            "default": "any"
          },
          "companyType": {
            "title": "Advertiser type",
            "enum": [
              "any",
              "employer",
              "agency"
            ],
            "type": "string",
            "description": "Restrict to direct employers or recruitment agencies.",
            "default": "any"
          },
          "advertiserType": {
            "title": "Advertiser type (alias)",
            "enum": [
              "any",
              "employer",
              "agency"
            ],
            "type": "string",
            "description": "Alias of Advertiser type; when set it wins over it."
          },
          "minSalary": {
            "title": "Minimum salary",
            "minimum": 0,
            "type": "integer",
            "description": "Lowest salary to include. Combined with the salary period below. Leave empty for no minimum."
          },
          "salaryType": {
            "title": "Salary period",
            "enum": [
              "annual",
              "daily",
              "hourly"
            ],
            "type": "string",
            "description": "Unit for the minimum salary filter.",
            "default": "annual"
          },
          "salaryPeriod": {
            "title": "Salary period (alias)",
            "enum": [
              "annual",
              "daily",
              "hourly"
            ],
            "type": "string",
            "description": "Alias of Salary period; when set it wins over it."
          },
          "postedWithin": {
            "title": "Posted within (days)",
            "enum": [
              "0",
              "1",
              "3",
              "7",
              "14",
              "any"
            ],
            "type": "string",
            "description": "Only jobs posted within this many days. Leave as Any time for no date filter.",
            "default": "0"
          },
          "postedWithinDays": {
            "title": "Posted within days (alias)",
            "enum": [
              "any",
              "1",
              "3",
              "7",
              "14"
            ],
            "type": "string",
            "description": "Alias of Posted within; when set it wins over it. 'any' means no date filter."
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "relevance",
              "date",
              "salary-desc",
              "salary-asc",
              "distance"
            ],
            "type": "string",
            "description": "Result ordering.",
            "default": "relevance"
          },
          "radiusMiles": {
            "title": "Search radius (miles)",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Widen a location search to jobs within this many miles (0-100). Leave empty for the site default radius. Search mode only."
          },
          "urls": {
            "title": "Search URLs",
            "type": "array",
            "description": "Jobsite.co.uk URLs to scrape (URL mode): result lists (search, keyword, job type, filters, ?page=N, radius, company jobs pages) and single job pages. Filter fields above are ignored. Pagination starts at the page in the URL and walks forward. The pre-filled list holds one example of every supported shape.",
            "default": [
              "https://www.jobsite.co.uk/jobs/in-london",
              "https://www.jobsite.co.uk/jobs/nurse/in-manchester",
              "https://www.jobsite.co.uk/jobs/accountancy",
              "https://www.jobsite.co.uk/jobs/permanent/in-london",
              "https://www.jobsite.co.uk/jobs/nurse/permanent/in-london",
              "https://www.jobsite.co.uk/jobs/in-london?page=2",
              "https://www.jobsite.co.uk/jobs/in-london?salary=30000&salarytypeid=1&postedWithin=7&companytypes=2&sort=2",
              "https://www.jobsite.co.uk/jobs/in-london?radius=10",
              "https://www.jobsite.co.uk/jobs/abbatt-property-recruitment?cmpId=692964&cmp=1",
              "https://www.jobsite.co.uk/job/people-advisor/one-small-thing-job108272685",
              "https://www.jobsite.co.uk/job/108273301",
              "http://jobsite.co.uk/jobs/in-london"
            ],
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Start URLs (alias)",
            "type": "array",
            "description": "Alias of Search URLs: Jobsite.co.uk result-list or single job page URLs. When set, the run switches to URL mode and these URLs are used.",
            "items": {
              "type": "string"
            }
          },
          "fetchDetails": {
            "title": "Fetch full job details",
            "type": "boolean",
            "description": "Open each job page for the full description, geo coordinates, employment type, valid-through date, and company profile (benefits, videos, industries). Adds ~12 fields. Needs an Apify Residential GB proxy and costs more per job. Off = fast, cheap, 35 listing fields.",
            "default": false
          },
          "detailMode": {
            "title": "Detail mode (alias)",
            "enum": [
              "fullDetails",
              "fastListings"
            ],
            "type": "string",
            "description": "fullDetails = fetch every job page (same as Fetch job details on; uses the residential route); fastListings = result-list data only. When set it wins over Fetch job details."
          },
          "includeContactHints": {
            "title": "Include contact hints",
            "type": "boolean",
            "description": "Harvest phone numbers and emails from job pages (with evidence) when details are fetched. Turn off to leave contacts empty.",
            "default": true
          },
          "maxPages": {
            "title": "Max pages per search",
            "minimum": 0,
            "type": "integer",
            "description": "Optional safety limit on pages walked per location/URL (25 jobs per page). Leave at 0 to walk the whole catalogue: the run stops at Max jobs, the site's own last page, or a repeat-page guard, not an artificial page cap.",
            "default": 0
          },
          "maxPagesPerSearch": {
            "title": "Max pages per search (alias)",
            "minimum": 1,
            "type": "integer",
            "description": "Alias of Max pages; when set it wins over it."
          },
          "maxListings": {
            "title": "Max jobs",
            "minimum": 0,
            "type": "integer",
            "description": "Total jobs to collect across all searches. This is the main limit. Set 0 for unlimited (bounded by Max pages).",
            "default": 20
          },
          "maxItems": {
            "title": "Max items (alias)",
            "minimum": 1,
            "type": "integer",
            "description": "Alias of Max listings; when set it wins over it."
          },
          "maxResidentialRequests": {
            "title": "Residential request cap",
            "minimum": 0,
            "type": "integer",
            "description": "Safety cap on how many Residential proxy requests this run may use (detail pages and listing escalation). 0 = unlimited. When the cap is reached, the Residential route is skipped and detail enrichment stops, so a run can never overspend on residential bandwidth.",
            "default": 0
          },
          "proxy": {
            "title": "Proxy",
            "type": "object",
            "description": "Connection settings. Search pages and job details are served to Apify Residential with country GB; datacenter exits are refused by the site and the run moves on to Residential automatically. Residential needs a paid Apify plan."
          },
          "resumeFromRunId": {
            "title": "Resume from a previous run (delta)",
            "type": "string",
            "description": "Optional. ID of a previous run of this actor (or a dataset ID). Jobs already in that dataset are skipped, so this run returns only NEW jobs (a delta). Combine both runs' datasets for the full set. Max jobs then counts only the new jobs. For a search you run repeatedly on a schedule, prefer Incremental mode below instead — it remembers state between runs automatically, no id to paste."
          },
          "incrementalMode": {
            "title": "Incremental mode (recurring runs)",
            "type": "boolean",
            "description": "Turn ON for a search you run repeatedly (e.g. on a daily schedule) to get only NEW and CHANGED jobs each run, instead of the whole list again. The actor remembers what it saw last time — keyed by State key below, or automatically by your search filters if left blank — and skips jobs that are unchanged. Different from Resume above: Resume finishes ONE interrupted/previous run by id; Incremental mode tracks the SAME recurring search automatically, run after run, with no id needed.",
            "default": false
          },
          "stateKey": {
            "title": "State key (Incremental mode)",
            "type": "string",
            "description": "Optional label for Incremental mode's remembered state. Leave empty to derive it automatically from your search filters (mode/locations/keywords/jobType/companyType/minSalary/salaryType/postedWithin/sortBy/urls/fetchDetails) — every run with the exact same filters then shares one baseline. Set a label when you want two schedules over the same filters to track independently, or to keep the baseline stable across a filter tweak. Ignored unless Incremental mode is on."
          },
          "emitUnchanged": {
            "title": "Include unchanged jobs (Incremental mode)",
            "type": "boolean",
            "description": "Incremental mode only. Include jobs that have not changed since the last run (changeType: UNCHANGED) in the output. Off by default — a recurring run normally returns only NEW/UPDATED jobs, which is both cheaper and easier to consume.",
            "default": false
          },
          "emitExpired": {
            "title": "Emit expired jobs (Incremental mode)",
            "type": "boolean",
            "description": "Incremental mode only. When this run reaches a natural, uncapped end for every search (no Max jobs/Max pages truncation, and not a Resume run), emit one row per job seen in a previous run but not found in this one (changeType: EXPIRED — e.g. no longer listed). Skipped automatically on a capped or resumed run, since those cannot prove a job is really gone rather than just not reached yet. Off by default.",
            "default": false
          },
          "ignoreFieldsForChanges": {
            "title": "Ignore fields when detecting changes (incremental mode only)",
            "type": "array",
            "description": "Incremental mode only. Field names (for example salary or company; use a dotted name such as location.region for a nested value) that must not count as a change. A job whose only difference is in these fields stays UNCHANGED instead of UPDATED, and they are left out of changedFields. The fields still appear in the output. Rolling-time and search-relative fields are already ignored automatically. Changing this list never re-bills the stored baseline. Ignored unless Incremental mode is on.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "mcpConnectors": {
            "title": "Pipe results into your apps (optional)",
            "type": "array",
            "description": "Optionally send the scraped results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize a connector once under Apify → Settings → Integrations, then select it here. The connector receives a condensed, human-readable summary per item (title + key fields), not the full JSON — the complete record stays in the dataset. Leave empty to skip. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com)."
          },
          "notionParentPageUrl": {
            "title": "Notion parent page (Notion connector only)",
            "type": "string",
            "description": "URL (or id) of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors."
          },
          "maxNotifyListings": {
            "title": "Max items to export per connector",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Cap on items written to each connector per run. Does not affect the dataset.",
            "default": 50
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}