{ "openapi": "3.0.1", "info": { "title": "Teaching Jobs Scraper (TES) - UK & International School Jobs", "description": "Scrape teaching, school and education jobs from TES (tes.com/jobs), the UK and international teaching jobs board. Every job with salary, contract, closing date, requirements, how to apply and school details. Schedule it as a job alert: repeat runs return only new jobs.", "version": "0.1", "x-build-id": "f9n9R6uIQHG0imedq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/vivid-softwares~tes-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-vivid-softwares-tes-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/vivid-softwares~tes-jobs-scraper/runs": { "post": { "operationId": "runs-sync-vivid-softwares-tes-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/vivid-softwares~tes-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-vivid-softwares-tes-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": { "startUrls": { "title": "Tes Jobs search, job or school URLs", "type": "array", "description": "The easiest way to use this Actor: search on tes.com/jobs with any filters, then paste the results URL here. Every matching job is collected, not just the first page. Also works with browse pages (tes.com/jobs/browse/london), single job pages and school profiles (tes.com/jobs/employer/…) for all of a school’s jobs. Leave empty to use the search builder below.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "keywords": { "title": "Keywords", "type": "string", "description": "Optional search builder, used instead of or as well as URLs. Job title or keyword, for example \"maths teacher\", \"SENCO\" or \"headteacher\". The builder runs when any of its fields is filled in." }, "locations": { "title": "Locations", "type": "array", "description": "Towns, counties, postcodes, countries or \"International\", typed as you would on Tes (for example \"Manchester\", \"Kent\", \"SW1A 1AA\", \"Wales\", \"United Arab Emirates\", \"International\"). Each location is searched separately. Leave empty for all UK and international jobs.", "items": { "type": "string" } }, "radius": { "title": "Search radius", "enum": [ "3", "5", "10", "15", "20", "30", "50", "70", "100", "500" ], "type": "string", "description": "Distance around each location, as in Tes’s own Distance box.", "default": "30" }, "positions": { "title": "Position (role)", "type": "array", "description": "Tes positions. Pick a group such as \"Leadership (all)\" or single roles such as Teacher or Headteacher.", "items": { "type": "string", "enum": [ "Teaching and Lecturing", "Teacher", "Teaching Assistant", "Head of Department", "Tutor", "Special educational needs and disabilities coordinator (SENDCo)", "Early Years Practitioner", "Lecturer", "Coach", "Manager", "Subject Leader", "Instructor", "Assistant Head of Department", "Trainer/Assessor/Verifier", "Curriculum Coordinator", "Head of Year", "Student Teacher", "Principal Teacher", "Second in Charge", "Athletics/Sports Director", "Advanced Skills Teacher", "Graduate Teaching Programme", "Head Coach", "Assistant Curriculum Coordinator", "Research/Fellowship Post", "DP Coordinator", "Assistant Coach", "Dean of Students", "Deputy Head of Year", "Extended Essay Coordinator", "Long Term Substitute", "Native Language Coordinator", "PYP Coordinator", "Non-Teaching/Support", "Learning Support", "Other Support Positions", "Administrator", "Other Pastoral/Welfare Positions", "Technician", "Other Facilities Positions", "Cleaner", "Exam Invigilator", "Other Office and Administrative Positions", "Examiner", "Learning Manager/Mentor", "Cover Supervisor", "Behaviour Manager/Specialist", "Canteen Supervisor/Tuckshop Convenor", "Caretaker/Groundsperson", "School Counsellor", "Specialist", "Driver", "Safeguarding Officer", "Financial Officer", "Housemaster/Housemistress/Boarding Supervisor", "Personal Assistant", "Speech and Language Therapist", "Human Resources", "Secretary/Receptionist", "Exams Officer", "Midday supervisor", "Occupational Therapist", "Admissions Officer", "Librarian", "Premises Manager/Housekeeper", "School Nurse", "Business Manager", "Careers Advisor", "Human Resources Manager", "Facilities Manager", "Head of Pastoral Care", "Admissions Manager", "College Counsellor", "Data Manager", "Advisor/Consultant", "Human Resources Officer", "School Support Officer", "Accountant", "Office Manager", "Support Manager", "Technology Coordinator", "Clerk to Governors", "Communications Officer", "Educational/School Psychologist", "Network Administrator", "Chaplain/Priest", "Healthcare Worker", "Literacy Worker", "Aquatics Director", "Bursar", "Data Services/Timetabling", "Network Manager", "Quality Assurance Officer", "Bookkeeper", "Summer Programs Director", "Transportation Manager", "Leadership", "Deputy Headteacher", "Headteacher", "Leadership/Excellence Teacher", "Curriculum Lead", "Principal", "Vice Principal", "Marketing Manager", "Director of Studies", "Assistant Director", "IT Manager", "Chief Financial Officer (CFO)", "Director of Activities", "Director of Student Support Services", "Director of Marketing/Communications", "Chief Operations Officer (COO)", "Director of Development", "Chief Executive Officer (CEO)", "Assistant Headteacher", "Director of Admissions", "Associate Dean of Academics/Studies", "Director of Alumni Relations", "Director of IT", "Executive Director" ], "enumTitles": [ "Teaching and Lecturing (all)", "Teaching and Lecturing: Teacher", "Teaching and Lecturing: Teaching Assistant", "Teaching and Lecturing: Head of Department", "Teaching and Lecturing: Tutor", "Teaching and Lecturing: Special educational needs and disabilities coordinator (SENDCo)", "Teaching and Lecturing: Early Years Practitioner", "Teaching and Lecturing: Lecturer", "Teaching and Lecturing: Coach", "Teaching and Lecturing: Manager", "Teaching and Lecturing: Subject Leader", "Teaching and Lecturing: Instructor", "Teaching and Lecturing: Assistant Head of Department", "Teaching and Lecturing: Trainer/Assessor/Verifier", "Teaching and Lecturing: Curriculum Coordinator", "Teaching and Lecturing: Head of Year", "Teaching and Lecturing: Student Teacher", "Teaching and Lecturing: Principal Teacher", "Teaching and Lecturing: Second in Charge", "Teaching and Lecturing: Athletics/Sports Director", "Teaching and Lecturing: Advanced Skills Teacher", "Teaching and Lecturing: Graduate Teaching Programme", "Teaching and Lecturing: Head Coach", "Teaching and Lecturing: Assistant Curriculum Coordinator", "Teaching and Lecturing: Research/Fellowship Post", "Teaching and Lecturing: DP Coordinator", "Teaching and Lecturing: Assistant Coach", "Teaching and Lecturing: Dean of Students", "Teaching and Lecturing: Deputy Head of Year", "Teaching and Lecturing: Extended Essay Coordinator", "Teaching and Lecturing: Long Term Substitute", "Teaching and Lecturing: Native Language Coordinator", "Teaching and Lecturing: PYP Coordinator", "Non-Teaching/Support (all)", "Non-Teaching/Support: Learning Support", "Non-Teaching/Support: Other Support Positions", "Non-Teaching/Support: Administrator", "Non-Teaching/Support: Other Pastoral/Welfare Positions", "Non-Teaching/Support: Technician", "Non-Teaching/Support: Other Facilities Positions", "Non-Teaching/Support: Cleaner", "Non-Teaching/Support: Exam Invigilator", "Non-Teaching/Support: Other Office and Administrative Positions", "Non-Teaching/Support: Examiner", "Non-Teaching/Support: Learning Manager/Mentor", "Non-Teaching/Support: Cover Supervisor", "Non-Teaching/Support: Behaviour Manager/Specialist", "Non-Teaching/Support: Canteen Supervisor/Tuckshop Convenor", "Non-Teaching/Support: Caretaker/Groundsperson", "Non-Teaching/Support: School Counsellor", "Non-Teaching/Support: Specialist", "Non-Teaching/Support: Driver", "Non-Teaching/Support: Safeguarding Officer", "Non-Teaching/Support: Financial Officer", "Non-Teaching/Support: Housemaster/Housemistress/Boarding Supervisor", "Non-Teaching/Support: Personal Assistant", "Non-Teaching/Support: Speech and Language Therapist", "Non-Teaching/Support: Human Resources", "Non-Teaching/Support: Secretary/Receptionist", "Non-Teaching/Support: Exams Officer", "Non-Teaching/Support: Midday supervisor", "Non-Teaching/Support: Occupational Therapist", "Non-Teaching/Support: Admissions Officer", "Non-Teaching/Support: Librarian", "Non-Teaching/Support: Premises Manager/Housekeeper", "Non-Teaching/Support: School Nurse", "Non-Teaching/Support: Business Manager", "Non-Teaching/Support: Careers Advisor", "Non-Teaching/Support: Human Resources Manager", "Non-Teaching/Support: Facilities Manager", "Non-Teaching/Support: Head of Pastoral Care", "Non-Teaching/Support: Admissions Manager", "Non-Teaching/Support: College Counsellor", "Non-Teaching/Support: Data Manager", "Non-Teaching/Support: Advisor/Consultant", "Non-Teaching/Support: Human Resources Officer", "Non-Teaching/Support: School Support Officer", "Non-Teaching/Support: Accountant", "Non-Teaching/Support: Office Manager", "Non-Teaching/Support: Support Manager", "Non-Teaching/Support: Technology Coordinator", "Non-Teaching/Support: Clerk to Governors", "Non-Teaching/Support: Communications Officer", "Non-Teaching/Support: Educational/School Psychologist", "Non-Teaching/Support: Network Administrator", "Non-Teaching/Support: Chaplain/Priest", "Non-Teaching/Support: Healthcare Worker", "Non-Teaching/Support: Literacy Worker", "Non-Teaching/Support: Aquatics Director", "Non-Teaching/Support: Bursar", "Non-Teaching/Support: Data Services/Timetabling", "Non-Teaching/Support: Network Manager", "Non-Teaching/Support: Quality Assurance Officer", "Non-Teaching/Support: Bookkeeper", "Non-Teaching/Support: Summer Programs Director", "Non-Teaching/Support: Transportation Manager", "Leadership (all)", "Leadership: Deputy Headteacher", "Leadership: Headteacher", "Leadership: Leadership/Excellence Teacher", "Leadership: Curriculum Lead", "Leadership: Principal", "Leadership: Vice Principal", "Leadership: Marketing Manager", "Leadership: Director of Studies", "Leadership: Assistant Director", "Leadership: IT Manager", "Leadership: Chief Financial Officer (CFO)", "Leadership: Director of Activities", "Leadership: Director of Student Support Services", "Leadership: Director of Marketing/Communications", "Leadership: Chief Operations Officer (COO)", "Leadership: Director of Development", "Leadership: Chief Executive Officer (CEO)", "Leadership: Assistant Headteacher", "Leadership: Director of Admissions", "Leadership: Associate Dean of Academics/Studies", "Leadership: Director of Alumni Relations", "Leadership: Director of IT", "Leadership: Executive Director" ] } }, "subjects": { "title": "Subject", "type": "array", "description": "Tes subjects.", "items": { "type": "string", "enum": [ "Art and Design", "Biology", "Business Studies", "Business Studies and Economics", "Careers", "Chemistry", "Citizenship", "Classics", "Computer Science", "Computing", "Design and Technology", "Design, engineering and technology", "Drama", "Early learning/Early childhood/Childcare", "Education", "English", "English as a Foreign Language", "Food Technology/Hospitality and Catering", "Generalist", "Geography", "History", "Humanities", "Law", "Learning Support", "Mathematics", "Media Studies", "Modern Languages", "Music", "Other Subjects", "Performing Arts", "Philosophy", "Physical Education", "Physics", "Politics", "Primary Education", "Psychology", "Religious Education", "Science", "Social Sciences", "Sociology", "Spanish Literature", "Special Needs", "Vocational Studies" ] } }, "workplaces": { "title": "Organisation type / phase", "type": "array", "description": "School phase and type as Tes files them: Primary, Secondary, Special Education, Independent Senior, Further Education, Nursery and more.", "items": { "type": "string", "enum": [ "Secondary", "Primary", "Special Education", "Independent Senior", "Middle", "Independent Preparatory", "Further Education", "Independent Pre-Prep", "Nursery", "Higher Education", "Prep to Year 12/K-12/All through", "Early Years", "Other Organisation", "Alternative Provision", "Charity", "Pupil Referral Unit (PRU)", "Library", "Local Authority", "Catholic School", "Educational Body", "Outdoor Education", "Adult Education", "Children's Services", "Youth and Community Services", "Summer School" ] } }, "contractTerms": { "title": "Contract term", "type": "array", "description": "Permanent, fixed term, maternity cover and so on.", "items": { "type": "string", "enum": [ "Permanent", "Fixed Term", "Maternity Cover", "Temporary", "Casual", "Supply" ] } }, "contractTypes": { "title": "Full or part time", "type": "array", "description": "Working pattern.", "items": { "type": "string", "enum": [ "Full Time", "Part Time" ] } }, "minSalary": { "title": "Minimum salary", "minimum": 1, "maximum": 999999999, "type": "integer", "description": "Only jobs whose Tes salary range reaches at least this amount (Tes’s own salary filter). Jobs that only give a pay scale such as MPS/UPS are left out by Tes when this is set." }, "salaryCurrency": { "title": "Salary currency", "enum": [ "", "GBP", "EUR", "USD", "AUD", "CHF", "AED", "CAD", "CNY", "HKD", "JPY", "KRW", "KWD", "MYR", "NZD", "OMR", "QAR", "SAR", "SGD", "THB", "VND", "ZAR" ], "type": "string", "description": "Currency of the minimum salary (used only with Minimum salary).", "default": "" }, "salaryFrequency": { "title": "Salary period", "enum": [ "", "year", "month", "week", "day", "hour", "pro rata" ], "type": "string", "description": "Period of the minimum salary (used only with Minimum salary).", "default": "" }, "ectSuitable": { "title": "Suitable for ECTs only", "type": "boolean", "description": "Only jobs marked suitable for early career teachers (NQTs/ECTs).", "default": false }, "quickApplyOnly": { "title": "Quick apply only", "type": "boolean", "description": "Only jobs with Tes Quick apply.", "default": false }, "sort": { "title": "Sort order", "enum": [ "relevance", "date", "distance" ], "type": "string", "description": "Order of results.", "default": "relevance" }, "maxItems": { "title": "Maximum jobs", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop after saving this many jobs. Each saved job is one billable result.", "default": 100 }, "includeSchoolProfile": { "title": "Add school profile details", "type": "boolean", "description": "Reads each school’s Tes profile once per run for pupil numbers, phase, type, funding, gender, age range, religious character, DfE number, phone, awards, photos, documents and inspection report.", "default": true }, "includeApplicationContacts": { "title": "Include job contact details", "type": "boolean", "description": "The recruitment email and phone Tes shows publicly under \"Job contact details\". Some schools list a named member of staff here. Turn off to leave them out.", "default": true }, "includeDescriptionHtml": { "title": "Include description HTML", "type": "boolean", "description": "Also return the job description as HTML. The plain-text description is always included.", "default": false }, "includeDuplicates": { "title": "Include jobs from previous runs", "type": "boolean", "description": "Off by default: jobs you already received in an earlier run are skipped and not charged, so scheduled runs only return new jobs. Turn on to get every matching job again.", "default": false }, "reportExpired": { "title": "Report expired and removed jobs", "type": "boolean", "description": "Remembers every job each search returns. On the next run of the same search, jobs that have gone are saved to the EXPIRED_JOBS record with the reason: closed (deadline passed), advert ended, removed from Tes, or no longer matching. Free. Works when the whole search is read, so set Maximum jobs above the search size.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Not needed: the Actor connects directly and moves to Apify Proxy by itself if Tes starts refusing requests.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }