{ "openapi": "3.0.1", "info": { "title": "Job Listings Scraper: 180+ Job Boards & ATS Platforms", "description": "Scrape job listings from 180+ boards & ATS platforms (Greenhouse, Lever, Workday, SmartRecruiters, iCIMS, Ashby, BambooHR, RemoteOK, hh.ru, Gupy...) via one public API. No login or API key. Full descriptions + optional company enrichment.", "version": "1.0", "x-build-id": "GxXKDIxUfdg8IiaVM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/code-node-tools~job-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-code-node-tools-job-listings-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/code-node-tools~job-listings-scraper/runs": { "post": { "operationId": "runs-sync-code-node-tools-job-listings-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/code-node-tools~job-listings-scraper/run-sync": { "post": { "operationId": "run-sync-code-node-tools-job-listings-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": { "queries": { "title": "Search queries", "type": "array", "description": "One or more full-text search queries (matched against title, company, and description). Each query is run as a separate search and results are merged into one dataset. Leave empty to fetch all jobs matching the filters below with no text query.", "default": [], "items": { "type": "string" } }, "descriptionFormat": { "title": "Description format", "enum": [ "html", "text", "markdown" ], "type": "string", "description": "How the job description should be rendered in the output.", "default": "html" }, "sortBy": { "title": "Sort by", "enum": [ "", "created_at", "posted_at", "salary_min", "salary_max" ], "type": "string", "description": "Field to sort results by. Leave as default to get newest-first ordering.", "default": "posted_at" }, "sortOrder": { "title": "Sort order", "enum": [ "asc", "desc" ], "type": "string", "description": "Ascending or descending order for the sortBy field.", "default": "desc" }, "regions": { "title": "Regions", "type": "array", "description": "Broad geographic regions to include.", "items": { "type": "string", "enum": [ "global", "north_america", "latam", "eu", "uk", "mena", "africa", "apac", "cis", "none" ], "enumTitles": [ "Global / Worldwide", "North America", "Latin America", "Europe (EU)", "United Kingdom", "Middle East & North Africa", "Africa", "Asia-Pacific", "CIS (post-Soviet states)", "No region specified" ] }, "default": [] }, "countries": { "title": "Countries", "type": "array", "description": "Search and select one or more countries to restrict results to.", "items": { "type": "string", "enum": [ "AF", "AX", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BQ", "BA", "BW", "BV", "BR", "IO", "BN", "BG", "BF", "BI", "KH", "CM", "CA", "CV", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CG", "CK", "CR", "CI", "HR", "CU", "CW", "CY", "CZ", "DK", "DJ", "DM", "DO", "CD", "EC", "EG", "SV", "GQ", "ER", "EE", "SZ", "ET", "FK", "FO", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "XK", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "FM", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "KP", "MK", "MP", "NO", "OM", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "RE", "RO", "RU", "RW", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "GS", "KR", "SS", "ES", "LK", "SD", "SR", "SJ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "GM", "NL", "TL", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "AE", "UG", "UA", "GB", "US", "UM", "UY", "UZ", "VU", "VA", "VE", "VN", "VG", "VI", "WF", "EH", "YE", "ZM", "ZW" ], "enumTitles": [ "Afghanistan", "Aland Islands", "Albania", "Algeria", "American Samoa", "Andorra", "Angola", "Anguilla", "Antarctica", "Antigua and Barbuda", "Argentina", "Armenia", "Aruba", "Australia", "Austria", "Azerbaijan", "Bahamas", "Bahrain", "Bangladesh", "Barbados", "Belarus", "Belgium", "Belize", "Benin", "Bermuda", "Bhutan", "Bolivia", "Bonaire, Sint Eustatius and Saba", "Bosnia and Herzegovina", "Botswana", "Bouvet Island", "Brazil", "British Indian Ocean Territory", "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", "Cook Islands", "Costa Rica", "Côte d'Ivoire", "Croatia", "Cuba", "Curaçao", "Cyprus", "Czechia", "Denmark", "Djibouti", "Dominica", "Dominican Republic", "DR Congo", "Ecuador", "Egypt", "El Salvador", "Equatorial Guinea", "Eritrea", "Estonia", "Eswatini", "Ethiopia", "Falkland Islands (Malvinas)", "Faroe Islands", "Fiji", "Finland", "France", "French Guiana", "French Polynesia", "French Southern Territories", "Gabon", "Georgia", "Germany", "Ghana", "Gibraltar", "Greece", "Greenland", "Grenada", "Guadeloupe", "Guam", "Guatemala", "Guernsey", "Guinea", "Guinea-Bissau", "Guyana", "Haiti", "Heard Island and McDonald Islands", "Honduras", "Hong Kong", "Hungary", "Iceland", "India", "Indonesia", "Iran", "Iraq", "Ireland", "Isle of Man", "Israel", "Italy", "Jamaica", "Japan", "Jersey", "Jordan", "Kazakhstan", "Kenya", "Kiribati", "Kosovo", "Kuwait", "Kyrgyzstan", "Laos", "Latvia", "Lebanon", "Lesotho", "Liberia", "Libya", "Liechtenstein", "Lithuania", "Luxembourg", "Macau", "Madagascar", "Malawi", "Malaysia", "Maldives", "Mali", "Malta", "Marshall Islands", "Martinique", "Mauritania", "Mauritius", "Mayotte", "Mexico", "Micronesia", "Moldova", "Monaco", "Mongolia", "Montenegro", "Montserrat", "Morocco", "Mozambique", "Myanmar", "Namibia", "Nauru", "Nepal", "New Caledonia", "New Zealand", "Nicaragua", "Niger", "Nigeria", "Niue", "Norfolk Island", "North Korea", "North Macedonia", "Northern Mariana Islands", "Norway", "Oman", "Pakistan", "Palau", "Palestine", "Panama", "Papua New Guinea", "Paraguay", "Peru", "Philippines", "Pitcairn Islands", "Poland", "Portugal", "Puerto Rico", "Qatar", "Reunion", "Romania", "Russia", "Rwanda", "Saint Barthélemy", "Saint Helena", "Saint Kitts and Nevis", "Saint Lucia", "Saint Martin (French part)", "Saint Pierre and Miquelon", "Saint Vincent and the Grenadines", "Samoa", "San Marino", "Sao Tome and Principe", "Saudi Arabia", "Senegal", "Serbia", "Seychelles", "Sierra Leone", "Singapore", "Sint Maarten (Dutch part)", "Slovakia", "Slovenia", "Solomon Islands", "Somalia", "South Africa", "South Georgia and the South Sandwich Islands", "South Korea", "South Sudan", "Spain", "Sri Lanka", "Sudan", "Suriname", "Svalbard and Jan Mayen", "Sweden", "Switzerland", "Syria", "Taiwan", "Tajikistan", "Tanzania", "Thailand", "The Gambia", "The Netherlands", "Timor-Leste", "Togo", "Tokelau", "Tonga", "Trinidad and Tobago", "Tunisia", "Turkey", "Turkmenistan", "Turks and Caicos Islands", "Tuvalu", "UAE", "Uganda", "Ukraine", "United Kingdom", "United States", "United States Minor Outlying Islands", "Uruguay", "Uzbekistan", "Vanuatu", "Vatican City", "Venezuela", "Vietnam", "Virgin Islands, British", "Virgin Islands, U.S.", "Wallis and Futuna", "Western Sahara", "Yemen", "Zambia", "Zimbabwe" ] }, "default": [] }, "cities": { "title": "Cities", "type": "array", "description": "Open vocabulary, exact city names as used by the source data, e.g. Berlin, Vitória.", "default": [], "items": { "type": "string" } }, "workMode": { "title": "Work mode", "type": "array", "description": "Remote, hybrid, or on-site roles.", "items": { "type": "string", "enum": [ "remote", "hybrid", "onsite" ], "enumTitles": [ "Remote", "Hybrid", "Onsite" ] }, "default": [] }, "category": { "title": "Category / specialization", "type": "array", "description": "e.g. backend, frontend, devops, data_science, product, sales ...", "default": [], "items": { "type": "string" } }, "seniority": { "title": "Seniority", "type": "array", "description": "Experience level required for the role.", "items": { "type": "string", "enum": [ "intern", "junior", "middle", "senior", "lead", "staff", "principal", "c_level" ], "enumTitles": [ "Intern", "Junior", "Middle", "Senior", "Lead", "Staff", "Principal", "C-Level / Executive" ] }, "default": [] }, "skills": { "title": "Skills", "type": "array", "description": "Open vocabulary, e.g. go, rust, react", "default": [], "items": { "type": "string" } }, "domains": { "title": "Industry domains", "type": "array", "description": "fintech, crypto, ecommerce, gambling, gamedev, media, ...", "default": [], "items": { "type": "string" } }, "companyType": { "title": "Company type", "type": "array", "description": "product, startup, outsource, outstaff, agency, inhouse, government", "default": [], "items": { "type": "string" } }, "salaryCurrency": { "title": "Salary currency", "enum": [ "", "USD", "EUR", "GBP", "RUB" ], "type": "string", "description": "Restrict salaryMin/salaryMax filtering to jobs listed in this currency.", "default": "" }, "salaryMin": { "title": "Minimum salary", "type": "integer", "description": "Only return jobs whose listed salary is at least this amount (in salaryCurrency, if set)." }, "salaryMax": { "title": "Maximum salary", "type": "integer", "description": "Only return jobs whose listed salary is at most this amount (in salaryCurrency, if set)." }, "experienceYearsMin": { "title": "Minimum years of experience", "type": "integer", "description": "Only return jobs requiring at least this many years of experience." }, "postedWithinDays": { "title": "Posted within (days)", "type": "integer", "description": "Only return jobs posted within the last N days. e.g. 2, 3" }, "postingLanguage": { "title": "Posting language(s)", "type": "array", "description": "ISO 639-1 language code(s) the job posting was written in, e.g. en, pt, de.", "default": [], "items": { "type": "string" } }, "visaSponsorship": { "title": "Visa sponsorship", "type": "boolean", "description": "Only return jobs that offer visa sponsorship. Leave unchecked to include both sponsoring and non-sponsoring jobs.", "default": false }, "source": { "title": "Source(s)", "type": "array", "description": "Job board / ATS source, open vocabulary, e.g. greenhouse, lever, workday, solides.", "default": [], "items": { "type": "string" } }, "fetchCompanyDetails": { "title": "Fetch company details", "type": "boolean", "description": "For each job's company, look up and attach a company_details object (headcount, HQ country, industries, founding year, etc). Each unique company is only ever fetched once per run no matter how many of its jobs appear in the results.", "default": true }, "companyFetchConcurrency": { "title": "Company fetch concurrency", "type": "integer", "description": "How many company lookups to run in parallel when fetchCompanyDetails is on. Keep this modest to stay polite to the API.", "default": 5 }, "maxItems": { "title": "Max jobs to scrape", "type": "integer", "description": "Overall cap across all queries and pages. Leave empty to fetch everything matching the filters (bounded by the API's 10000 deep-paging limit per query).", "default": 1000 }, "queryConcurrency": { "title": "Query concurrency", "type": "integer", "description": "How many search queries (from the Search queries field) to run in parallel. Only relevant when you enter more than one query. Each query still paginates sequentially within itself.", "default": 3 } } }, "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 } } } } } } } } } }