{
"openapi": "3.0.1",
"info": {
"title": "EU Job Vacancy Benchmark — Quarterly by Industry",
"description": "Eurostat quarterly job vacancy statistics (jvs_q_nace2): choose the vacancy rate, number of vacancies or occupied posts by industry, size class and country, newest quarter first. Official statistics, not job ads. CC BY 4.0, pay per record.",
"version": "0.1",
"x-build-id": "YL21mSUkbG8hMT2jl"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/nexgensignal~eu-job-vacancy-benchmark-records/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-nexgensignal-eu-job-vacancy-benchmark-records",
"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/nexgensignal~eu-job-vacancy-benchmark-records/runs": {
"post": {
"operationId": "runs-sync-nexgensignal-eu-job-vacancy-benchmark-records",
"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/nexgensignal~eu-job-vacancy-benchmark-records/run-sync": {
"post": {
"operationId": "run-sync-nexgensignal-eu-job-vacancy-benchmark-records",
"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": {
"measure": {
"title": "Measure",
"type": "array",
"description": "Optional but recommended. JOBVAC Job vacancies; JOBOCC Occupied (posts) jobs; JVR Job vacancy rate; JVRCH_Q Job vacancy quarterly rate of change. Without it every row type is mixed together (vacancies, occupied posts, rates).",
"items": {
"type": "string"
}
},
"industry": {
"title": "Industry (NACE)",
"type": "array",
"description": "Optional. NACE Rev.2 codes, e.g. A-S all activities, B-S industry, construction and services, C manufacturing, F construction, J information and communication, Q health. Full list in the README.",
"items": {
"type": "string"
}
},
"sizeClass": {
"title": "Business size",
"type": "array",
"description": "Optional. TOTAL Total; GE10 10 employees or more.",
"items": {
"type": "string"
}
},
"adjustment": {
"title": "Seasonal adjustment",
"type": "array",
"description": "Optional. NSA Unadjusted data (i.e. neither seasonally adjusted nor calendar adjusted data); SA Seasonally adjusted data, not calendar adjusted data.",
"items": {
"type": "string"
}
},
"newestFirst": {
"title": "Newest first",
"type": "boolean",
"description": "Order by period, most recent first, before cutting to Maximum records (monthly, quarterly and annual periods are ordered by the date they end)."
},
"sinceTimePeriod": {
"title": "Earliest period",
"type": "string",
"description": "Return observations from this quarter onward. Use a year (2015) or a quarter (2015-Q1). Earlier start = more records. The full multi-country cube is auto-partitioned by territory when it is too large for a single request.",
"default": "2015"
},
"geo": {
"title": "Country / territory (optional)",
"type": "string",
"description": "Optional Eurostat geo code (e.g. DE). Leave blank to pull all licence-permitted territories (auto-partitioned if the full cube is too large for one request)."
},
"maxRecords": {
"title": "Maximum records",
"minimum": 1,
"maximum": 300000,
"type": "integer",
"description": "Maximum records delivered and billed. You are billed only for records actually delivered. Raise it to pull the full set.",
"default": 10
}
}
},
"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
}
}
}
}
}
}
}
}
}
}