{
  "openapi": "3.0.1",
  "info": {
    "title": "EU Have Your Say – Commission Consultations & Feedback",
    "description": "Track EU Commission initiatives on Have Your Say: open public consultations and calls for evidence with deadlines, stages and documents, plus which companies, associations and NGOs responded (with Transparency Register IDs). Official data.",
    "version": "1.0",
    "x-build-id": "qjFYEk7V7ckg1MGHu"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/dach-open-data~eu-have-your-say-consultations/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-dach-open-data-eu-have-your-say-consultations",
        "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/dach-open-data~eu-have-your-say-consultations/runs": {
      "post": {
        "operationId": "runs-sync-dach-open-data-eu-have-your-say-consultations",
        "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/dach-open-data~eu-have-your-say-consultations/run-sync": {
      "post": {
        "operationId": "run-sync-dach-open-data-eu-have-your-say-consultations",
        "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": {
          "mode": {
            "title": "What to return",
            "enum": [
              "initiatives",
              "feedback"
            ],
            "type": "string",
            "description": "initiatives = one row per Commission initiative. feedback = one row per response from a company, association, NGO, public authority or research body (metadata and links only, feedback from private individuals is never returned).",
            "default": "initiatives"
          },
          "initiativeIds": {
            "title": "Initiative IDs or links",
            "type": "array",
            "description": "Optional. Initiative IDs (e.g. 15112) or Have Your Say links. When set, the filters below are ignored. In feedback mode this is the usual way to get all organisations that responded to one initiative.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "search": {
            "title": "Search words",
            "type": "string",
            "description": "Words in the initiative title or summary, e.g. \"hydrogen\", \"AI Act\", \"packaging\". Only exact matches are returned.",
            "default": ""
          },
          "topics": {
            "title": "Topics",
            "type": "array",
            "description": "One or more policy topics (code or name, e.g. ENER or Energy). Empty = all topics.",
            "items": {
              "type": "string",
              "enumSuggestedValues": [
                "AGRI",
                "FINANCE",
                "BORDERS",
                "BUDGET",
                "BUSINESS",
                "CLIMA",
                "COMP",
                "CONSUM",
                "CULT",
                "CUSTOMS",
                "DIGITAL",
                "ECFIN",
                "EAC",
                "EMPL",
                "ENER",
                "ENV",
                "ENLARG",
                "NEIGHBOUR",
                "FOOD",
                "FOREIGN",
                "FRAUD",
                "HOME",
                "HUMAN",
                "INST",
                "INTDEV",
                "JUST",
                "MARE",
                "ASYL",
                "HEALTH",
                "REGIO",
                "RESEARCH",
                "SINGMARK",
                "SPORT",
                "STAT",
                "TAX",
                "TRADE",
                "TRANSPORT",
                "YOUTH"
              ],
              "enumTitles": [
                "Agriculture and rural development",
                "Banking and financial services",
                "Borders and security",
                "Budget",
                "Business and industry",
                "Climate action",
                "Competition",
                "Consumers",
                "Culture and media",
                "Customs",
                "Digital economy and society",
                "Economy, finance and the euro",
                "Education and training",
                "Employment and social affairs",
                "Energy",
                "Environment",
                "EU enlargement",
                "European neighbourhood policy",
                "Food safety",
                "Foreign affairs and security policy",
                "Fraud prevention",
                "Home affairs",
                "Humanitarian aid and civil protection",
                "Institutional affairs",
                "International cooperation and development",
                "Justice and fundamental rights",
                "Maritime affairs and fisheries",
                "Migration and asylum",
                "Public health",
                "Regional policy",
                "Research and innovation",
                "Single market",
                "Sport",
                "Statistics",
                "Taxation",
                "Trade",
                "Transport",
                "Youth"
              ]
            },
            "default": []
          },
          "feedbackStatus": {
            "title": "Feedback status",
            "enum": [
              "ANY",
              "OPEN",
              "UPCOMING",
              "CLOSED",
              "DISABLED"
            ],
            "type": "string",
            "description": "OPEN = initiatives you can comment on right now (calls for evidence, public consultations, draft acts).",
            "default": "ANY"
          },
          "closingWithinDays": {
            "title": "Closing within (days)",
            "minimum": 0,
            "maximum": 365,
            "type": "integer",
            "description": "Only initiatives whose open feedback period ends within this many days (0 = off). Useful for deadline alerts.",
            "default": 0
          },
          "openedInLastDays": {
            "title": "Opened in the last (days)",
            "minimum": 0,
            "maximum": 3650,
            "type": "integer",
            "description": "Only initiatives whose feedback period opened in the last N days (0 = off). Schedule daily with 1 or weekly with 7 to get new consultations.",
            "default": 0
          },
          "openedSince": {
            "title": "Opened since (date)",
            "type": "string",
            "description": "Only initiatives whose feedback period opened on or after this date (YYYY-MM-DD).",
            "default": ""
          },
          "stages": {
            "title": "Stages",
            "type": "array",
            "description": "Current stage: in preparation, call for evidence, public consultation, draft act, Commission adoption, suspended/abandoned. Empty = all.",
            "items": {
              "type": "string",
              "enumSuggestedValues": [
                "INIT_PLANNED",
                "PLANNING_WORKFLOW",
                "OPC_LAUNCHED",
                "ISC_WORKFLOW",
                "ADOPTION_WORKFLOW",
                "SUSPENDED_ABANDONED"
              ],
              "enumTitles": [
                "In preparation",
                "Call for evidence",
                "Public consultation",
                "Draft act",
                "Commission adoption",
                "Suspended/Abandoned"
              ]
            },
            "default": []
          },
          "actTypes": {
            "title": "Types of act",
            "type": "array",
            "description": "Legislative proposals, delegated acts, implementing acts, communications, others. Empty = all.",
            "items": {
              "type": "string",
              "enumSuggestedValues": [
                "COMMUNIC",
                "DEL_ACT",
                "IMPL_ACT",
                "LEG_PROP",
                "OTHERS"
              ],
              "enumTitles": [
                "Communication",
                "Delegated acts",
                "Implementing acts",
                "Legislative proposals",
                "Others"
              ]
            },
            "default": []
          },
          "categories": {
            "title": "Categories",
            "type": "array",
            "description": "Commission Work Programme, REFIT (simplification), evaluations, Conference on the Future of Europe. Empty = all.",
            "items": {
              "type": "string",
              "enumSuggestedValues": [
                "CWP",
                "REFIT",
                "EVALUATION",
                "COFE"
              ],
              "enumTitles": [
                "Commission Work Programme",
                "REFIT",
                "Evaluation",
                "Conference on the Future of Europe"
              ]
            },
            "default": []
          },
          "includeDetails": {
            "title": "Include details and documents",
            "type": "boolean",
            "description": "Adds summary, responsible DG, all publications with feedback counts, questionnaire link and document download links (one extra request per initiative). Turn off for fast lists.",
            "default": true
          },
          "language": {
            "title": "Language",
            "enum": [
              "BG",
              "CS",
              "DA",
              "DE",
              "EL",
              "EN",
              "ES",
              "ET",
              "FI",
              "FR",
              "GA",
              "HR",
              "HU",
              "IT",
              "LT",
              "LV",
              "MT",
              "NL",
              "PL",
              "PT",
              "RO",
              "SK",
              "SL",
              "SV"
            ],
            "type": "string",
            "description": "Language of titles, links and documents (falls back to English when no translation exists).",
            "default": "EN"
          },
          "respondentTypes": {
            "title": "Respondent types (feedback mode)",
            "type": "array",
            "description": "Only these kinds of organisations, e.g. COMPANY, BUSINESS_ASSOCIATION, NGO. Empty = all organisations. Private individuals are never returned.",
            "items": {
              "type": "string",
              "enumSuggestedValues": [
                "COMPANY",
                "NGO",
                "PUBLIC_AUTHORITY",
                "OTHER",
                "BUSINESS_ASSOCIATION",
                "TRADE_UNION",
                "CONSUMER_ORGANISATION",
                "ENVIRONMENTAL_ORGANISATION",
                "ACADEMIC_RESEARCH_INSTITTUTION"
              ],
              "enumTitles": [
                "Company/business",
                "Non-governmental organisation (NGO)",
                "Public authority",
                "Other",
                "Business association",
                "Trade union",
                "Consumer organisation",
                "Environmental organisation",
                "Academic/research Institution"
              ]
            },
            "default": []
          },
          "countries": {
            "title": "Countries (feedback mode)",
            "type": "array",
            "description": "Only organisations from these countries: ISO codes like DE, FR, BE (or DEU, FRA). Empty = all.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "feedbackSince": {
            "title": "Feedback since (feedback mode)",
            "type": "string",
            "description": "Only feedback submitted on or after this date (YYYY-MM-DD). Good for monitoring an open consultation.",
            "default": ""
          },
          "maxResults": {
            "title": "Max results",
            "minimum": 1,
            "maximum": 100000,
            "type": "integer",
            "description": "Maximum number of rows (each row is charged). The run also stops at your maximum cost per run.",
            "default": 200
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}