{ "openapi": "3.0.1", "info": { "title": "LinkedIn Skills Demand — Top Skills in Job Postings", "description": "Which skills do LinkedIn job postings ask for? Give a job title and a place, get the top skills with their share of postings, by category (languages, cloud, data, security, business tools, certifications, soft skills) and which skills rose or fell since your last run. No login.", "version": "0.1", "x-build-id": "iCQxIsmcEvVqvBmm8" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/northbell~linkedin-skills-demand/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-northbell-linkedin-skills-demand", "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/northbell~linkedin-skills-demand/runs": { "post": { "operationId": "runs-sync-northbell-linkedin-skills-demand", "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/northbell~linkedin-skills-demand/run-sync": { "post": { "operationId": "run-sync-northbell-linkedin-skills-demand", "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": [ "reports" ], "properties": { "reports": { "title": "Reports", "type": "array", "description": "What to report on: a list of job title + location pairs, each as {\"title\": \"data engineer\", \"location\": \"United States\"} or as text, \"data engineer | Germany\". The location is a country, region or city as LinkedIn spells it (\"Worldwide\" works too). Each pair is one report." }, "maxJobsPerReport": { "title": "Postings to read per report", "minimum": 10, "maximum": 500, "type": "integer", "description": "How many LinkedIn postings to open and read for each report (10 to 500). Skills live in each posting's description, so the run makes about one request per posting plus one per 10 listed. More postings give steadier shares; 100 is a good default.", "default": 100 }, "datePosted": { "title": "Posted within", "enum": [ "past-month", "past-week", "any" ], "type": "string", "description": "Only postings from this period. The past month keeps the report current; choose any time for rare titles or small places. Each period keeps its own history for the since-last-run comparison.", "default": "past-month" }, "titleMatch": { "title": "Which postings count", "enum": [ "all-words", "any" ], "type": "string", "description": "All words in the title (default) keeps postings whose title contains every word you typed, so a data engineer report does not fill up with software engineers. Anything LinkedIn lists keeps everything the LinkedIn search returns for those words.", "default": "all-words" }, "categories": { "title": "Skill categories to show", "type": "array", "description": "Leave empty for all categories. Pick some to leave the rest out of the top list and the by-category lists, for example only Programming Languages, Frameworks, Cloud and Data & AI for a tech-only view. Shares are always out of all postings with a description, whatever you pick.", "items": { "type": "string", "enum": [ "Programming Languages", "Frameworks", "Cloud", "Data & AI", "DevOps & Infrastructure", "Security", "Business Tools", "Methods & Domain", "Certifications", "Soft Skills", "Spoken Languages" ] } }, "maxRequestsPerMinute": { "title": "Requests per minute", "minimum": 5, "maximum": 60, "type": "integer", "description": "How fast the run asks LinkedIn for pages. Lower it if the log shows many rate-limit retries. The pace is shared by all runs of this Actor in your account.", "default": 20 } } }, "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 } } } } } } } } } }