{ "openapi": "3.0.1", "info": { "title": "O*NET Occupation Data Scraper", "description": "Scrape O*NET OnLine (US Dept. of Labor) occupation data: SOC lookup, keyword search, browse by Job Zone or Bright Outlook. Tasks, skills, wages, growth outlook, related occupations.", "version": "1.0", "x-build-id": "QDGZiJJG8ihsrGZ0Y" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~onet-occupation-data-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-onet-occupation-data-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/crawlerbros~onet-occupation-data-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-onet-occupation-data-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/crawlerbros~onet-occupation-data-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-onet-occupation-data-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": [ "bySocCode", "search", "browseByJobZone", "browseByBrightOutlook", "browseByJobFamily", "browseByIndustry", "browseByCareerCluster", "browseBySTEM", "browseByHotTechnology" ], "type": "string", "description": "What to fetch.", "default": "bySocCode" }, "socCodes": { "title": "SOC codes (mode = bySocCode)", "type": "array", "description": "O*NET-SOC occupation codes to look up, format `##-####.##` (e.g. `15-1252.00` for Software Developers). Find codes via mode=search first.", "default": [ "15-1252.00" ], "items": { "type": "string" } }, "wageState": { "title": "Wage percentiles: US state (mode = bySocCode)", "enum": [ "", "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY", "AS", "GU", "MP", "PR", "VI" ], "type": "string", "description": "Optional. Also include state-level wage percentiles (10th/25th/median/75th/90th, hourly + annual) alongside the national figures. Leave blank for national-only.", "default": "" }, "searchQuery": { "title": "Search query (mode = search)", "type": "string", "description": "Free-text keyword to search occupation titles, e.g. `electrician`, `nurse`, `software developer`.", "default": "electrician" }, "jobZone": { "title": "Job Zone (mode = browseByJobZone)", "enum": [ "0", "2", "3", "4", "5" ], "type": "string", "description": "Preparation/education level to browse. Job Zone 1 has no standalone browse bucket on O*NET OnLine — it is combined with Job Zone 2.", "default": "4" }, "brightOutlookCategory": { "title": "Bright Outlook category (mode = browseByBrightOutlook)", "enum": [ "0", "1", "2", "3" ], "type": "string", "description": "Bright Outlook occupations are projected to grow rapidly, have many job openings, or are new/emerging.", "default": "0" }, "jobFamily": { "title": "Job Family (mode = browseByJobFamily)", "enum": [ "0", "17", "27", "37", "13", "21", "15", "47", "25", "45", "35", "29", "31", "49", "23", "19", "11", "55", "43", "39", "51", "33", "41", "53" ], "type": "string", "description": "O*NET Job Family (SOC major occupational group) to browse.", "default": "15" }, "industry": { "title": "Industry (mode = browseByIndustry)", "enum": [ "0", "72", "56", "11", "71", "23", "61", "52", "93", "62", "51", "55", "31", "21", "81", "54", "53", "44", "48", "22", "42" ], "type": "string", "description": "Industry sector to browse.", "default": "51" }, "careerCluster": { "title": "Career Cluster (mode = browseByCareerCluster)", "enum": [ "0", "010100", "010200", "010300", "020100", "020200", "030100", "040100", "040200", "040300", "050100", "050200", "060100", "060200", "060300" ], "type": "string", "description": "O*NET Career Cluster (2024-revised) to browse.", "default": "060100" }, "stemCategory": { "title": "STEM category (mode = browseBySTEM)", "enum": [ "0", "1", "2", "3", "4", "5" ], "type": "string", "description": "STEM (Science, Technology, Engineering, Math) occupation category to browse.", "default": "0" }, "hotTechnology": { "title": "Hot Technology (mode = browseByHotTechnology)", "enum": [ "AJAX", "Adobe Acrobat", "Adobe After Effects", "Adobe Creative Cloud software", "Adobe Illustrator", "Adobe InDesign", "Adobe Photoshop", "Alteryx software", "Amazon DynamoDB", "Amazon Elastic Compute Cloud EC2", "Amazon Redshift", "Amazon Web Services AWS CloudFormation", "Amazon Web Services AWS software", "Ansible software", "Apache Airflow", "Apache Cassandra", "Apache Hadoop", "Apache Hive", "Apache Kafka", "Apache Maven", "Apache Spark", "Apache Subversion SVN", "Apache Tomcat", "Apple Safari", "Apple iOS", "Apple macOS", "Asana", "Atlassian Bitbucket", "Atlassian Confluence", "Atlassian JIRA", "Autodesk AutoCAD", "Autodesk AutoCAD Civil 3D", "Autodesk Revit", "Bash", "Bentley MicroStation", "Bootstrap", "Border Gateway Protocol BGP", "C", "C#", "C++", "Canva", "Cascading style sheets CSS", "Chef", "Cisco Webex", "Dassault Systemes SolidWorks", "Django", "Docker", "ESRI ArcGIS software", "Eclipse IDE", "Elasticsearch", "Epic Systems", "Extensible markup language XML", "Facebook", "Figma", "Git", "GitHub", "GitLab", "Go", "Google Analytics", "Google Android", "Google Angular", "Google Docs", "Google Looker Analytics", "Google Sheets", "Google Workspace software", "Grafana Labs Grafana Cloud", "GraphQL", "Henry Schein Dentrix", "Hibernate ORM", "HubSpot software", "Hypertext markup language HTML", "IBM DB2", "IBM SPSS Statistics", "IBM Terraform", "IBM WebSphere MQ", "Informatica software", "Intuit QuickBooks", "Intuit TurboTax", "JUnit", "JavaScript", "JavaScript Object Notation JSON", "Jenkins CI", "Kronos Workforce Timekeeper", "Kubernetes", "Linux", "MEDITECH software", "Marketo Marketing Automation", "Microsoft .NET Framework", "Microsoft ASP.NET", "Microsoft Access", "Microsoft Active Directory", "Microsoft Active Server Pages ASP", "Microsoft Azure software", "Microsoft Edge", "Microsoft Excel", "Microsoft Office software", "Microsoft Outlook", "Microsoft Power Automate", "Microsoft Power BI", "Microsoft Power Platform software", "Microsoft PowerPoint", "Microsoft PowerShell", "Microsoft Project", "Microsoft SQL Server", "Microsoft SQL Server Integration Services SSIS", "Microsoft SQL Server Reporting Services SSRS", "Microsoft SharePoint", "Microsoft Team Foundation Server", "Microsoft Teams", "Microsoft Visio", "Microsoft Visual Basic", "Microsoft Visual Basic for Applications VBA", "Microsoft Visual Studio", "Microsoft Windows", "Microsoft Windows Server", "Microsoft Word", "MongoDB", "Mozilla Firefox", "MySQL", "NoSQL", "Node.js", "Oracle Cloud software", "Oracle Database", "Oracle Java", "Oracle Java 2 Platform Enterprise Edition J2EE", "Oracle PL/SQL", "Oracle PeopleSoft", "Oracle Primavera Enterprise Project Portfolio Management", "Oracle SQL Developer", "PHP", "Perl", "PostgreSQL", "Procore software", "Prometheus", "Puppet", "PyTorch", "Python", "R", "React", "Red Hat Enterprise Linux", "Red Hat OpenShift", "Redis", "Ruby", "SAP Concur", "SAP ERP", "SAP software", "SAS", "Salesforce software", "Scala", "Selenium", "ServiceNow", "Shell script", "Slack", "Snowflake", "Splunk Enterprise", "Spring Boot", "Spring Framework", "Structured query language SQL", "Swift", "Tableau", "TensorFlow", "Teradata Database", "The MathWorks MATLAB", "TikTok", "Transact-SQL", "Trimble SketchUp Pro", "TypeScript", "UNIX", "UNIX Shell", "Vue.js", "WordPress", "Workday software", "Yardi software", "Zoom", "eClinicalWorks EHR software", "jQuery" ], "type": "string", "description": "Employer-demand software/technology name. Returns occupations that report using it.", "default": "Python" }, "titleContains": { "title": "Filter: title contains", "type": "string", "description": "Only keep occupations whose title contains this text (case-insensitive). Applies to search and all browse* modes." }, "brightOutlookOnly": { "title": "Filter: Bright Outlook only", "type": "boolean", "description": "Only keep occupations tagged Bright Outlook. Applies to search and all browse* modes.", "default": false }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard cap on emitted records.", "default": 50 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Not required — onetonline.org is a public, unauthenticated site with no known IP-based blocking. Kept as an optional fallback only.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }