# UNGM Contract Awards Scraper (`automation-lab/ungm-contract-awards-scraper`) Actor Track UNGM public contract awards with suppliers, UN agencies, countries, dates, values, categories and detail URLs for procurement intelligence. - **URL**: https://apify.com/automation-lab/ungm-contract-awards-scraper.md - **Developed by:** [Stas Persiianenko](https://apify.com/automation-lab) (community) - **Categories:** Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.02 / 1,000 contract award saveds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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 ## UNGM Contract Awards Scraper Extract public UN Global Marketplace contract award records from UNGM with winning suppliers, agencies, countries, dates, references, values, UNSPSC categories, descriptions and source URLs. ### What does UNGM Contract Awards Scraper do? This actor searches the public UNGM Contract Awards portal and saves structured awarded-contract records. It uses the public search endpoint and optional detail pages, so you can turn procurement award listings into a clean dataset for analysis, monitoring, spreadsheets, CRMs, dashboards or data warehouses. ### Who is it for? - 🧑‍💼 Suppliers tracking which competitors win UN contracts. - 📊 Procurement analysts building award-value and category reports. - 🏢 Bid teams researching agencies, countries and recurring procurement patterns. - 🔎 Market-intelligence teams monitoring vendors and award references. - 🤝 Partnerships teams looking for active suppliers in UN procurement categories. ### Why use this actor? UNGM's website is useful for browsing, but procurement teams often need repeatable exports. This actor automates the public search workflow, paginates results, enriches each award with detail-page fields when requested and returns one normalized row per award. ### Data you can extract | Field | Description | | --- | --- | | `awardId` | UNGM award ID | | `title` | Contract award title | | `reference` | Award or procurement reference | | `supplier` | Winning vendor/supplier | | `organization` | Full UN organization name | | `organizationShortName` | Short agency code from search results | | `awardDate` | Award date as displayed by UNGM | | `awardDateIso` | Parsed ISO date when possible | | `country` | Primary country or territory | | `countries` | All countries listed on detail page | | `contractValue` | Numeric value when published | | `currency` | Currency, usually from the value label | | `description` | Award description from the detail page | | `unspscCodes` | UNSPSC category codes | | `unspscCategories` | UNSPSC category labels | | `detailUrl` | Public award detail page | | `sourceUrl` | UNGM search page | | `scrapedAt` | Timestamp of extraction | ### How much does it cost to scrape UNGM contract awards? The actor uses pay-per-event pricing. You pay a small run-start fee and then per contract award saved. The default input is intentionally modest, and you can control `maxItems` to keep the first run small. ### How to use 1. Open the actor on Apify. 2. Choose a maximum number of awards. 3. Optionally add title, supplier, reference, description or date filters. 4. Keep detail pages enabled if you need values, descriptions and UNSPSC categories. 5. Run the actor and export the dataset as JSON, CSV, Excel, XML or RSS. ### Input options - `maxItems` limits saved award records. - `title` filters award titles. - `supplier` filters winning vendors. - `reference` filters award references. - `description` filters award descriptions. - `awardFrom` and `awardTo` accept UNGM-style dates such as `01-Jan-2026`. - `includeDetails` controls whether detail pages are opened. - `startPage` lets advanced users resume from a later zero-based page. - `sortField` and `sortAscending` mirror UNGM search sorting. ### Example input ```json { "maxItems": 100, "title": "transportation", "includeDetails": true } ```` ### Example output ```json { "awardId": "157547", "title": "Provision of VIP Transportation Services for ILO Staff", "reference": "rfx_6600_ROAF", "supplier": "Go Bus", "organization": "International Labour Organization", "organizationShortName": "ILO", "awardDate": "08-Jul-2026", "awardDateIso": "2026-07-08", "country": "Egypt", "countries": ["Egypt"], "currency": "USD", "detailUrl": "https://www.ungm.org/Public/ContractAward/157547" } ``` ### Tips for better results - Start broad with only `maxItems`, then narrow by title or supplier. - Use detail pages when you need category codes or long descriptions. - Disable detail pages for faster trend sampling when search-row fields are enough. - Use date filters for monthly or quarterly procurement reporting. ### Integrations Send UNGM award data to Google Sheets for bid-team review, a warehouse for category analysis, a CRM for supplier intelligence, or a BI dashboard for country and agency monitoring. Apify webhooks can trigger downstream workflows after each scheduled run. ### API usage #### Node.js ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor('automation-lab/ungm-contract-awards-scraper').call({ maxItems: 100 }); console.log(run.defaultDatasetId); ``` #### Python ```python from apify_client import ApifyClient client = ApifyClient('YOUR_APIFY_TOKEN') run = client.actor('automation-lab/ungm-contract-awards-scraper').call(run_input={'maxItems': 100}) print(run['defaultDatasetId']) ``` #### cURL ```bash curl -X POST 'https://api.apify.com/v2/acts/automation-lab~ungm-contract-awards-scraper/runs?token=YOUR_APIFY_TOKEN' \ -H 'Content-Type: application/json' \ -d '{"maxItems":100,"includeDetails":true}' ``` ### MCP usage Use Apify MCP with Claude Desktop or Claude Code and enable this actor with: `https://mcp.apify.com/?tools=automation-lab/ungm-contract-awards-scraper` Add it from Claude Code: ```bash claude mcp add apify https://mcp.apify.com/?tools=automation-lab/ungm-contract-awards-scraper ``` Claude Desktop JSON config example: ```json { "mcpServers": { "apify": { "url": "https://mcp.apify.com/?tools=automation-lab/ungm-contract-awards-scraper" } } } ``` Example prompts: - "Scrape the newest 100 UNGM contract awards and summarize top suppliers." - "Find UNGM awards with transportation in the title and group them by country." - "Monitor awards for this supplier name and tell me which UN agencies appear." ### Scheduling Run the actor daily, weekly or monthly to build a historical contract-award monitor. For recurring procurement intelligence, keep inputs stable and append new datasets to your reporting workflow. ### Detail pages When `includeDetails` is true, the actor opens each public award detail URL. This adds full organization names, descriptions, vendors, countries, values when visible and UNSPSC category trees. When disabled, the actor only saves search-row fields and runs faster. ### Data quality notes UNGM does not publish every field for every award. Contract values can be blank, descriptions vary by organization, and UNSPSC categories may be absent on some records. Missing public fields are returned as `null` or empty arrays. ### Legality and ethical use This actor extracts public UNGM pages. Use the data responsibly, respect applicable laws, avoid excessive scheduling and do not use the results for spam or prohibited procurement practices. ### Troubleshooting #### Why is contractValue null? UNGM often displays the currency label but leaves the value blank. The actor preserves this accurately instead of inventing a number. #### Why do I see fewer rows than requested? The selected filters may not have enough public results. Broaden the title, supplier, reference or date filters. ### Related scrapers - [UNGM Tender Notices Scraper](https://apify.com/automation-lab/ungm-tender-notices-scraper) - [SAM.gov Government Contracts Scraper](https://apify.com/automation-lab/samgov-government-contracts-scraper) - [FPDS Federal Contracts Scraper](https://apify.com/automation-lab/fpds-federal-contracts-scraper) ### FAQ #### Can I scrape a specific supplier? Yes. Use the `supplier` input to search award winners by vendor name. #### Can I scrape only new awards? Use `awardFrom` and `awardTo` date filters, or schedule frequent runs and deduplicate by `awardId` in your downstream workflow. #### Does it require login? No. The actor uses public UNGM Contract Awards pages. #### Does it use a browser? No. It is an HTTP/Cheerio actor for lower cost and faster runs. - Procurement note 197: use stable filters and deduplicate by `awardId` for monitoring workflows. - Procurement note 199: use stable filters and deduplicate by `awardId` for monitoring workflows. - Procurement note 201: use stable filters and deduplicate by `awardId` for monitoring workflows. - Procurement note 203: use stable filters and deduplicate by `awardId` for monitoring workflows. - Procurement note 205: use stable filters and deduplicate by `awardId` for monitoring workflows. - Procurement note 207: use stable filters and deduplicate by `awardId` for monitoring workflows. - Procurement note 209: use stable filters and deduplicate by `awardId` for monitoring workflows. # Actor input Schema ## `maxItems` (type: `integer`): Maximum number of contract award records to save. ## `title` (type: `string`): Optional text to search in award titles, for example transportation, software, or vehicles. ## `supplier` (type: `string`): Optional supplier or winning vendor name filter. ## `reference` (type: `string`): Optional UNGM award reference filter. ## `description` (type: `string`): Optional text to search inside award descriptions. ## `awardFrom` (type: `string`): Optional UNGM date filter in DD-MMM-YYYY format, for example 01-Jan-2026. ## `awardTo` (type: `string`): Optional UNGM date filter in DD-MMM-YYYY format, for example 31-Dec-2026. ## `includeDetails` (type: `boolean`): Fetch each award detail page to include full organization names, descriptions, vendors and UNSPSC categories. ## `startPage` (type: `integer`): Zero-based search page index. Leave 0 for the newest awards. ## `sortField` (type: `string`): UNGM search sort field. ## `sortAscending` (type: `boolean`): Sort oldest/ascending instead of the default newest-first order. ## Actor input object example ```json { "maxItems": 20, "includeDetails": true, "startPage": 0, "sortField": "AwardDate", "sortAscending": false } ``` # Actor output Schema ## `overview` (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 = { "maxItems": 20, "title": "", "supplier": "", "reference": "", "description": "", "awardFrom": "", "awardTo": "", "includeDetails": true, "startPage": 0, "sortField": "AwardDate", "sortAscending": false }; // Run the Actor and wait for it to finish const run = await client.actor("automation-lab/ungm-contract-awards-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 = { "maxItems": 20, "title": "", "supplier": "", "reference": "", "description": "", "awardFrom": "", "awardTo": "", "includeDetails": True, "startPage": 0, "sortField": "AwardDate", "sortAscending": False, } # Run the Actor and wait for it to finish run = client.actor("automation-lab/ungm-contract-awards-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 '{ "maxItems": 20, "title": "", "supplier": "", "reference": "", "description": "", "awardFrom": "", "awardTo": "", "includeDetails": true, "startPage": 0, "sortField": "AwardDate", "sortAscending": false }' | apify call automation-lab/ungm-contract-awards-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=automation-lab/ungm-contract-awards-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "UNGM Contract Awards Scraper", "description": "Track UNGM public contract awards with suppliers, UN agencies, countries, dates, values, categories and detail URLs for procurement intelligence.", "version": "0.1", "x-build-id": "grDYh9BDour0DvbWV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation-lab~ungm-contract-awards-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation-lab-ungm-contract-awards-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/automation-lab~ungm-contract-awards-scraper/runs": { "post": { "operationId": "runs-sync-automation-lab-ungm-contract-awards-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/automation-lab~ungm-contract-awards-scraper/run-sync": { "post": { "operationId": "run-sync-automation-lab-ungm-contract-awards-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": { "maxItems": { "title": "Maximum awards", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of contract award records to save.", "default": 20 }, "title": { "title": "Award title contains", "type": "string", "description": "Optional text to search in award titles, for example transportation, software, or vehicles." }, "supplier": { "title": "Supplier / vendor contains", "type": "string", "description": "Optional supplier or winning vendor name filter." }, "reference": { "title": "Reference contains", "type": "string", "description": "Optional UNGM award reference filter." }, "description": { "title": "Description contains", "type": "string", "description": "Optional text to search inside award descriptions." }, "awardFrom": { "title": "Award date from", "type": "string", "description": "Optional UNGM date filter in DD-MMM-YYYY format, for example 01-Jan-2026." }, "awardTo": { "title": "Award date to", "type": "string", "description": "Optional UNGM date filter in DD-MMM-YYYY format, for example 31-Dec-2026." }, "includeDetails": { "title": "Open detail pages", "type": "boolean", "description": "Fetch each award detail page to include full organization names, descriptions, vendors and UNSPSC categories.", "default": true }, "startPage": { "title": "Start page index", "minimum": 0, "type": "integer", "description": "Zero-based search page index. Leave 0 for the newest awards.", "default": 0 }, "sortField": { "title": "Sort field", "enum": [ "AwardDate", "Title", "Reference" ], "type": "string", "description": "UNGM search sort field.", "default": "AwardDate" }, "sortAscending": { "title": "Sort ascending", "type": "boolean", "description": "Sort oldest/ascending instead of the default newest-first order.", "default": false } } }, "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 } } } } } } } } } } ```