{ "openapi": "3.0.1", "info": { "title": "JobServe Jobs Scraper - No Login Required", "description": "Actively Maintained - Jobs Scraper to extract job listings using keywords and filters from jobserve.com, gathering all details for each role. Works for all countries. Export results for analysis, connect via API or Python & integrate with other apps. Save hours searching. Unofficial JobServe API.", "version": "0.3", "x-build-id": "2AAmCYuZmZ0hFUHxk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fetchclub~jobserve-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fetchclub-jobserve-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/fetchclub~jobserve-jobs-scraper/runs": { "post": { "operationId": "runs-sync-fetchclub-jobserve-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/fetchclub~jobserve-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-fetchclub-jobserve-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": { "search_results_url": { "title": "Search Results URL (works independently of the other search fields below)", "type": "string", "description": "Paste a full JobServe or CareerBoard search-results URL (JobSearch.aspx?shid=... or JobListing.aspx?shid=...). The site is detected automatically. Use a fresh URL; expired searches may be unavailable." }, "keywords": { "title": "Keywords (makes a seperate search if a URL is also provided. The results are combined.)", "type": "string", "description": "Optional when a search-results URL is provided. Otherwise enter keywords, a location, or both." }, "max_results": { "title": "Max Results", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Select the number of maximum results to scrape.", "default": 10 }, "location": { "title": "Location(s)", "type": "string", "description": "Enter a location within the selected website country. For ambiguous London searches, the first matching location is used and logged; specify a state or county, for example London, OH, or a ZIP/postal code to choose another. Leave empty to search the whole website country. Ignored when a search-results URL is provided." }, "distance": { "title": "Distance", "enum": [ "Within 1 mile", "Within 5 miles", "Within 10 miles", "Within 15 miles", "Within 25 miles", "Within 50 miles", "Within 75 miles", "Within 100 miles" ], "type": "string", "description": "Search radius around the location, for example Within 25 miles. Ignored when the location is empty.", "default": "Within 50 miles" }, "remote_working": { "title": "Remote Working", "type": "boolean", "description": "Only jobs that allow remote working.", "default": false }, "industries": { "title": "Industries", "type": "array", "description": "Limit to one or more industries, for example IT or Finance. Select All (default) means no filter.", "items": { "type": "string", "enum": [ "Select All", "Advertising Media & Entertainment", "Agriculture, Forestry & Fishing", "Call Centre & Customer Services", "Community & Sport", "Construction & Civil Engineering", "Consulting & Corporate Strategy", "Defence, Military & Armed Forces", "Education", "Engineering", "Finance, Accounting & Banking", "Food & Hospitality", "Healthcare & Medical", "HR & Recruitment", "IT & Telecommunications", "Legal", "Manufacturing", "Mining, Energy, Oil & Gas", "Office & Administration", "Other", "Real Estate & Property", "Retail & Consumer Products", "Sales & Marketing", "Science, Biotech & Pharmaceuticals", "Self Employment", "Trades & Services", "Transport & Logistics", "Travel & Tourism" ] }, "default": [ "Select All" ] }, "date_posted": { "title": "Date Posted", "enum": [ "Today", "Within 1 day", "Within 2 days", "Within 3 days", "Within 4 days", "Within 5 days", "Within 6 days", "Within 7 days" ], "type": "string", "description": "Only jobs posted within this period, for example Within 3 days. Default: Within 7 days.", "default": "Within 7 days" }, "job_type": { "title": "Job Type", "enum": [ "Any", "Permanent", "Contract", "Contract/Permanent", "Part Time/Temporary/Seasonal", "Full Time", "Contract/Full Time" ], "type": "string", "description": "Select a job type. CareerBoard uses Full Time and Contract/Full Time for the equivalent Permanent and Contract/Permanent options.", "default": "Any" }, "job_title": { "title": "Job Title", "type": "string", "description": "JobServe only: a separate job title filter. For CareerBoard, include the title in Keywords.", "default": "" }, "salary_rate": { "title": "Salary/Rate", "type": "array", "description": "Choose salary/rate labels matching the selected website country (GBP for UK, USD for USA). For other currencies, use a search-results URL.", "items": { "type": "string", "enum": [ "Select All", "Below £15K / year", "£15K - £20K / year", "£20K - £25K / year", "£25K - £30K / year", "£30K - £40K / year", "£40K - £50K / year", "£50K - £75K / year", "£75K - £100K / year", "Above £100K / year", "Below £10 / hour", "£10 - £20 / hour", "£20 - £30 / hour", "£30 - £40 / hour", "£40 - £50 / hour", "£50 - £65 / hour", "£65 - £80 / hour", "£80 - £100 / hour", "Above £100 / hour", "Not stated on job", "Below $22000 / year", "$22000 - $30000 / year", "$30000 - $37000 / year", "$37000 - $45000 / year", "$45000 - $60000 / year", "$60000 - $75000 / year", "$75000 - $112000 / year", "$112000 - $150000 / year", "Above $150000 / year", "Below $15 / hour", "$15 - $30 / hour", "$30 - $45 / hour", "$45 - $60 / hour", "$60 - $75 / hour", "$75 - $100 / hour", "$100 - $120 / hour", "$120 - $150 / hour", "Above $150 / hour" ] }, "default": [ "Select All" ] }, "visa_eligibility": { "title": "Visa Eligibility", "type": "array", "description": "Limit by visa sponsorship / eligibility as shown on the site. Any (default) means no filter.", "items": { "type": "string", "enum": [ "Any", "Visa considered", "Sponsorship offered" ] }, "default": [ "Any" ] }, "category": { "title": "Category", "type": "array", "description": "Limit to special job categories shown on the site (for example graduate or apprenticeship roles). Any (default) means no filter.", "items": { "type": "string", "enum": [ "Any", "Bilingual", "Executive", "Graduate", "Public Sector" ] }, "default": [ "Any" ] }, "advertised_by": { "title": "Advertised By", "enum": [ "Any Advertiser", "Agency", "Company" ], "type": "string", "description": "Select - Any Advertiser, Recruiter/Agency, Direct Employer", "default": "Any Advertiser" }, "website": { "title": "Website", "enum": [ "JobServe", "CareerBoard" ], "type": "string", "description": "Defaults to JobServe. This scraper also works with JobServe; select JobServe here when no search-results URL is provided.", "default": "JobServe" }, "website_country": { "title": "Website Country", "enum": [ "Afghanistan", "Albania", "Algeria", "American Samoa", "Andorra", "Angola", "Anguilla", "Antigua and Barbuda", "Argentina", "Armenia", "Aruba", "Australia", "Austria", "Azerbaijan", "Bahamas", "Bahrain", "Bangladesh", "Barbados", "Belarus", "Belgium", "Belize", "Benin", "Bermuda", "Bhutan", "Bolivia", "Bosnia and Herzegovina", "Botswana", "Brazil", "British Indian Ocean Territory", "British Virgin Islands", "Brunei", "Bulgaria", "Burkina Faso", "Burundi", "Cambodia", "Cameroon", "Canada", "Cape Verde", "Cayman Islands", "Central African Republic", "Chad", "Chile", "China", "Christmas Island", "Cocos (Keeling) Islands", "Colombia", "Comoros", "Congo", "Congo, Democratic Republic of", "Cook Islands", "Costa Rica", "Cote dIvoire", "Croatia", "Cuba", "Cyprus", "Czech Republic", "Denmark", "Djibouti", "Dominica", "Dominican Republic", "East Timor", "Ecuador", "Egypt", "El Salvador", "Equatorial Guinea", "Eritrea", "Estonia", "Eswatini", "Ethiopia", "Falkland Islands", "Faroe Islands", "Fiji", "Finland", "France", "French Guiana", "French Polynesia", "Gabon", "Gambia", "Georgia", "Germany", "Ghana", "Gibraltar", "Greece", "Greenland", "Grenada", "Guadeloupe", "Guam", "Guatemala", "Guernsey", "Guinea", "Guinea-Bissau", "Guyana", "Haiti", "Honduras", "Hong Kong", "Hungary", "Iceland", "India", "Indonesia", "Iran", "Iraq", "Ireland", "Isle of Man", "Israel", "Italy", "Jamaica", "Japan", "Jersey", "Jordan", "Kazakhstan", "Kenya", "Kiribati", "Korea", "Kuwait", "Kyrgyzstan", "Laos", "Latvia", "Lebanon", "Lesotho", "Liberia", "Libya", "Liechtenstein", "Lithuania", "Luxembourg", "Macao", "Madagascar", "Malawi", "Malaysia", "Maldives", "Mali", "Malta", "Marshall Islands", "Martinique", "Mauritania", "Mauritius", "Mayotte", "Mexico", "Micronesia", "Midway Islands", "Moldova", "Monaco", "Mongolia", "Montenegro", "Montserrat", "Morocco", "Mozambique", "Myanmar", "Namibia", "Nauru", "Nepal", "Netherlands", "Netherlands Antilles", "New Caledonia", "New Zealand", "Nicaragua", "Niger", "Nigeria", "Niue", "Norfolk Island", "Northern Mariana Islands", "Norway", "Oman", "Pakistan", "Palau", "Palestine Territory", "Panama", "Papua New Guinea", "Paraguay", "Peru", "Philippines", "Poland", "Portugal", "Puerto Rico", "Qatar", "Republic of Korea", "Republic of North Macedonia", "Reunion", "Romania", "Russia", "Rwanda", "Saint Kitts and Nevis", "Samoa", "San Marino", "Sao Tome and Principe", "Saudi Arabia", "Senegal", "Serbia", "Seychelles", "Sierra Leone", "Singapore", "Slovakia", "Slovenia", "Solomon Islands", "Somalia", "South Africa", "Spain", "Sri Lanka", "St Lucia", "St Vincent and the Grenadines", "Sudan", "Suriname", "Sweden", "Switzerland", "Syria", "Taiwan", "Tajikistan", "Tanzania", "Thailand", "Togo", "Tokelau", "Tonga", "Trinidad and Tobago", "Tunisia", "Turkey", "Turkmenistan", "Turks And Caicos Islands", "Tuvalu", "US Minor Outlying Islands", "Uganda", "Ukraine", "United Arab Emirates", "United Kingdom", "United States of America", "Uruguay", "Uzbekistan", "Vanuatu", "Venezuela", "Vietnam", "Virgin Islands US", "Wallis And Futuna Islands", "Western Sahara", "Yemen", "Zambia", "Zimbabwe" ], "type": "string", "description": "Website country to search. Defaults to United Kingdom. Ignored when using a search-results URL.", "default": "United Kingdom" }, "search_countries": { "title": "Additional Countries to Include in the Search", "type": "array", "description": "JobServe only: select additional regions or countries. Leave empty for JobServe. Ignored when using a search-results URL.", "items": { "type": "string", "enum": [ "Region - Asia-Pacific", "Region - Australasia", "Region - Benelux", "Region - EMEA", "Region - European Union", "Region - Middle East", "Region - Scandinavia", "Continent - Africa", "Continent - Australia and Oceania", "Continent - Europe", "Continent - Middle East and Asia", "Continent - Misc", "Continent - North America and Caribbean", "Continent - South America", "Afghanistan", "Albania", "Algeria", "American Samoa", "Andorra", "Angola", "Anguilla", "Antigua and Barbuda", "Argentina", "Armenia", "Aruba", "Australia", "Austria", "Azerbaijan", "Bahamas", "Bahrain", "Bangladesh", "Barbados", "Belarus", "Belgium", "Belize", "Benin", "Bermuda", "Bhutan", "Bolivia", "Bosnia and Herzegovina", "Botswana", "Brazil", "British Indian Ocean Territory", "British Virgin Islands", "Brunei", "Bulgaria", "Burkina Faso", "Burundi", "Cambodia", "Cameroon", "Canada", "Cape Verde", "Cayman Islands", "Central African Republic", "Chad", "Chile", "China", "Christmas Island", "Cocos (Keeling) Islands", "Colombia", "Comoros", "Congo", "Congo, Democratic Republic of", "Cook Islands", "Costa Rica", "Cote dIvoire", "Croatia", "Cuba", "Cyprus", "Czech Republic", "Denmark", "Djibouti", "Dominica", "Dominican Republic", "East Timor", "Ecuador", "Egypt", "El Salvador", "Equatorial Guinea", "Eritrea", "Estonia", "Eswatini", "Ethiopia", "Falkland Islands", "Faroe Islands", "Fiji", "Finland", "France", "French Guiana", "French Polynesia", "Gabon", "Gambia", "Georgia", "Germany", "Ghana", "Gibraltar", "Greece", "Greenland", "Grenada", "Guadeloupe", "Guam", "Guatemala", "Guernsey", "Guinea", "Guinea-Bissau", "Guyana", "Haiti", "Honduras", "Hong Kong", "Hungary", "Iceland", "India", "Indonesia", "Iran", "Iraq", "Ireland", "Isle of Man", "Israel", "Italy", "Jamaica", "Japan", "Jersey", "Jordan", "Kazakhstan", "Kenya", "Kiribati", "Korea", "Kuwait", "Kyrgyzstan", "Laos", "Latvia", "Lebanon", "Lesotho", "Liberia", "Libya", "Liechtenstein", "Lithuania", "Luxembourg", "Macao", "Madagascar", "Malawi", "Malaysia", "Maldives", "Mali", "Malta", "Marshall Islands", "Martinique", "Mauritania", "Mauritius", "Mayotte", "Mexico", "Micronesia", "Midway Islands", "Moldova", "Monaco", "Mongolia", "Montenegro", "Montserrat", "Morocco", "Mozambique", "Myanmar", "Namibia", "Nauru", "Nepal", "Netherlands", "Netherlands Antilles", "New Caledonia", "New Zealand", "Nicaragua", "Niger", "Nigeria", "Niue", "Norfolk Island", "Northern Mariana Islands", "Norway", "Oman", "Pakistan", "Palau", "Palestine Territory", "Panama", "Papua New Guinea", "Paraguay", "Peru", "Philippines", "Poland", "Portugal", "Puerto Rico", "Qatar", "Republic of Korea", "Republic of North Macedonia", "Reunion", "Romania", "Russia", "Rwanda", "Saint Kitts and Nevis", "Samoa", "San Marino", "Sao Tome and Principe", "Saudi Arabia", "Senegal", "Serbia", "Seychelles", "Sierra Leone", "Singapore", "Slovakia", "Slovenia", "Solomon Islands", "Somalia", "South Africa", "Spain", "Sri Lanka", "St Lucia", "St Vincent and the Grenadines", "Sudan", "Suriname", "Sweden", "Switzerland", "Syria", "Taiwan", "Tajikistan", "Tanzania", "Thailand", "Togo", "Tokelau", "Tonga", "Trinidad and Tobago", "Tunisia", "Turkey", "Turkmenistan", "Turks And Caicos Islands", "Tuvalu", "Uganda", "Ukraine", "United Arab Emirates", "United Kingdom", "United States Minor Outlying Islands", "United States of America", "Uruguay", "Uzbekistan", "Vanuatu", "Venezuela", "Vietnam", "Virgin Islands US", "Wallis And Futuna Islands", "Western Sahara", "Yemen", "Zambia", "Zimbabwe" ] } } } }, "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 } } } } } } } } } }