# PDF Procurement Document Extractor (`kondasviktor/pdf-procurement-document-extractor`) Actor Find and extract procurement-related PDFs from company websites: certificates, annual/assurance reports, datasheets, and price lists. Ideal for supplier shortlist prep across CEE/EU. - **URL**: https://apify.com/kondasviktor/pdf-procurement-document-extractor.md - **Developed by:** [Viktor Kondas](https://apify.com/kondasviktor) (community) - **Categories:** Automation, Lead generation, AI - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $5.00 / 1,000 procurement document saveds This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 ## PDF Procurement Document Extractor **Find and extract procurement-related PDFs from company websites — certificates, reports, datasheets, price lists.** Standalone Apify actor for supplier shortlist prep across CEE/EU. Pairs well with the [Google Maps CEE Supplier Shortlist Builder](https://apify.com/kondasviktor/google-maps-cee-scraper) and [Website Intelligence + Contact Extractor](https://apify.com/kondasviktor/website-intelligence-contact-extractor) when you already have company websites. **Optional next step after Maps / Website Intel:** feed `website` URLs into this actor to surface procurement PDFs (ISO certs, reports, datasheets). ### What it does - Crawls a company site or downloads/investor page for **PDF links**. - Follows download-like paths (`/downloads`, `/dokumentumok`, `/publications`, `/investor`, `/quality`, …). - Downloads each PDF (capped) and **extracts text** (no OCR at launch). - Classifies documents: certificate, assurance/annual report, datasheet, price list, catalog, policy. - Detects **ISO hints** (9001, 14001, 45001, 27001, …) from filename + text. - Skips full text extract for oversized PDFs (metadata still saved) so Store QA stays fast. - Built for **n8n**, **Make**, **Zapier**, and vibe-coder agent workflows. ### Who it's for 1. **Procurement teams** collecting supplier certificates and reports before outreach. 2. **Sales / channel teams** mining price lists and catalogs from brand sites. 3. **Agencies** running document discovery for client shortlists. 4. **Vibe coders** wiring website → PDF evidence into CRM / n8n / Make / Zapier. 5. **Market researchers** auditing public compliance document footprints. ### What this actor is — and is not This actor helps you **discover and extract public PDF evidence**. It does **not** verify certificate authenticity, accreditation status, or document legal validity. Use the output for: - supplier document discovery - shortlist preparation - compliance evidence collection Do **not** use it as the sole basis for vendor qualification or contract award. ### What data you get | Field | Description | |-------|-------------| | `sourceWebsite` | Input website / start URL | | `pdfUrl`, `fileName`, `documentTitle` | Document identity | | `documentType` | `certificate`, `assurance_report`, `annual_report`, `datasheet`, `price_list`, `catalog`, `policy`, `other` | | `isCertificate`, `isPriceList`, `isDatasheet`, `isAnnualReport` | Boolean flags | | `isoHints` | Detected ISO labels when present | | `pageCount`, `byteSize` | PDF metadata when extracted | | `textExcerpt` | Truncated extracted text | | `foundOnPage` | HTML page where the link was discovered | | `scrapedAt`, `error` | Provenance / skip or failure notes | ### How to use it 1. **Configure input** — website or downloads URL, max PDFs, extract text, proxy. 2. **Run** on Apify cloud (recommended) or locally with `apify run`. 3. **Download** dataset as JSON, CSV, or Excel from the run page. ### Input presets #### MOL Group annual & assurance PDFs (Store / QA example) ```json { "websites": ["https://www.molgroup.info/en/investor-relations/annual-reports"], "maxDocuments": 3, "maxPagesPerSite": 3, "extractText": true, "maxTextChars": 3000, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ```` Store input **prefill** uses this small cap so Apify automated QA finishes within 5 minutes. For production, raise `maxDocuments` (e.g. 20–100). Published Store example: [MOL Group annual & assurance PDFs — procurement docs](https://apify.com/kondasviktor/pdf-procurement-document-extractor/examples/mol-group-annual-assurance-pdfs-procurement-docs). #### After Google Maps / Website Intel ```json { "websites": [ "https://example-supplier.hu/downloads", "https://example-manufacturer.ro/dokumentumok" ], "maxDocuments": 20, "maxPagesPerSite": 8, "extractText": true, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ``` #### Link discovery only (no text extract) ```json { "websites": ["https://www.molgroup.info/en/investor-relations/annual-reports"], "maxDocuments": 10, "extractText": false, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ``` ### Output example ```json { "sourceWebsite": "https://www.molgroup.info/en/investor-relations/annual-reports", "pdfUrl": "https://molgroup.info/en/show/publications/annual_reports/2025/mol-csrd-limited-assurance-report-eng-2025.pdf", "fileName": "mol-csrd-limited-assurance-report-eng-2025.pdf", "documentTitle": "mol csrd limited assurance report eng 2025", "documentType": "assurance_report", "isCertificate": false, "isPriceList": false, "isDatasheet": false, "isAnnualReport": false, "isoHints": [], "pageCount": 5, "byteSize": 387120, "textExcerpt": "Limited assurance …", "foundOnPage": "https://www.molgroup.info/en/investor-relations/annual-reports", "scrapedAt": "2026-07-20T09:30:00.000Z", "error": null } ``` ### Proxy, size limits, and blocked sites | Feature | Support | |---------|---------| | **Apify Proxy RESIDENTIAL** | Recommended for bot-walled corporate sites | | **Browser fallback** | Used when HTML HTTP fails | | **Oversized PDFs** | Metadata saved; text extract skipped above `maxPdfBytes` (default 2.5 MB) | | **No OCR** | Scanned image-only PDFs may return empty `textExcerpt` | **Tips to avoid Store QA timeouts** - Keep prefill / public-task demos at **`maxDocuments: 3`**. - Prefer a downloads/investor page with a few mid-size PDFs over a mega catalog portal. - Raise caps only for paid production runs. ### Secrets and local development - **Never commit** `apify/pdf-procurement-document-extractor/.env` — it is listed in `.gitignore`. - **`apify push` excludes** `.env` via `.gitignore` and `.actorignore`. - **Docker builds exclude** `.env` via `.dockerignore`. - On Apify cloud, customers configure **Proxy** via input — not from your local `.env`. - For local runs only, copy `.env.example` → `.env` and add `APIFY_TOKEN` if you call the platform. - Only `.env.example` (placeholders, no real keys) is in git. ### FAQ **How is this different from a generic PDF-to-text actor?**\ This actor **discovers** PDFs on company sites and adds **procurement classification flags** (certs, reports, datasheets, ISO hints) — not only raw text dump. **Does it work outside CEE?**\ Yes. Marketing ICP is CEE/Europe; any public website with PDF links can work. **Do I need an LLM key?**\ No. Classification is deterministic keyword/heuristic. No Apify AI event fee. **Why was text skipped on a large annual report?**\ `maxPdfBytes` protects run time. Metadata is still saved; raise the limit for production if you need full text. **How many PDFs can I get per run?**\ Up to **200** (`maxDocuments`). Prefill/demo stays at **3**. ### Local development ```bash cd apify/pdf-procurement-document-extractor npm install npm test npm run build npm run dry-run apify run --input-file=INPUT.smoke.json ``` Dry run defaults to MOL Group annual reports with 3 PDFs. Install Playwright Chromium once for local browser fallback: `npx playwright install chromium`. ### Pricing Pay-per-event: **$5.00 per 1,000 document records** (`document` event @ `$0.005`), minimum charge **$0.10** per run. Enable **Pay per event + usage** in Apify Console so platform compute/proxy costs are passed through to users. ### Related actors (suite) | Actor | Role | |-------|------| | [Google Maps CEE Supplier Shortlist](https://apify.com/kondasviktor/google-maps-cee-scraper) | Discover local suppliers | | [Website Intelligence + Contact](https://apify.com/kondasviktor/website-intelligence-contact-extractor) | Enrich websites (contacts, tech, compliance) | | [Dealer / Distributor Locator](https://apify.com/kondasviktor/dealer-distributor-locator) | Expand brand locator pages | | **PDF Procurement Document Extractor** (this Actor) | Find certs / reports / datasheets | | [Website Change Monitor](https://apify.com/kondasviktor/website-change-monitor) | Watch pages for changes | Each Actor runs standalone; use them as an optional suite when chaining discovery → enrichment → monitoring. ### Feedback Open an issue on the actor’s Apify page or contact [Vibe Coder's Life](https://vibecoderslife.com/#contact). # Actor input Schema ## `websites` (type: `array`): Company websites or downloads/dokumentumok/investor pages. Prefill is QA-safe (MOL Group annual reports, max 3 PDFs). ## `maxDocuments` (type: `integer`): Hard cap per run. Prefill stays at 3 so Apify Store QA finishes under 5 minutes. Raise for production (e.g. 20–100). ## `maxPagesPerSite` (type: `integer`): How many HTML pages to visit while discovering PDF links (start URL + download-like pages). ## `extractText` (type: `boolean`): Download each PDF and extract text (no OCR). Disable for link discovery only. ## `maxTextChars` (type: `integer`): Truncate extracted text per PDF to keep runs fast. ## `maxPdfBytes` (type: `integer`): Still save metadata for large PDFs, but skip full text extract when Content-Length exceeds this (default 2.5 MB). ## `requestTimeoutSecs` (type: `integer`): HTTP timeout per page or PDF fetch. ## `proxyConfiguration` (type: `object`): Use Apify Proxy RESIDENTIAL when sites block datacenter IPs. ## Actor input object example ```json { "websites": [ "https://www.molgroup.info/en/investor-relations/annual-reports" ], "maxDocuments": 3, "maxPagesPerSite": 3, "extractText": true, "maxTextChars": 3000, "maxPdfBytes": 2621440, "requestTimeoutSecs": 30, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `overview` (type: `string`): No description ## `dataset` (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 = { "websites": [ "https://www.molgroup.info/en/investor-relations/annual-reports" ], "maxDocuments": 3, "maxPagesPerSite": 3, "extractText": true, "maxTextChars": 3000, "maxPdfBytes": 2621440 }; // Run the Actor and wait for it to finish const run = await client.actor("kondasviktor/pdf-procurement-document-extractor").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 = { "websites": ["https://www.molgroup.info/en/investor-relations/annual-reports"], "maxDocuments": 3, "maxPagesPerSite": 3, "extractText": True, "maxTextChars": 3000, "maxPdfBytes": 2621440, } # Run the Actor and wait for it to finish run = client.actor("kondasviktor/pdf-procurement-document-extractor").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 '{ "websites": [ "https://www.molgroup.info/en/investor-relations/annual-reports" ], "maxDocuments": 3, "maxPagesPerSite": 3, "extractText": true, "maxTextChars": 3000, "maxPdfBytes": 2621440 }' | apify call kondasviktor/pdf-procurement-document-extractor --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=kondasviktor/pdf-procurement-document-extractor", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "PDF Procurement Document Extractor", "description": "Find and extract procurement-related PDFs from company websites: certificates, annual/assurance reports, datasheets, and price lists. Ideal for supplier shortlist prep across CEE/EU.", "version": "0.1", "x-build-id": "Dy6ZUqR0CNmSnGwDf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kondasviktor~pdf-procurement-document-extractor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kondasviktor-pdf-procurement-document-extractor", "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/kondasviktor~pdf-procurement-document-extractor/runs": { "post": { "operationId": "runs-sync-kondasviktor-pdf-procurement-document-extractor", "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/kondasviktor~pdf-procurement-document-extractor/run-sync": { "post": { "operationId": "run-sync-kondasviktor-pdf-procurement-document-extractor", "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": [ "websites" ], "properties": { "websites": { "title": "Company / downloads page URLs", "type": "array", "description": "Company websites or downloads/dokumentumok/investor pages. Prefill is QA-safe (MOL Group annual reports, max 3 PDFs).", "items": { "type": "string" } }, "maxDocuments": { "title": "Max PDFs to save", "minimum": 1, "maximum": 200, "type": "integer", "description": "Hard cap per run. Prefill stays at 3 so Apify Store QA finishes under 5 minutes. Raise for production (e.g. 20–100).", "default": 20 }, "maxPagesPerSite": { "title": "Max HTML pages to crawl per site", "minimum": 1, "maximum": 30, "type": "integer", "description": "How many HTML pages to visit while discovering PDF links (start URL + download-like pages).", "default": 6 }, "extractText": { "title": "Extract PDF text", "type": "boolean", "description": "Download each PDF and extract text (no OCR). Disable for link discovery only.", "default": true }, "maxTextChars": { "title": "Max extracted text characters", "minimum": 200, "maximum": 50000, "type": "integer", "description": "Truncate extracted text per PDF to keep runs fast.", "default": 4000 }, "maxPdfBytes": { "title": "Skip text extract above size (bytes)", "minimum": 100000, "maximum": 20971520, "type": "integer", "description": "Still save metadata for large PDFs, but skip full text extract when Content-Length exceeds this (default 2.5 MB).", "default": 2621440 }, "requestTimeoutSecs": { "title": "Request timeout (seconds)", "minimum": 5, "maximum": 90, "type": "integer", "description": "HTTP timeout per page or PDF fetch.", "default": 30 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Use Apify Proxy RESIDENTIAL when sites block datacenter IPs.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } } ```