{ "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. Cloudflare handled. JSON/CSV.", "version": "0.0", "x-build-id": "xAw7aVlHJBik1H0n0" }, "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": { "mode": { "title": "Search mode", "enum": [ "by_name", "by_vat_number", "by_rea_number" ], "type": "string", "description": "How to interpret the Search query. by_name matches the company name in the page URL slug; by_vat_number / by_rea_number match companies whose VAT / REA appears in the slug.", "default": "by_name" }, "query": { "title": "Search query", "type": "string", "description": "Company name (e.g. BCC Felsinea), VAT number (e.g. 00159560366) or REA code (e.g. MO-187940), matching the selected mode." }, "province": { "title": "Province (CCIAA)", "type": "string", "description": "Optional two-letter Italian province code to filter name-search results (e.g. MI, RM, BO, NA). Applied to the company's registered chamber of commerce." }, "directUrls": { "title": "Direct company URLs", "uniqueItems": true, "type": "array", "description": "Exact ufficiocamerale.it company page URLs (e.g. https://www.ufficiocamerale.it/1295/bcc-felsinea-banca-di-credito-cooperativo-dal-1902-sc). Overrides mode/query.", "items": { "type": "string" } }, "maxItems": { "title": "Maximum companies to return", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Hard cap on the number of company records collected.", "default": 10 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "type": "integer", "description": "Maximum number of company pages fetched in parallel.", "default": 8 }, "includePec": { "title": "Look up missing PEC on INI-PEC", "type": "boolean", "description": "When the company page has no PEC, look the VAT / tax code up on the public INI-PEC registry (inipec.gov.it). On by default. No extra charge. Turn off to skip the extra request.", "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 }, "sp_intended_usage": { "title": "What is the intended usage of this data?", "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?", "type": "string", "description": "Provide any feedback or suggestions for improvements." }, "sp_contact": { "title": "Contact email", "type": "string", "description": "Provide your email address so we can get in touch with you." } } }, "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 } } } } } } } } } }