{ "openapi": "3.0.1", "info": { "title": "Job Title to SOC Code Mapper with O*NET Data", "description": "Map job titles from any job board or ATS to SOC 2018 and O*NET-SOC occupation codes in bulk. Returns occupation, major group, job zone, seniority, match confidence and alternatives, plus software and technology skills found in the posting (hot technologies flagged). No AI.", "version": "0.1", "x-build-id": "Isaw7KM0GIlaGSuvt" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ultimatemc~job-title-soc-code-mapper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ultimatemc-job-title-soc-code-mapper", "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/ultimatemc~job-title-soc-code-mapper/runs": { "post": { "operationId": "runs-sync-ultimatemc-job-title-soc-code-mapper", "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/ultimatemc~job-title-soc-code-mapper/run-sync": { "post": { "operationId": "run-sync-ultimatemc-job-title-soc-code-mapper", "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": { "titles": { "title": "Job titles", "type": "array", "description": "Job titles to map, one per line, exactly as they appear in postings (noise like '(Remote)', 'Sr.', '$5K sign-on bonus' is handled). The prefill has four examples; replace them with your own.", "items": { "type": "string" } }, "jobs": { "title": "Job postings with descriptions (optional)", "type": "array", "description": "One object per posting with \"title\", optional \"description\" (text or HTML) and your own \"id\". The description improves tie-breaks and is scanned for software and technology skills. Example: [{\"id\": \"job-1\", \"title\": \"Data Engineer\", \"description\": \"Experience with Python, SQL and Snowflake.\"}]" }, "datasetId": { "title": "Dataset ID (optional)", "type": "string", "description": "Map the output of a job scraper (LinkedIn, Indeed, Glassdoor, Greenhouse, Lever, Workday...). Title fields (title, jobTitle, positionName...) and description fields (description, descriptionText, descriptionHtml...) are detected automatically." }, "titleField": { "title": "Dataset title field (optional)", "type": "string", "description": "Field name holding the job title in your dataset, if it isn't detected automatically." }, "descriptionField": { "title": "Dataset description field (optional)", "type": "string", "description": "Field name holding the job description, if it isn't detected automatically." }, "extractTechnologies": { "title": "Extract software and technology skills", "type": "boolean", "description": "Scan the title and description for software and technologies from the O*NET Technology Skills list (e.g. Python, Salesforce, AutoCAD, Epic). Ambiguous names such as Ruby, Swift or Chef are only counted next to other technologies.", "default": true }, "maxItems": { "title": "Max postings", "minimum": 1, "type": "integer", "description": "Maximum number of postings to map in one run. Each mapped posting is one result.", "default": 1000 }, "minConfidencePercent": { "title": "Low-confidence note threshold (%)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Rows whose best match has a confidence below this percentage (e.g. 60) get a note. Matches are always returned, so nothing is silently dropped.", "default": 0 } } }, "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 } } } } } } } } } }