{
  "openapi": "3.0.1",
  "info": {
    "title": "EU Business Formation & Survival Rates — Eurostat Demography",
    "description": "Eurostat business demography by country, size class and industry: enterprise births, deaths, survival and active counts or rates, newest year first. The original table (2004-2020) is the default; the newer bd_size table (2009-2024) adds survival age. Aggregates, not company lists. Pay per record.",
    "version": "0.2",
    "x-build-id": "eeEgQYFzk2kb7t1Fg"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/nexgensignal~eu-business-demography-records/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-nexgensignal-eu-business-demography-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-business-demography-records/runs": {
      "post": {
        "operationId": "runs-sync-nexgensignal-eu-business-demography-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-business-demography-records/run-sync": {
      "post": {
        "operationId": "run-sync-nexgensignal-eu-business-demography-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",
        "required": [
          "geo"
        ],
        "properties": {
          "sourceTable": {
            "title": "Source table",
            "enum": [
              "bd_9bd_sz_cl_r2",
              "bd_size"
            ],
            "type": "string",
            "description": "Which Eurostat table to read. <code>bd_9bd_sz_cl_r2</code> is the original table and stays the default; <code>bd_size</code> is Eurostat's newer table. Their codes differ, so the other inputs are checked against the table you choose.",
            "default": "bd_9bd_sz_cl_r2"
          },
          "indicator": {
            "title": "Indicator",
            "type": "array",
            "description": "Original table: Optional but recommended. Eurostat indicator codes, e.g. <code>V11910</code> Population of active enterprises in t - number; <code>V11920</code> Births of enterprises in t - number; <code>V11930</code> Deaths of enterprises in t - number; <code>V97010</code> Net business population growth - percentage; <code>V97020</code> Birth rate: number of enterprise births in the reference period (t) divided by the number of enterprises active in t - percentage; <code>V97030</code> Death rate: number of enterprise deaths in the reference period (t) divided by the number of enterprises active in t - percentage; <code>V97041</code> Survival rate 1: number of enterprises in the reference period (t) newly born in t-1 having survived to t divided by the number of enterprise births in t-1 - percentage; <code>V97043</code> Survival rate 3: number of enterprises in the reference period (t) newly born in t-3 having survived to t divided by the number of enterprise births in t-3 - percentage; <code>V97045</code> Survival rate 5: number of enterprises in the reference period (t) newly born in t-5 having survived to t divided by the number of enterprise births in t-5 - percentage. Counts (V11..) are numbers of enterprises; V97.. are rates in percent. Full list of 87 in the README. Newer table: With bd_size: <code>ENT_NR</code> active enterprises, <code>ENT_BRTH_NR</code> births, <code>ENT_DTH_NR</code> deaths, <code>ENT_SRVL_NR</code> survivals, <code>ENT_BRTHR_PC</code> birth rate %, <code>ENT_DTHR_PC</code> death rate %, <code>ENT_SRVLR_BRTH_PC</code> survival rate %, <code>GRW_ENT_PC</code> net population growth %. 32 codes; full list in the README.",
            "items": {
              "type": "string"
            }
          },
          "sizeClass": {
            "title": "Size class",
            "type": "array",
            "description": "Optional. <code>TOTAL</code> Total; <code>0</code> Zero; <code>1-4</code> From 1 to 4 employees; <code>5-9</code> From 5 to 9 employees; <code>GE10</code> 10 employees or more.",
            "items": {
              "type": "string"
            }
          },
          "industry": {
            "title": "Industry (NACE)",
            "type": "array",
            "description": "Optional. NACE Rev.2 codes, e.g. <code>B-S_X_K642</code> industry, construction and services except holding companies, <code>C</code> manufacturing, <code>F</code> construction, <code>J62</code> computer programming, <code>I56</code> food and beverage services. 194 codes; full list in the README.",
            "items": {
              "type": "string"
            }
          },
          "age": {
            "title": "Survival age (bd_size only)",
            "type": "array",
            "description": "bd_size only: <code>TOTAL</code>, <code>Y1</code>…<code>Y5</code> (years since birth, for survival indicators).",
            "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 year onward (annual). The original table ends at 2020; <code>bd_size</code> runs 2009–2024. Use a year (2015). Earlier start = more records.",
            "default": "2015"
          },
          "geo": {
            "title": "Country / territory (required)",
            "type": "string",
            "description": "Eurostat geo code to pull (e.g. DE, FR, IT, ES). Required: this cube is too large to return in one request, so it is retrieved one territory at a time.",
            "default": "DE"
          },
          "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}