{
  "openapi": "3.0.1",
  "info": {
    "title": "Italy Company Registry Scraper - Registro Imprese, PEC, Bilanci",
    "description": "Scrape Italian company data from ufficiocamerale.it (Registro Imprese): VAT, tax code, REA, legal form, ATECO, registered address, revenue, profit, share capital, employees, SDI code and PEC certified email. Search by name, VAT or REA, or paste direct URLs. No login needed. JSON/CSV.",
    "version": "0.0",
    "x-build-id": "YAn3NKx3DpjFb3QSt"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/memo23~italy-company-registry-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-memo23-italy-company-registry-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/memo23~italy-company-registry-scraper/runs": {
      "post": {
        "operationId": "runs-sync-memo23-italy-company-registry-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/memo23~italy-company-registry-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-memo23-italy-company-registry-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": {
          "query": {
            "title": "Company name or number",
            "type": "string",
            "description": "A company name such as Barilla, or a VAT or REA number. Set the lookup type below to match."
          },
          "mode": {
            "title": "Look up by",
            "enum": [
              "by_vat_number",
              "by_rea_number",
              "by_name"
            ],
            "type": "string",
            "description": "Company name (default) finds companies whose name contains these words. VAT or REA number only finds a company whose ufficiocamerale.it page address contains that number, which most do not; for a sure hit use the name or paste the company page below.",
            "default": "by_name"
          },
          "province": {
            "title": "Chamber of commerce province",
            "type": "string",
            "description": "Optional two-letter province code, e.g. MI, RM, BO or NA. Companies registered with another chamber of commerce are skipped."
          },
          "directUrls": {
            "title": "ufficiocamerale.it company pages",
            "uniqueItems": true,
            "type": "array",
            "description": "Optional links such as https://www.ufficiocamerale.it/6149/barilla-g-e-r-fratelli-societa-per-azioni. When any are given, the name or number above is not used.",
            "items": {
              "type": "string"
            }
          },
          "includePec": {
            "title": "Fill in a missing PEC from INI-PEC",
            "type": "boolean",
            "description": "On (default): when a company page shows no PEC address, the company's VAT or tax code is looked up in the public INI-PEC registry (inipec.gov.it), and pec_source says where the address came from. No extra charge. Off: one request less per company.",
            "default": true
          },
          "enrichEmails": {
            "title": "Enrich with contact emails (experimental)",
            "type": "boolean",
            "description": "When on, each company is looked up by legal name + province to attach contact_email, contact_website and an emailEnrichment object. A website counts only when one of its pages shows the company's codice fiscale (a sole trader's Partita IVA), its registered office or its registered name, which Italian law requires sites to print; website_matched_by says which, and an unconfirmed site goes to website_candidate with no email taken from it. Adds time per row and is charged per enriched record.",
            "default": false
          },
          "maxItems": {
            "title": "Companies in total",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "The run stops after this many companies, default 10, at most 10,000. On the free Apify plan a run stops at 100.",
            "default": 10
          },
          "maxConcurrency": {
            "title": "Company pages read at once",
            "minimum": 1,
            "type": "integer",
            "description": "How many company pages are read in parallel, default 8.",
            "default": 8
          },
          "sp_contact": {
            "title": "Your email, if you would like a reply",
            "type": "string",
            "description": "Optional. We only write back about your feedback."
          },
          "sp_intended_usage": {
            "title": "What will you use the data for?",
            "type": "string",
            "description": "Optional. A sentence is enough, e.g. lead lists for one province or supplier checks."
          },
          "sp_improvement_suggestions": {
            "title": "What should we add or fix?",
            "type": "string",
            "description": "Optional. Missing fields, wrong values, or anything else."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}