{
  "openapi": "3.0.1",
  "info": {
    "title": "Poland UOKiK Decisions Scraper",
    "description": "Search and extract decisions of Poland's competition and consumer protection authority - merger clearances, dominant position abuse, collective consumer interests, fuel quality and prohibited clauses, with named parties, fines and appeal status.",
    "version": "1.1",
    "x-build-id": "6DrysSNVpjTKUjL5V"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/regdata~uokik-decisions-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-regdata-uokik-decisions-scraper",
        "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/regdata~uokik-decisions-scraper/runs": {
      "post": {
        "operationId": "runs-sync-regdata-uokik-decisions-scraper",
        "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/regdata~uokik-decisions-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-regdata-uokik-decisions-scraper",
        "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": {
          "participant": {
            "title": "Company or person",
            "type": "string",
            "description": "Name of a party to the proceedings, e.g. \"Orange\". Matches whole words in the party field, case-insensitive. Polish diacritics matter - the register's search is literal."
          },
          "practiceType": {
            "title": "Type of practice",
            "enum": [
              "",
              "Jakość paliw",
              "Klauzule niedozwolone",
              "Kontrola koncentracji",
              "Nadużywanie pozycji dominującej",
              "Ochrona zbiorowych interesów konsumentów",
              "Ogólne bezpieczeństwo produktów",
              "Porozumienia ograniczające konkurencję",
              "Pozostałe",
              "Przewaga kontraktowa",
              "System oceny zgodności",
              "Zatory Płatnicze"
            ],
            "type": "string",
            "description": "The category of proceedings. Roughly: merger control 5,800 decisions, product-safety conformity 4,000, collective consumer interests 4,000, dominant position 1,900.",
            "default": ""
          },
          "decisionNumber": {
            "title": "Decision number",
            "type": "string",
            "description": "The decision's own number, e.g. \"DKK-171/2024\"."
          },
          "caseSignature": {
            "title": "Case signature",
            "type": "string",
            "description": "The case file signature, e.g. \"DKK-2.430\". Matches a prefix as well as a whole signature."
          },
          "industry": {
            "title": "Industry (PKD)",
            "type": "string",
            "description": "Matches the whole PKD path, so \"SEKCJA K\" selects the entire financial sector while \"TELEKOMUNIKACJA\" selects one class. Because the register stores the path but each decision page shows only the leaf class, a match can look unrelated and still be correct - \"BUDOWNICTWO\" returns electrical-installation firms, which sit under Section F."
          },
          "region": {
            "title": "Voivodeship",
            "enum": [
              "",
              "Dolnośląskie",
              "Kujawsko-Pomorskie",
              "Łódzkie",
              "Lubelskie",
              "Lubuskie",
              "Małopolskie",
              "Mazowieckie",
              "Opolskie",
              "Podkarpackie",
              "Podlaskie",
              "Pomorskie",
              "Śląskie",
              "Świętokrzyskie",
              "Warmińsko-Mazurskie",
              "Wielkopolskie",
              "Zachodniopomorskie"
            ],
            "type": "string",
            "description": "Region the decision applies to. A decision can list several.",
            "default": ""
          },
          "fineImposed": {
            "title": "Fine imposed",
            "enum": [
              "",
              "yes",
              "no"
            ],
            "type": "string",
            "description": "Whether the decision imposed a fine. The register records only THAT a fine was imposed - it never publishes the amount.",
            "default": ""
          },
          "appealed": {
            "title": "Appealed",
            "enum": [
              "",
              "yes",
              "no"
            ],
            "type": "string",
            "description": "Whether the decision was appealed.",
            "default": ""
          },
          "dateFrom": {
            "title": "Decided on or after",
            "type": "string",
            "description": "ISO date, YYYY-MM-DD. Note that six records in the register carry no decision date at all and are excluded by any date filter."
          },
          "dateTo": {
            "title": "Decided on or before",
            "type": "string",
            "description": "ISO date, YYYY-MM-DD."
          },
          "fullText": {
            "title": "Full-text term",
            "type": "string",
            "description": "Free text searched across the whole document index. Broader than it looks - it matches text the decision page does not display, so use the specific fields above when you can."
          },
          "maxItems": {
            "title": "Maximum decisions",
            "minimum": 0,
            "type": "integer",
            "description": "Stop after this many. Set 0 for every match - the whole register is about 22,000 decisions.",
            "default": 100
          },
          "includeDetails": {
            "title": "Fetch full decision details",
            "type": "boolean",
            "description": "Open each decision to read its case signature, fine flag, appeal status, industry and region. Off returns only what the result list shows: number, date, party and practice type.",
            "default": true
          },
          "includeIncompleteRecords": {
            "title": "Include records that identify nothing",
            "type": "boolean",
            "description": "The register holds six documents with no number, date or party. They are skipped by default and always counted in the run summary.",
            "default": false
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "The register does not accept connections from datacenter IP ranges, so runs on the platform need a residential proxy. Defaults to Apify Proxy residential, Poland - which is also by far the fastest route to this register.",
            "default": {
              "useApifyProxy": true,
              "apifyProxyGroups": [
                "RESIDENTIAL"
              ],
              "apifyProxyCountry": "PL"
            }
          }
        }
      },
      "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
                  }
                }
              },
              "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}