{
  "openapi": "3.0.1",
  "info": {
    "title": "Belgian B2B Leads: companies by sector & postcode + financials",
    "description": "Belgian B2B lead lists by sector (NACE) and postcode: KBO company details and contacts plus the latest NBB annual-account figures, ratios and health score. $12 per 1,000 leads with financials, $4 without.",
    "version": "0.0",
    "x-build-id": "LoaEN6Asb8XYS4Q61"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/goobertje~belgium-b2b-lead-builder/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-goobertje-belgium-b2b-lead-builder",
        "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/goobertje~belgium-b2b-lead-builder/runs": {
      "post": {
        "operationId": "runs-sync-goobertje-belgium-b2b-lead-builder",
        "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/goobertje~belgium-b2b-lead-builder/run-sync": {
      "post": {
        "operationId": "run-sync-goobertje-belgium-b2b-lead-builder",
        "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": {
          "naceCodes": {
            "title": "NACE-BEL activity codes (sector)",
            "type": "array",
            "description": "Find companies with one of these NACE-BEL 2025 activity codes (3 to 7 digits, dots allowed, up to 10 codes). Needs at least one postal code. A search returns at most 200 hits, so combine specific codes with a few postal codes. Example: [\"62.100\", \"62.200\"].",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "postalCodes": {
            "title": "Postal codes (area)",
            "type": "array",
            "description": "4-digit Belgian postal codes where an establishment or the registered seat must be. Required together with NACE codes; every group of 4 postal codes is one search. Example: [\"9000\", \"9050\"].",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "searchTerm": {
            "title": "Company name search",
            "type": "string",
            "description": "Phonetic search on company, establishment and trade names (also finds old names). Returns at most 200 hits; add a postal code to narrow it. Leave empty when you search by NACE code. Example: \"delhaize\"."
          },
          "searchPostalCode": {
            "title": "Postal code for name search",
            "pattern": "^$|^[0-9]{4}$",
            "type": "string",
            "description": "Optional 4-digit postal code that narrows the name search. Only works together with a company name. Example: \"1000\"."
          },
          "enterpriseNumbers": {
            "title": "Enterprise numbers (enrich your own list)",
            "type": "array",
            "description": "Belgian enterprise numbers (ondernemingsnummer / numero d'entreprise) to enrich, with or without dots or the BE prefix. Numbers with a wrong check digit are ignored. These are always looked up, whatever their legal status. Example: [\"0403.199.702\", \"BE0202239951\"].",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "legalForms": {
            "title": "Legal form filter",
            "type": "array",
            "description": "Keep only companies whose legal form contains one of these texts, in English as shown by KBO (case-insensitive). Applies to discovered companies, not to explicit enterprise numbers. Example: [\"private limited company\", \"public limited company\"].",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "startedSince": {
            "title": "Started on or after",
            "type": "string",
            "description": "Keep only discovered companies whose enterprise start date is on or after this date (YYYY-MM-DD). Leave empty for no limit. Example: \"2024-01-01\"."
          },
          "startedWithinDays": {
            "title": "Started within last N days",
            "minimum": 0,
            "maximum": 36500,
            "type": "integer",
            "description": "Rolling alternative to Started on or after, for scheduled feeds: keep only discovered companies that started in the last N days. 0 = off. When both are set, the later date wins.",
            "default": 0
          },
          "onlyActive": {
            "title": "Only active companies",
            "type": "boolean",
            "description": "Skip stopped or otherwise not-active companies found by discovery. Default: true. Explicit enterprise numbers are returned whatever their status.",
            "default": true
          },
          "includeEstablishmentUnits": {
            "title": "Include establishment rows in the search",
            "type": "boolean",
            "description": "Discovery only. When off, the search returns enterprises only, so matches come from the registered seat. Recommended for 'new companies' feeds with a start-date filter, because every establishment row in the results would otherwise cost one request just to learn its start date, which can trigger KBO throttling. Trade-off: a company seated elsewhere that only has a branch in your postal code is not found. On (default) keeps the full search.",
            "default": true
          },
          "newestFirst": {
            "title": "Newest enterprise numbers first (new-company feeds)",
            "type": "boolean",
            "description": "For feeds of newly founded companies. Checks the highest (newest) enterprise numbers first and stops when the results are clearly older than your start-date filter, so a run costs about one request per new company plus a few, instead of one per search hit. It relies on enterprise numbers being issued in order, so it can miss a company whose start date is later than its registration order suggests. Only has an effect together with Started on or after or Started within last N days. Off (default) checks every search hit.",
            "default": false
          },
          "requireFinancials": {
            "title": "Require financials",
            "type": "boolean",
            "description": "Drop companies that have no usable NBB annual accounts (none filed, only PDF or consolidated filings, or the lookup failed). Without this switch such companies are still delivered, as cheaper basic leads. Default: false.",
            "default": false
          },
          "minFte": {
            "title": "Minimum employees (FTE)",
            "minimum": 0,
            "type": "number",
            "description": "Keep only companies whose latest annual accounts report at least this many full-time equivalents. A company that reports no FTE figure fails this filter (small companies often file a model without it). Leave empty for no limit. Example: 10."
          },
          "maxFte": {
            "title": "Maximum employees (FTE)",
            "minimum": 0,
            "type": "number",
            "description": "Keep only companies whose latest annual accounts report at most this many full-time equivalents. A company that reports no FTE figure fails this filter. Leave empty for no limit. Example: 250."
          },
          "minTotalAssetsEur": {
            "title": "Minimum total assets (EUR)",
            "type": "number",
            "description": "Keep only companies whose latest annual accounts show at least this balance-sheet total, in euros. A company with no figure fails this filter. Leave empty for no limit. Example: 500000."
          },
          "minHealthScore": {
            "title": "Minimum health score (0-100)",
            "minimum": 0,
            "maximum": 100,
            "type": "number",
            "description": "Keep only companies whose transparent financial health score (0-100, see README) is at least this value. A company with no score fails this filter. Leave empty for no limit. Example: 60."
          },
          "onlyNewLeads": {
            "title": "Only new leads (delta mode)",
            "type": "boolean",
            "description": "Remember every delivered lead in a named key-value store and skip them on later runs, so a scheduled run only returns leads you did not receive before. Skipped leads are not billed. The first run returns everything that matches. Default: false.",
            "default": false
          },
          "stateStoreName": {
            "title": "State store name",
            "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
            "minLength": 3,
            "maxLength": 63,
            "type": "string",
            "description": "Name of the persistent key-value store that holds the delta state. Use a different name per lead feed. Only lowercase letters, digits and hyphens (not at the start or end), 3 to 63 characters. Default: \"lead-builder-state\".",
            "default": "lead-builder-state"
          },
          "maxItems": {
            "title": "Max leads",
            "minimum": 1,
            "maximum": 100000,
            "type": "integer",
            "description": "Maximum number of leads (dataset rows, each one billed) a run delivers; the run stops once reached. This caps the cost of a run. Default: 50. Example: 100.",
            "default": 50
          },
          "maxCandidates": {
            "title": "Max candidates to check",
            "minimum": 1,
            "maximum": 100000,
            "type": "integer",
            "description": "Upper limit of companies examined in one run, so strict filters cannot run forever. Companies rejected by a filter cost requests (about 1.5 seconds each) but are not billed. Default: 500. Example: 1000.",
            "default": 500
          },
          "requestDelaySecs": {
            "title": "Delay between requests (seconds)",
            "minimum": 1,
            "maximum": 30,
            "type": "number",
            "description": "Pause between requests to the same source (KBO and NBB each), to stay polite. Minimum 1, maximum 30. Default: 1.5.",
            "default": 1.5
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}