# Siemens Document Downloader — SIOS PDFs (`crawloop/siemens-sieportal-document-downloader`) Actor Download Siemens certificates (CE, UL, CCC, ATEX, FM), manuals, and engineering files from SiePortal & SIOS by part number. Saves PDFs to Key-Value Store with metadata. Filter by document type. - **URL**: https://apify.com/crawloop/siemens-sieportal-document-downloader.md - **Developed by:** [Andrej Kiva](https://apify.com/crawloop) (community) - **Categories:** Developer tools, Automation, Integrations - **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $25.00 / 1,000 downloaded pdfs 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 ## Siemens Document Downloader — SIOS PDFs > **Crawloop Siemens Automation Suite** — Structured data extraction for Siemens SiePortal (Industry Mall), SIOS, and TED product datasheets. Built for procurement teams, system integrators, and BOM engineering workflows. > > Suite hub: [github.com/PLCSPS-DEV/siemens-sieportal-automation](https://github.com/PLCSPS-DEV/siemens-sieportal-automation) > > Product site: [crawloop.com/siemens-automation](https://crawloop.com/siemens-automation.html) | Discovery | Enrichment | SIOS documents | TED datasheets | | :--- | :--- | :--- | :--- | | [Catalog Crawler](https://apify.com/crawloop/siemens-sieportal-product-catalog-crawler?fpr=guboir) | [SiePortal Scraper](https://apify.com/crawloop/siemens-sieportal-scraper?fpr=guboir) | [Document Downloader](https://apify.com/crawloop/siemens-sieportal-document-downloader?fpr=guboir) | [TED Datasheet Downloader](https://apify.com/crawloop/siemens-datasheet-downloader?fpr=guboir) | | | [Lifecycle Tracker](https://apify.com/crawloop/siemens-sieportal-product-lifecycle-tracker?fpr=guboir) | [Document PDF Parser](https://apify.com/crawloop/siemens-sieportal-product-document-pdf-crawler?fpr=guboir) | [TED Datasheet Parser](https://apify.com/crawloop/siemens-datasheet-pdf-crawler?fpr=guboir) | > **Disclaimer:** This is an unofficial integration developed independently of Siemens AG. It is not affiliated with, sponsored by, or endorsed by Siemens AG or any of its subsidiaries. > > **Siemens**, **SiePortal**, **SIMATIC**, and related names are trademarks of Siemens AG. Product data is read from publicly accessible Siemens web sources only; no proprietary databases are redistributed. > > This Actor is provided **for informational and research purposes only** (e.g. procurement research, BOM audits, internal engineering workflows). You are solely responsible for ensuring your use complies with applicable laws, Siemens website terms of use, and your organization's policies. > > No warranty is given as to accuracy, completeness, or continued availability of third-party data. Use at your own risk. Find and download Siemens product documents from **SiePortal** and **SIOS** (Siemens Industry Online Support): certificates (CE, UL, CCC, ATEX, FM), manuals, operating instructions, and engineering files. For each part number, the Actor opens the product documents section on SiePortal, resolves direct download links on SIOS, and saves files to the run **Key-Value Store** with metadata in the dataset. Pair with the [Document PDF Parser](https://apify.com/crawloop/siemens-sieportal-product-document-pdf-crawler?fpr=guboir) to extract structured specifications from downloaded PDFs. This is the **SIOS document pipeline**. For compact TED product datasheets from Industry Mall, use the [TED Datasheet Downloader](https://apify.com/crawloop/siemens-datasheet-downloader?fpr=guboir) instead. ### When to use this Actor Use the **Document Downloader** when you need Siemens compliance certificates, equipment manuals, or engineering files saved as PDFs — not just links. For structured specs extracted from those PDFs, chain with the [Document PDF Parser](https://apify.com/crawloop/siemens-sieportal-product-document-pdf-crawler?fpr=guboir). For web PDP specifications without PDF download, use the [SiePortal Scraper](https://apify.com/crawloop/siemens-sieportal-scraper?fpr=guboir). ### Siemens Automation Pipeline ```` Phase 1 — Discover MPNs Phase 2 — Screen & enrich Phase 3 — Documents & specs ───────────────────────── ───────────────────────── ───────────────────────────── Catalog Crawler ──► MPN list ──► Lifecycle Tracker ──► SiePortal Scraper │ │ ┌────────────────────────────┴────────────────────────────┐ │ │ ▼ ▼ Document Downloader (SIOS) ◄── you are here TED Datasheet Downloader certificates, manuals, CAD compact catalog PDFs │ │ ▼ ▼ Document PDF Parser TED Datasheet Parser specs from SIOS PDFs specs from TED PDFs ```` ### Key Features - **Certificate discovery** — CE, UL, CCC, ATEX, FM, and other compliance documents from SiePortal PDPs. - **Manuals and engineering files** — Knowledge base entries and engineering file tabs on the product page. - **SIOS download resolution** — Resolves direct `attachments/...?download=true` URLs from SIOS document pages. - **Key-Value Store export** — Saves PDFs with predictable keys (`{MPN}_{documentId}_{filename}`). - **Document type filter** — Collect all types or only certificates, manuals, or engineering files. - **Split browser strategy** — SiePortal uses a direct connection; SIOS downloads use the configured proxy to avoid Akamai blocks. ### Input Parameters | Parameter | Description | Default | | :--- | :--- | :--- | | `searchTerms` | **Required.** Siemens part numbers. One per line. | — | | `locale` | SiePortal locale (e.g. `en-us`, `de-de`). | `en-nl` | | `documentTypeFilter` | `all`, `certificates`, `manuals`, `engineering`, or `other`. | `all` | | `downloadFiles` | Save files to Key-Value Store. When `false`, metadata and URLs only. | `true` | | `maxDocumentsPerProduct` | Cap documents processed per MPN. | `20` | | `maxConcurrency` | Parallel part numbers (1–5). | `1` | | `maxDocumentConcurrency` | Parallel document downloads per MPN (1–4). | `2` | | `proxyConfiguration` | **Strongly recommended** when `downloadFiles` is enabled. | — | #### Input Example ```json { "searchTerms": [ "6ES7193-6BP00-0DA0" ], "locale": "en-nl", "documentTypeFilter": "certificates", "downloadFiles": true, "maxDocumentsPerProduct": 10, "maxConcurrency": 2, "maxDocumentConcurrency": 3, "proxyConfiguration": { "useApifyProxy": true } } ```` ### Output Format ```json { "searchTerm": "6ES7193-6BP00-0DA0", "partNumber": "6ES7193-6BP00-0DA0", "pdpUrl": "https://sieportal.siemens.com/en-nl/products-services/detail/6ES7193-6BP00-0DA0", "documentId": "110003392", "category": "Explosion protection/FM, Other", "title": "FM Approvals, Certificate of Compliance, Harzardous (Classified) Location Electrical Equipment", "documentType": "certificates", "siosUrl": "https://support.industry.siemens.com/cs/document/110003392/explosion-protection-fm-other?dti=0&lc=en-NL", "downloadUrl": "https://support.industry.siemens.com/cs/attachments/110003392/ET200SP_FM16US0053XSupp56.pdf?download=true", "fileName": "ET200SP_FM16US0053XSupp56.pdf", "fileSizeKb": 2659, "downloaded": true, "keyValueStoreKey": "6ES7193-6BP00-0DA0_110003392_ET200SP_FM16US0053XSupp56.pdf", "status": "DOWNLOADED", "checkedAt": "2026-06-18T15:00:00+00:00" } ``` #### Status values | `status` | Meaning | | :--- | :--- | | `DOWNLOADED` | File saved to Key-Value Store | | `METADATA_ONLY` | Download URL resolved, `downloadFiles` was `false` | | `NO_DOWNLOAD_LINK` | SIOS page found but no attachment link | | `NO_DOCUMENTS` | Product found, no matching documents on PDP | | `NOT_FOUND` | Part number not found on SiePortal | | `FAILED` | Processing error | ### Typical Workflow ``` Discontinued MPNs (from Lifecycle Tracker) │ ▼ Document Downloader → PDFs in Key-Value Store │ ▼ Document PDF Parser → structured specs from manual PDFs │ ▼ SiePortal Scraper (successor MPNs) → full specs for replacement parts ``` ### Actor Comparison | Task | Document Downloader | Document PDF Parser | SiePortal Scraper | TED Downloader | | :--- | :---: | :---: | :---: | :---: | | Download SIOS PDFs | Yes | No | Links only | No | | Download TED catalog PDFs | No | No | No | Yes | | Parse PDF to structured JSON | No | Yes | No | No | | Bulk lifecycle screening | No | No | Partial | No | ### Pricing Pay-per-event billing. You are charged only for successfully delivered dataset items; `NOT_FOUND`, `FAILED`, `NO_DOCUMENTS`, and `NO_DOWNLOAD_LINK` rows are not billed. | Event | Price | | :--- | :--- | | Actor start | $0.05 per run | | Downloaded document | $25.00 / 1,000 ($0.025 per PDF) | | Metadata-only document | $5.00 / 1,000 ($0.005 per row) | Configure these events in the Apify Store Publication tab: `apify-actor-start`, `downloaded-document`, and `document-item`. Disable `apify-default-dataset-item` to avoid double billing. *** **Learn more:** [Product page](https://crawloop.com/products/siemens-document-downloader.html) · [Suite hub](https://crawloop.com/siemens-automation.html) · [GitHub docs](https://plcsps-dev.github.io/siemens-sieportal-automation/) **Also from Crawloop Industrial:** [Rockwell Automation Suite](https://crawloop.com/rockwell-automation.html) · [GitHub docs](https://plcsps-dev.github.io/rockwell-automation/) # Actor input Schema ## `searchTerms` (type: `array`): List of Siemens part numbers to fetch documents for. One per line. ## `locale` (type: `string`): SiePortal locale path segment (e.g. en-nl, en-us, de-de). Default is en-nl. ## `documentTypeFilter` (type: `string`): Filter which document types to collect from each product page. ## `downloadFiles` (type: `boolean`): When enabled, downloads PDF and other attachments to the run Key-Value Store and returns store keys/URLs in the dataset. ## `maxDocumentsPerProduct` (type: `integer`): Maximum number of documents to process per part number. Default is 20. ## `maxConcurrency` (type: `integer`): How many part numbers to process in parallel. Use 2-3 for faster runs with many MPNs. Default is 1. ## `maxDocumentConcurrency` (type: `integer`): How many documents to download in parallel per part number. Default is 2. Increase to 3-4 for speed; use 1 if downloads fail. ## `proxyConfiguration` (type: `object`): Specifies proxy servers to bypass Akamai blocks. Using Apify rotating proxies is recommended. ## Actor input object example ```json { "searchTerms": [ "6ES7193-6BP00-0DA0" ], "locale": "en-nl", "documentTypeFilter": "all", "downloadFiles": true, "maxDocumentsPerProduct": 20, "maxConcurrency": 1, "maxDocumentConcurrency": 2, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # 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 = { "searchTerms": [ "6ES7193-6BP00-0DA0" ], "locale": "en-nl", "documentTypeFilter": "all", "maxDocumentConcurrency": 2, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("crawloop/siemens-sieportal-document-downloader").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 = { "searchTerms": ["6ES7193-6BP00-0DA0"], "locale": "en-nl", "documentTypeFilter": "all", "maxDocumentConcurrency": 2, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("crawloop/siemens-sieportal-document-downloader").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 '{ "searchTerms": [ "6ES7193-6BP00-0DA0" ], "locale": "en-nl", "documentTypeFilter": "all", "maxDocumentConcurrency": 2, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call crawloop/siemens-sieportal-document-downloader --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawloop/siemens-sieportal-document-downloader", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Siemens Document Downloader — SIOS PDFs", "description": "Download Siemens certificates (CE, UL, CCC, ATEX, FM), manuals, and engineering files from SiePortal & SIOS by part number. Saves PDFs to Key-Value Store with metadata. Filter by document type.", "version": "0.2", "x-build-id": "vnqVBKepCCKucDwQx" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawloop~siemens-sieportal-document-downloader/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawloop-siemens-sieportal-document-downloader", "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/crawloop~siemens-sieportal-document-downloader/runs": { "post": { "operationId": "runs-sync-crawloop-siemens-sieportal-document-downloader", "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/crawloop~siemens-sieportal-document-downloader/run-sync": { "post": { "operationId": "run-sync-crawloop-siemens-sieportal-document-downloader", "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", "required": [ "searchTerms" ], "properties": { "searchTerms": { "title": "Part Numbers (MPNs)", "type": "array", "description": "List of Siemens part numbers to fetch documents for. One per line.", "items": { "type": "string" } }, "locale": { "title": "SiePortal Locale", "type": "string", "description": "SiePortal locale path segment (e.g. en-nl, en-us, de-de). Default is en-nl.", "default": "en-nl" }, "documentTypeFilter": { "title": "Document Type Filter", "enum": [ "all", "certificates", "manuals", "engineering", "other" ], "type": "string", "description": "Filter which document types to collect from each product page.", "default": "all" }, "downloadFiles": { "title": "Download Files", "type": "boolean", "description": "When enabled, downloads PDF and other attachments to the run Key-Value Store and returns store keys/URLs in the dataset.", "default": true }, "maxDocumentsPerProduct": { "title": "Max Documents Per Product", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of documents to process per part number. Default is 20.", "default": 20 }, "maxConcurrency": { "title": "Max Concurrency (MPNs)", "minimum": 1, "maximum": 5, "type": "integer", "description": "How many part numbers to process in parallel. Use 2-3 for faster runs with many MPNs. Default is 1.", "default": 1 }, "maxDocumentConcurrency": { "title": "Max Document Concurrency", "minimum": 1, "maximum": 4, "type": "integer", "description": "How many documents to download in parallel per part number. Default is 2. Increase to 3-4 for speed; use 1 if downloads fail.", "default": 2 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Specifies proxy servers to bypass Akamai blocks. Using Apify rotating proxies is recommended." } } }, "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 } } } } } } } } } } ```