{
  "openapi": "3.0.1",
  "info": {
    "title": "NICEIC Registered Electricians Scraper - UK Contractor Leads",
    "description": "From $4 per 1,000 contractors, no start fee. The official NICEIC register of Part P electricians by UK postcode, area or all UK: company, phone, email, website, address, coordinates, schemes (Approved Contractor, Domestic Installer, MCS). Deduped across searches. Filter by solar, heat pumps, fire.",
    "version": "0.1",
    "x-build-id": "ARes3O7lQXXHDBhUT"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scrapersdelight~niceic-registered-contractors-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scrapersdelight-niceic-registered-contractors-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/scrapersdelight~niceic-registered-contractors-scraper/runs": {
      "post": {
        "operationId": "runs-sync-scrapersdelight-niceic-registered-contractors-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/scrapersdelight~niceic-registered-contractors-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-scrapersdelight-niceic-registered-contractors-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": {
          "postcodes": {
            "title": "UK postcodes to search",
            "type": "array",
            "description": "One search per FULL UK postcode (e.g. \"M1 1AE\"). NICEIC answers every search with at most the 50 nearest registered contractors, nearest first, within about 20 miles. Anything that is not a full UK postcode is skipped and listed in RUN_SUMMARY.invalidPostcodes - bare outcodes such as \"E1\" are not searched because the register returns 0 for many of them. Leave postcodes, areas and company names all empty to run the one-postcode demo (SW1A 1AA).",
            "items": {
              "type": "string"
            }
          },
          "areas": {
            "title": "Postcode areas or districts to sweep",
            "type": "array",
            "description": "Sweep whole areas from a bundled grid of 2,944 UK postcode districts and 11,058 sectors, each searched from a real postcode near its centre. Accepts a district (\"LS6\", \"SW1A\"), a postcode area - letters only (\"M\" = every Manchester district, \"BT\" = Northern Ireland) - or \"ALL\" for the whole UK. Any district whose search hits the 50-result cap is re-searched from each of its sectors (see subdivideSaturated). Contractors seen by several overlapping searches are delivered and charged once.",
            "items": {
              "type": "string"
            }
          },
          "companyNames": {
            "title": "Company names to look up",
            "type": "array",
            "description": "Search the register by business name instead of by place, e.g. to check whether a named firm is NICEIC-registered. Each name is one search and returns at most 50 matches. Name matches have no distance, so distanceMiles is null on those rows.",
            "items": {
              "type": "string"
            }
          },
          "services": {
            "title": "Only contractors offering (all of) these services",
            "type": "array",
            "description": "Tick NICEIC's own service checkboxes on every search - server-side, so a filtered search costs fewer pages. Ticking several means ALL of them (measured: Solar Panels 5 + Heat Pumps 2 = 0 in SW1A 1AA). Important: a filtered search returns the matching subset of the SAME 50 nearest contractors, it does not reach further out, so a filtered area sweep searches every sector. The form has no EV-charger checkbox.",
            "items": {
              "type": "string",
              "enum": [
                "Fault Finding",
                "Rewire",
                "New Consumer Unit",
                "Extra Circuits",
                "Electrical Safety Report",
                "Rental Safety Report",
                "Repair and Maintenance",
                "Installation",
                "New Build",
                "Hazardous Areas - Rail",
                "Hazardous Areas - Filling Stations",
                "Hazardous Areas - Combustible Dust",
                "Hazardous Areas - Explosive Gases / Vapours",
                "Hazardous Areas - Landfill Sites",
                "Hazardous Areas - Water Industry",
                "Solar Panels (Power)",
                "Solar Thermal (Heat)",
                "Heat Pumps",
                "Fire System Installations",
                "Fire System Commissioning",
                "Fire System Design",
                "Fire System Maintenance",
                "Air Conditioning",
                "Mechanical Ventilation",
                "Cavity Wall Insulation",
                "Roof Insulation",
                "Floor Insulation",
                "External Wall Insulation",
                "Internal Wall Insulation",
                "Room in Roof Insulation",
                "Gas Systems",
                "Oil Systems",
                "Solid Fuel Systems",
                "Electric Systems"
              ]
            }
          },
          "tagServices": {
            "title": "Tag each contractor with these services",
            "type": "array",
            "description": "For every search, run one extra filtered search per service listed here and record on each row which of them the contractor offers (services) and which were checked (servicesChecked) - so an empty services list means checked-and-not-offered, and null means not checked. Each listed service adds one search (usually 2 requests) per base search; \"ALL\" checks all 34 and makes a run roughly 5-8x slower. Adds no charge.",
            "items": {
              "type": "string",
              "enum": [
                "ALL",
                "Fault Finding",
                "Rewire",
                "New Consumer Unit",
                "Extra Circuits",
                "Electrical Safety Report",
                "Rental Safety Report",
                "Repair and Maintenance",
                "Installation",
                "New Build",
                "Hazardous Areas - Rail",
                "Hazardous Areas - Filling Stations",
                "Hazardous Areas - Combustible Dust",
                "Hazardous Areas - Explosive Gases / Vapours",
                "Hazardous Areas - Landfill Sites",
                "Hazardous Areas - Water Industry",
                "Solar Panels (Power)",
                "Solar Thermal (Heat)",
                "Heat Pumps",
                "Fire System Installations",
                "Fire System Commissioning",
                "Fire System Design",
                "Fire System Maintenance",
                "Air Conditioning",
                "Mechanical Ventilation",
                "Cavity Wall Insulation",
                "Roof Insulation",
                "Floor Insulation",
                "External Wall Insulation",
                "Internal Wall Insulation",
                "Room in Roof Insulation",
                "Gas Systems",
                "Oil Systems",
                "Solid Fuel Systems",
                "Electric Systems"
              ]
            }
          },
          "requireSchemes": {
            "title": "Only contractors in these schemes",
            "type": "array",
            "description": "Keep a row only if one of its NICEIC scheme memberships contains one of these words, case-insensitive - e.g. \"Approved Contractor\", \"Domestic Installer\", \"MCS\", \"TrustMark\", \"BAFE\", \"Competent Person\", \"Certification Scotland\". Excluded rows are never delivered and never charged.",
            "items": {
              "type": "string"
            }
          },
          "requirePhone": {
            "title": "Only deliver contractors with a phone number",
            "type": "boolean",
            "description": "Excluded rows are never delivered and never charged. Measured on 450 rows on 2026-09-22: 445 published a valid UK number, so this usually removes about 1%.",
            "default": false
          },
          "maxContractors": {
            "title": "Maximum contractors to deliver",
            "minimum": 0,
            "type": "integer",
            "description": "Hard stop on delivered - and therefore charged - rows across the run, counted AFTER deduplication. 0 means no cap (needed for a whole-area sweep). The cap is checked against rows produced, never overshoots, and the searches stop once it is reached.",
            "default": 50
          },
          "subdivideSaturated": {
            "title": "Re-search saturated districts sector by sector",
            "type": "boolean",
            "description": "When a district search returns the site cap of 50, search again from each of that district's sectors so dense towns are not cut off at 50. Turn off for a quick one-search-per-district sample. RUN_SUMMARY.coverage reports how much of the requested area the searches reached.",
            "default": true
          },
          "maxSearches": {
            "title": "Maximum searches",
            "minimum": 0,
            "type": "integer",
            "description": "Safety stop on the number of base searches (each is up to 9 requests). 0 means no limit. A whole-UK sweep is several thousand searches.",
            "default": 0
          },
          "concurrency": {
            "title": "Concurrent searches",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "Searches run in parallel, each on its own session. Every search is itself a strict serial chain (form, search, then Next page by page), so this is the only lever on speed.",
            "default": 4
          },
          "saveRawPages": {
            "title": "Save raw result pages (debugging)",
            "type": "boolean",
            "description": "Store the first 60 raw HTML pages of the run in the key-value store as RAW_* records, exactly as NICEIC returned them. For diagnosing a change on the site; off for normal use.",
            "default": false
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "The register has no bot wall in front of it and answered Apify's own servers directly in testing, so the default is no proxy. If RUN_SUMMARY.failures fills with transport errors, switch to RESIDENTIAL or your own proxy - each saturated search downloads about 1.4 MB, which residential proxy traffic bills for.",
            "default": {
              "useApifyProxy": false
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}