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

{
  "maxItems": 100,
  "title": "transportation",
  "includeDetails": true
}

Example output

{
  "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

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

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

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:

$claude mcp add apify https://mcp.apify.com/?tools=automation-lab/ungm-contract-awards-scraper

Claude Desktop JSON config example:

{
  "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
• SAM.gov Government Contracts Scraper
• 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.