# Italy Registro Imprese Scraper - Bilanci, PEC, UBO (`jungle_synthesizer/italy-registroimprese-bilanci-scraper`) Actor Scrape Italian company data: REA, VAT, capital, directors, shareholders, PEC email, ATECO code, bilancio (revenue, EBITDA, profit), beneficial owners. KYC/KYB and B2B prospecting. - **URL**: https://apify.com/jungle\_synthesizer/italy-registroimprese-bilanci-scraper.md - **Developed by:** [BowTiedRaccoon](https://apify.com/jungle_synthesizer) (community) - **Categories:** Business, Lead generation, Other - **Stats:** 3 total users, 1 monthly users, 63.6% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per event This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Italy Registro Imprese Scraper Scrapes Italian company data from [ufficiocamerale.it](https://www.ufficiocamerale.it), the public access portal for Italy's Camera di Commercio registry. Returns 25+ fields per company — VAT number, REA registration, legal form, registered address, ATECO code, share capital, directors, shareholders, PEC certified email, bilancio filing status, and insolvency indicators. --- ### Italy Registro Imprese Scraper Features - Extracts 25+ fields per company from the official Italian commercial registry - Searches by company name, VAT number (Partita IVA), or REA registration code - Filters results by province (CCIAA two-letter code) in name search mode - Enriches records with PEC certified email via the INI-PEC government registry - Detects bilancio (annual accounts) filing status and links to XBRL filings - Returns directors and shareholders as structured pipe-delimited strings — name|role format - Flags active insolvency proceedings per company - Accepts direct company page URLs to skip discovery when you already have the link - Handles Italy-geolocated residential proxies and CF bot protection automatically --- ### What Can You Do With Italian Registry Data? - **KYC/KYB compliance teams** — verify company identity, legal form, registration date, and VAT against authoritative source before onboarding - **B2B sales and lead generation** — build prospect lists filtered by ATECO industry code, province, and company size - **Credit analysts and investors** — check bilancio filing status, share capital, and insolvency flags before extending credit or investing - **Legal and due diligence professionals** — extract directors, shareholders, and REA data for ownership structure analysis - **Accountants and tax advisors** — bulk-retrieve PEC certified email addresses for invoice delivery and official correspondence - **Data enrichment pipelines** — append Italian company attributes to CRM records using VAT as the join key --- ### How Italy Registro Imprese Scraper Works 1. **Provide a query.** Enter a company name, VAT number, or REA code. Or paste direct company page URLs to skip discovery entirely. 2. **The scraper obtains CF clearance.** ufficiocamerale.it sits behind Cloudflare bot management. The scraper handles the bypass automatically using residential proxies geo-targeted to Italy — you don't configure anything. 3. **Company URLs are discovered via Wayback CDX index.** Rather than submitting the search form (which CF WAF blocks at the application layer), the scraper queries the Wayback Machine's CDX API to find company page URLs. It streams results and stops early once enough matches are found. 4. **Each company detail page is fetched and parsed.** Server-rendered HTML with structured field IDs. Data is extracted field by field and optionally enriched with PEC from INI-PEC gov. --- ### Input ```json { "mode": "by_name", "query": "BCC Felsinea", "province": "BO", "includePec": true, "maxItems": 10 } ```` | Field | Type | Default | Description | |-------|------|---------|-------------| | `mode` | string | `by_name` | Search mode: `by_name`, `by_vat_number`, or `by_rea_number` | | `query` | string | — | Company name, VAT number (e.g. `00159560366`), or REA code (e.g. `MO-187940`) | | `province` | string | — | Two-letter CCIAA province code to filter results (e.g. `MI`, `RM`, `BO`). Name mode only. | | `includePec` | boolean | `true` | Look up PEC certified email from INI-PEC gov registry when not available on company page | | `directUrls` | array | — | List of exact ufficiocamerale.it company page URLs. Bypasses search and CDX discovery. | | `maxItems` | integer | `10` | Maximum companies to return (1–10,000) | **Direct URL input** — when you already have the company page link: ```json { "directUrls": [ "https://www.ufficiocamerale.it/1295/bcc-felsinea-banca-di-credito-cooperativo-dal-1902-sc" ], "includePec": false, "maxItems": 1 } ``` **VAT number lookup** — finds companies whose VAT appears in their URL slug. Most companies use their name in the URL, so `by_name` mode is more reliable for general searches: ```json { "mode": "by_vat_number", "query": "00507231207", "maxItems": 1 } ``` *** ### Italy Registro Imprese Scraper Output Fields ```json { "vat_number": "00507231207", "tax_code": "00389400375", "rea_number": "BO-16539", "cciaa_chamber": "BO", "legal_name": "BCC FELSINEA - BANCA DI CREDITO COOPERATIVO DAL 1902 - SOCIETA' COOPERATIVA", "trade_name": null, "legal_form": "SOCIETA' COOPERATIVA", "status": "ATTIVA", "incorporation_date": "16/02/1902", "cessation_date": null, "share_capital_eur": null, "registered_address": "VIA CADUTI DI SABBIUNO 3 - 40068 - SAN LAZZARO DI SAVENA (BO)", "ateco_code": "64191", "ateco_description": "Altre intermediazioni monetarie fornite da istituti monetari diversi dalla banca centrale", "employees_count": 206, "pec_email": "bccfelsinea@pec.bccfelsinea.it", "phone": null, "website": null, "codice_destinatario": null, "amministratori": "MARIO ROSSI|PRESIDENTE DEL CONSIGLIO DI AMMINISTRAZIONE", "soci": null, "has_filed_bilancio": true, "latest_bilancio_year": 2023, "bilancio_xbrl_url": "https://www.ufficiocamerale.it/visure-camerali/bilancio-aziendale", "has_insolvency": false, "last_modification_date": null, "source_url": "https://www.ufficiocamerale.it/1295/bcc-felsinea-banca-di-credito-cooperativo-dal-1902-sc", "scraped_at": "2025-01-15T08:22:43.000Z" } ``` | Field | Type | Description | |-------|------|-------------| | `vat_number` | string | Partita IVA — 11-digit Italian VAT number | | `tax_code` | string | Codice Fiscale — tax code (may differ from VAT for individuals) | | `rea_number` | string | REA registration number with province prefix (e.g. `NA-924731`) | | `cciaa_chamber` | string | Camera di Commercio province code (e.g. `NA`, `MI`) | | `legal_name` | string | Denominazione sociale — official registered legal name | | `trade_name` | string | Nome commerciale — trading name if different from legal name | | `legal_form` | string | Forma giuridica — entity type (SRL, SPA, SS, SAS, SNC, SRLS, etc.) | | `status` | string | Registry status: `attiva`, `cessata`, `sospesa`, `fallita` | | `incorporation_date` | string | Date registered with Camera di Commercio (DD/MM/YYYY) | | `cessation_date` | string | Date company ceased activities (null if active) | | `share_capital_eur` | number | Capitale sociale — share capital in EUR | | `registered_address` | string | Sede legale — registered address as formatted string | | `ateco_code` | string | Codice ATECO 2007 — Italian activity code (NACE equivalent) | | `ateco_description` | string | Description of the ATECO activity code | | `employees_count` | number | Estimated number of employees (most recent year) | | `pec_email` | string | Posta Elettronica Certificata — certified email address | | `phone` | string | Telephone number if publicly available | | `website` | string | Company website URL if publicly available | | `codice_destinatario` | string | SDI Codice Destinatario — 7-character electronic invoicing code | | `amministratori` | string | Directors and officers — pipe-separated `name\|role` list | | `soci` | string | Shareholders — pipe-separated `name\|percentage` list | | `has_filed_bilancio` | boolean | Whether company has filed annual accounts with the registry | | `latest_bilancio_year` | number | Most recent year for which bilancio was filed | | `bilancio_xbrl_url` | string | URL to XBRL bilancio filing on registroimprese.it | | `has_insolvency` | boolean | Whether active insolvency proceedings are recorded | | `last_modification_date` | string | Date of most recent registry modification | | `source_url` | string | URL of the source company profile page | | `scraped_at` | string | ISO timestamp when the record was scraped | *** ### 🔍 FAQ #### How do I search Italian companies by name? Italy Registro Imprese Scraper converts your query into URL slug words and matches them against the Wayback CDX index of ufficiocamerale.it. Set `mode` to `by_name` and enter the company name in `query`. Add a `province` code to narrow results geographically. Short or common names may return more candidates than expected — use `province` to filter. #### Can I look up a company by VAT number (Partita IVA)? Italy Registro Imprese Scraper supports `by_vat_number` mode, but with a caveat worth knowing: most Italian companies use their name (not their VAT number) in their profile URL slug. The VAT lookup only finds companies whose VAT number appears in the URL, which is a subset of the full registry. For reliable lookups, use `by_name` mode with the company name, or supply `directUrls` if you already have the profile link. #### How much does Italy Registro Imprese Scraper cost to run? Italy Registro Imprese Scraper uses PPE pricing at approximately $0.002 per company record, plus a $0.10 fixed start fee per run. A 100-company run costs roughly $0.30. Runs with `includePec: true` add minor overhead for INI-PEC lookups but do not change the per-record price. #### What is PEC email and why does it matter? PEC (Posta Elettronica Certificata) is Italy's certified electronic mail system — legally equivalent to registered postal mail for official communications, required for invoicing and public administration. Every active Italian company has a PEC address registered with INI-PEC gov. Enable `includePec: true` to fetch it automatically when not listed on the company page. #### Does Italy Registro Imprese Scraper require proxies? Italy Registro Imprese Scraper handles proxy configuration automatically. ufficiocamerale.it is protected by Cloudflare bot management, so the scraper uses residential proxies geo-targeted to Italy. You don't configure any proxy settings — it's built in. *** ### Need More Features? Need custom fields, bulk REA lookups, bilancio financial data extraction, or a different Italian registry source? [File an issue](https://console.apify.com/actors/aWXBlOkiH1woXIUGl/issues) or get in touch. ### Why Use Italy Registro Imprese Scraper? - **Authoritative source** — data comes directly from ufficiocamerale.it, the public gateway to Italy's official Camera di Commercio registry, not a data reseller - **25+ fields per company** — covers the full KYC/KYB surface: identity, structure, financials, certified contact, and insolvency status, which is more than most Italian company data sources provide in a single call - **PEC enrichment included** — automatically fetches certified email from INI-PEC gov registry, so your outreach reaches the legal inbox # Actor input Schema ## `sp_intended_usage` (type: `string`): Please describe how you plan to use the data extracted by this crawler. ## `sp_improvement_suggestions` (type: `string`): Provide any feedback or suggestions for improvements. ## `sp_contact` (type: `string`): Provide your email address so we can get in touch with you. ## `mode` (type: `string`): No description ## `query` (type: `string`): Company name, VAT number (e.g. 00159560366), or REA number (e.g. MO-187940) ## `province` (type: `string`): Filter by Italian province two-letter code (e.g. MI, RM, TO, NA). Only used in by\_name mode. ## `includePec` (type: `boolean`): Look up PEC (certified email) from INI-PEC registry for each company. ## `directUrls` (type: `array`): Provide exact ufficiocamerale.it company page URLs to skip search and fetch directly. Overrides query/mode. Example: https://www.ufficiocamerale.it/1295/bcc-felsinea-banca-di-credito-cooperativo-dal-1902-sc ## `maxItems` (type: `integer`): Maximum number of companies to return. ## Actor input object example ```json { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "mode": "by_name", "query": "BCC Felsinea", "includePec": true, "maxItems": 10 } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "mode": "by_name", "query": "BCC Felsinea", "includePec": true, "maxItems": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("jungle_synthesizer/italy-registroimprese-bilanci-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "mode": "by_name", "query": "BCC Felsinea", "includePec": True, "maxItems": 10, } # Run the Actor and wait for it to finish run = client.actor("jungle_synthesizer/italy-registroimprese-bilanci-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "mode": "by_name", "query": "BCC Felsinea", "includePec": true, "maxItems": 10 }' | apify call jungle_synthesizer/italy-registroimprese-bilanci-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=jungle_synthesizer/italy-registroimprese-bilanci-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Italy Registro Imprese Scraper - Bilanci, PEC, UBO", "description": "Scrape Italian company data: REA, VAT, capital, directors, shareholders, PEC email, ATECO code, bilancio (revenue, EBITDA, profit), beneficial owners. KYC/KYB and B2B prospecting.", "version": "1.0", "x-build-id": "xxQi6IpGazgqX6263" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jungle_synthesizer~italy-registroimprese-bilanci-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jungle_synthesizer-italy-registroimprese-bilanci-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/jungle_synthesizer~italy-registroimprese-bilanci-scraper/runs": { "post": { "operationId": "runs-sync-jungle_synthesizer-italy-registroimprese-bilanci-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/jungle_synthesizer~italy-registroimprese-bilanci-scraper/run-sync": { "post": { "operationId": "run-sync-jungle_synthesizer-italy-registroimprese-bilanci-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": { "sp_intended_usage": { "title": "What is the intended usage of this data?", "minLength": 1, "type": "string", "description": "Please describe how you plan to use the data extracted by this crawler." }, "sp_improvement_suggestions": { "title": "How can we improve this crawler for you?", "minLength": 1, "type": "string", "description": "Provide any feedback or suggestions for improvements." }, "sp_contact": { "title": "Contact Email", "minLength": 1, "type": "string", "description": "Provide your email address so we can get in touch with you." }, "mode": { "title": "Query Mode", "enum": [ "by_name", "by_vat_number", "by_rea_number" ], "type": "string", "description": "" }, "query": { "title": "Search Query", "type": "string", "description": "Company name, VAT number (e.g. 00159560366), or REA number (e.g. MO-187940)" }, "province": { "title": "Province (CCIAA)", "type": "string", "description": "Filter by Italian province two-letter code (e.g. MI, RM, TO, NA). Only used in by_name mode." }, "includePec": { "title": "Include PEC Email Lookup", "type": "boolean", "description": "Look up PEC (certified email) from INI-PEC registry for each company." }, "directUrls": { "title": "Direct Company URLs", "type": "array", "description": "Provide exact ufficiocamerale.it company page URLs to skip search and fetch directly. Overrides query/mode. Example: https://www.ufficiocamerale.it/1295/bcc-felsinea-banca-di-credito-cooperativo-dal-1902-sc", "items": { "type": "string" } }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of companies to return.", "default": 10 } } }, "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 } } } } } } } } } } ```