{
  "openapi": "3.0.1",
  "info": {
    "title": "New Companies: Companies House UK, France, Norway, Finland",
    "description": "Weekly feed of newly registered companies from official registers (Companies House, BODACC, Brreg Brønnøysund, PRH): name, number, legal form, SIC/NACE activity, address, website. Filter by activity, keyword, location. Only-new mode for n8n/Make.",
    "version": "0.2",
    "x-build-id": "YsjLD5WFtGiW8ieZn"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/polderdata~new-company-registrations-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-polderdata-new-company-registrations-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/polderdata~new-company-registrations-scraper/runs": {
      "post": {
        "operationId": "runs-sync-polderdata-new-company-registrations-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/polderdata~new-company-registrations-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-polderdata-new-company-registrations-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": {
          "countries": {
            "title": "Countries",
            "type": "array",
            "description": "Registers to read. UK = Companies House (~14,000 new companies a week), France = BODACC creation notices of companies (~5,000 a week), Norway = Brønnøysund (~2,000), Finland = PRH (~500). Sole traders are never included.",
            "items": {
              "type": "string",
              "enum": [
                "GB",
                "FR",
                "NO",
                "FI"
              ],
              "enumTitles": [
                "United Kingdom (Companies House)",
                "France (BODACC)",
                "Norway (Brønnøysund)",
                "Finland (PRH)"
              ]
            },
            "default": [
              "GB"
            ]
          },
          "daysBack": {
            "title": "Registered in the last N days",
            "minimum": 1,
            "maximum": 366,
            "type": "integer",
            "description": "Registration window ending today. 7 = the last 7 days including today. Ignored when you set a start date below.",
            "default": 7
          },
          "dateFrom": {
            "title": "From date (optional)",
            "type": "string",
            "description": "First registration day to include (YYYY-MM-DD). Overrides \"last N days\". France: the publication date of the BODACC notice, usually 3–10 days after registration."
          },
          "dateTo": {
            "title": "To date (optional)",
            "type": "string",
            "description": "Last day to include (YYYY-MM-DD). Default: today."
          },
          "activityCodes": {
            "title": "Activity codes (SIC / NACE prefixes)",
            "type": "array",
            "description": "Keep companies whose activity code starts with one of these. UK companies use SIC 2007 (5 digits, based on NACE Rev. 2); Norway and Finland switched to codes based on NACE Rev. 2.1 in 2025, so some classes differ: restaurants are 5610x in the UK but 5611x in Norway and Finland. French companies get their NAF code from the official SIRENE register (see below), e.g. 5610A or 56.10A. A 2-digit prefix works everywhere: \"56\" = food and drink, \"62\" = software and IT, \"41\"–\"43\" = construction, \"68\" = real estate, \"86\" = health.",
            "items": {
              "type": "string"
            }
          },
          "keywords": {
            "title": "Keywords",
            "type": "array",
            "description": "Keep companies whose name or activity description contains one of these words (case and accents ignored), e.g. \"restaurant\", \"software\", \"logiciel\", \"bygg\". Needed for France when you filter by activity.",
            "items": {
              "type": "string"
            }
          },
          "locations": {
            "title": "Locations",
            "type": "array",
            "description": "Keep companies in one of these places. A value with digits is a postal-code prefix (\"SW1\", \"M1\", \"75\", \"0150\", \"00100\"); a word is matched against the address, city and region (\"London\", \"Manchester\", \"Lyon\", \"Oslo\", \"Helsinki\").",
            "items": {
              "type": "string"
            }
          },
          "legalForms": {
            "title": "Legal forms",
            "type": "array",
            "description": "Keep only these legal forms, by abbreviation or name: UK ltd, plc, llp; France SAS, SASU, SARL, EURL, SCI, SA; Norway AS, ASA, ANS, DA, NUF; Finland OY, OYJ, KY, AY. Names like \"limited liability partnership\" also work.",
            "items": {
              "type": "string"
            }
          },
          "enrichFrance": {
            "title": "Add French activity codes (SIRENE)",
            "type": "boolean",
            "description": "BODACC notices have no activity code. When on, each French company that passes your other filters is looked up in the official SIRENE register (recherche-entreprises.api.gouv.fr) to add its NAF code and label, so French companies can be filtered by activity code too. About 3 lookups per second; companies created in the last few days may not have a code yet. No extra charge.",
            "default": true
          },
          "excludeDormant": {
            "title": "Leave out dormant UK companies",
            "type": "boolean",
            "description": "Drop UK companies whose only SIC code is 99999 (Dormant Company) or 74990 (Non-trading company). They are shells, not leads.",
            "default": true
          },
          "onlyNewSinceLastRun": {
            "title": "Only new since last run",
            "type": "boolean",
            "description": "Remember which companies this feed has already delivered and return only new ones, so a weekly schedule (Apify schedule, n8n, Make, Zapier) with an overlapping window never returns or charges the same company twice. Memory is kept per filter combination (or per feed name below) in a key-value store in your account.",
            "default": false
          },
          "stateKey": {
            "title": "Feed name (optional)",
            "type": "string",
            "description": "Name for the feed memory, e.g. \"uk-restaurants\". Use it to keep several schedules apart or to start a feed fresh. Letters, digits, - and _ only."
          },
          "maxItems": {
            "title": "Maximum results",
            "minimum": 1,
            "maximum": 1000000,
            "type": "integer",
            "description": "Stop after this many companies. Newest registrations come first.",
            "default": 100
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Not needed: these are open government registers. Only set a proxy if your runs get rate-limited for a long time."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}