# Public Procurement Intelligence Hub (`datapilot/public-procurement-intelligence-hub`) Actor

Search USASpending.gov for federal procurement contracts by keyword. Extract award ID, contract title, agency, vendor, UEI, contract value, NAICS, PSC, performance dates, location, set-aside type, offers received, and award details. Supports Apify Residential Proxy.

- **URL**: https://apify.com/datapilot/public-procurement-intelligence-hub.md
- **Developed by:** [Data Pilot](https://apify.com/datapilot) (community)
- **Categories:** AI, Agents, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 scraped results

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.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

## Public Procurement Intelligence Hub

🏛️ **Public Procurement Intelligence Hub** is a powerful Apify Actor designed to discover, analyze, and monitor **Public Procurement Intelligence** opportunities from USASpending.gov. This tool provides comprehensive **Public Procurement Intelligence** including government contracts, awards, vendors, values, timelines, and detailed procurement classifications. Whether you're bidding for government contracts, tracking procurement trends, or conducting competitive intelligence, the Public Procurement Intelligence Hub delivers actionable **Public Procurement Intelligence** opportunities efficiently.

With USASpending.gov API integration, multi-source data enrichment, comprehensive classification codes (NAICS, PSC), detailed award tracking, vendor intelligence, and data deduplication, the Public Procurement Intelligence Hub ensures complete **Public Procurement Intelligence** discovery and analysis. It focuses on key **Public Procurement Intelligence** signals including contract values, agency details, vendor information, and procurement classifications, making it an essential tool for **Public Procurement Intelligence** research and government contracting.

---

### 📋 Table of Contents

- [Features](#-features)
- [Data Source](#-data-source)
- [How It Works](#-how-it-works)
- [Input](#-input)
- [Output](#-output)
- [Technical Stack](#-technical-stack)
- [Data Fields](#-data-fields)
- [Classification Codes](#-classification-codes)
- [Award Types](#-award-types)
- [Use Cases](#-use-cases)
- [Quick Start](#-quick-start)
- [Configuration](#-configuration)
- [Performance](#-performance)
- [Billing](#-billing)
- [Important Notes](#-important-notes)
- [Keywords](#-keywords)
- [Changelog](#-changelog)
- [Support](#-support)

---

### 🔥 Features

- **USASpending.gov Integration** – Direct API access to official U.S. government spending database for **Public Procurement Intelligence**.
- **Keyword Search** – Search **Public Procurement Intelligence** by contract keyword, topic, or product/service.
- **Contract Discovery** – Discovers government contracts and awards matching search criteria.
- **Multiple Award Types** – Searches across A, B, C, D award type codes (contracts, grants, loans, direct payments).
- **Time Period Support** – Configurable date range for historical and current procurement data.
- **Detailed Award Information** – Fetches comprehensive details for each contract from award detail API.
- **Buyer Identification** – Identifies awarding agency and sub-agency for each contract.
- **Vendor Information** – Captures winning vendor name and UEI (Unique Entity Identifier).
- **Contract Values** – Extracts award amounts, total obligations, and base+options values.
- **Performance Timeline** – Records contract start and end dates.
- **Location Tracking** – Captures place of performance (city, state, country).
- **NAICS Classification** – Includes industry classification codes (NAICS).
- **PSC Classification** – Includes product/service classification codes (PSC).
- **Set-Aside Programs** – Identifies small business set-asides and other set-aside programs.
- **Competition Metrics** – Tracks number of offers received for contract.
- **URL Generation** – Provides direct links to contract details on USASpending.
- **Deduplication** – Removes duplicate contracts from results.
- **Sorting** – Results sorted by award amount (highest first).
- **Summary Generation** – Generates procurement intelligence summary.
- **Multi-Field Extraction** – Intelligently pulls data from search results and detail API.
- **PPE Billing Integration** – Pay-per-event billing (batch processing, not per-contract charged).
- **Proxy Support** – Apify residential proxy support for reliability.
- **Real-Time Dataset Push** – Pushes results to Apify Dataset with metadata.
- **Detailed Logging** – Comprehensive logging of search and processing.
- **Asyncio-Friendly** – Non-blocking async/await architecture.

---

### 📊 Data Source

#### **USASpending.gov**

- **Authority**: Official U.S. Government spending transparency database (DATA Act compliant)
- **Coverage**: All federal contracts, grants, loans, and direct payments
- **Data**: Comprehensive procurement information from all federal agencies
- **Updates**: Near real-time updates as contracts are awarded
- **APIs**: Official REST API with extensive data fields
- **Historical Data**: Multiple years of historical contract data
- **Scope**: Over $6 trillion in federal spending tracked

---

### ⚙️ How It Works

The Public Procurement Intelligence Hub accepts a keyword to search for government contracts. It queries the USASpending.gov API with the keyword across all major award types (A, B, C, D) and configurable time period. For each contract found, it fetches detailed award information to enrich the dataset with additional fields not in the search results. It extracts comprehensive data including buyer, vendor, value, timeline, location, and classifications. Results are deduplicated by award ID and pushed to the dataset in batch. A summary of findings is logged.

**Key Processing Steps:**

1. **Input Parsing** – Accept keyword and search parameters
2. **Proxy Setup** – Configure Apify residential proxy
3. **Payload Building** – Build search query with filters
4. **API Search** – Query USASpending.gov awards search API
5. **Result Parsing** – Parse initial search results
6. **Detail Fetching** – Fetch full details for each contract
7. **Field Extraction** – Extract all relevant fields from search + detail
8. **Data Enrichment** – Intelligently merge search and detail data
9. **Formatting** – Format amounts, dates, and text fields
10. **Location Compilation** – Build location strings
11. **Deduplication** – Remove duplicates by award ID
12. **Dataset Push** – Push unique leads in batch
13. **Summary Reporting** – Log statistics

**Key Benefits:**

- Discover government contracts matching your expertise
- Understand procurement trends and opportunities
- Identify agencies and spending patterns
- Research competitor contract wins
- Build target company lists for business development
- Monitor procurement market segments

---

### 📥 Input

The Actor accepts the following input parameters:

| Field | Type | Default | Description |
|-------|------|---------|-------------|
| `keyword` | string | required | Search keyword for **Public Procurement Intelligence** (e.g., "software", "IT services") |
| `limit` | integer | `25` | Maximum contracts to return (1-100) |
| `useApifyProxy` | boolean | `true` | Enable Apify residential proxies |
| `apifyProxyGroups` | array | `["RESIDENTIAL"]` | Proxy group configuration |

**Example Input:**

```json
{
  "keyword": "cloud computing",
  "limit": 50,
  "useApifyProxy": true
}
````

**Search for IT Contracts:**

```json
{
  "keyword": "information technology",
  "limit": 75
}
```

**Search for Specific Services:**

```json
{
  "keyword": "consulting services",
  "limit": 100
}
```

***

### 📤 Output

The Actor pushes **Public Procurement Intelligence** lead records with the following structure:

**Procurement Lead Record:**

| Field | Type | Description |
|-------|------|-------------|
| `title` | string | Contract title/description |
| `award_id` | string | Unique award identifier |
| `award_type` | string | Award type (Contract, Grant, Loan, etc.) |
| `buyer` | string | Awarding agency (top-tier) |
| `sub_agency` | string | Awarding sub-agency |
| `vendor` | string | Winning vendor/contractor name |
| `vendor_uei` | string | Vendor Unique Entity Identifier |
| `value` | string | Contract award amount (formatted) |
| `start_date` | string | Performance start date (YYYY-MM-DD) |
| `end_date` | string | Performance end date (YYYY-MM-DD) |
| `location` | string | Place of performance (city, state, country) |
| `naics_code` | string | Industry classification code |
| `naics_desc` | string | NAICS description |
| `psc_code` | string | Product/Service classification code |
| `psc_desc` | string | PSC description |
| `set_aside` | string | Set-aside program (e.g., small business) |
| `offers` | string | Number of competing offers |
| `detail_url` | string | Direct link to USASpending contract details |
| `source` | string | Data source (USASpending.gov) |
| `keyword` | string | Search keyword used |
| `scraped_at` | string | ISO 8601 scrape timestamp |

**Example Procurement Lead Record:**

```json
{
  "title": "Cloud Infrastructure Services Platform Implementation and Operations",
  "award_id": "9023847592834",
  "award_type": "Contract",
  "buyer": "General Services Administration",
  "sub_agency": "Federal Acquisition Service",
  "vendor": "Amazon Web Services, Inc.",
  "vendor_uei": "1234567890AB",
  "value": "$250,000,000",
  "start_date": "2024-01-15",
  "end_date": "2029-01-14",
  "location": "Arlington, VA, USA",
  "naics_code": "541511",
  "naics_desc": "Custom Computer Programming Services",
  "psc_code": "D310",
  "psc_desc": "Information Technology and Telecommunications",
  "set_aside": "None",
  "offers": "8",
  "detail_url": "https://www.usaspending.gov/award/9023847592834",
  "source": "USASpending.gov",
  "keyword": "cloud computing",
  "scraped_at": "2025-02-14T12:00:00"
}
```

**Example Multiple Leads (Batch):**

```json
[
  {
    "title": "Software Development and Integration Services",
    "award_id": "9012345678901",
    "award_type": "Contract",
    "buyer": "Department of Defense",
    "sub_agency": "Air Force",
    "vendor": "Raytheon Technologies Corp",
    "vendor_uei": "0987654321XY",
    "value": "$150,000,000",
    "start_date": "2023-03-01",
    "end_date": "2027-02-28",
    "location": "Fort Worth, TX, USA",
    "naics_code": "541512",
    "naics_desc": "Computer Systems Design Services",
    "psc_code": "D301",
    "psc_desc": "Automatic Data Processing and Office Automation",
    "set_aside": "None",
    "offers": "5",
    "detail_url": "https://www.usaspending.gov/award/9012345678901",
    "source": "USASpending.gov",
    "keyword": "defense technology",
    "scraped_at": "2025-02-14T12:00:00"
  }
]
```

***

### 🧰 Technical Stack

- **API Source:** USASpending.gov REST API
- **HTTP Client:** httpx for async HTTP requests
- **Data Parsing:** JSON and regex for text processing
- **Async:** asyncio for non-blocking operations
- **Rate Limiting:** Polite delays between detail API calls (300ms)
- **Deduplication:** Set-based tracking by award ID
- **Proxy:** Apify Proxy with RESIDENTIAL configuration
- **Logging:** Apify Actor logging system
- **Platform:** Apify Actor serverless environment
- **Billing:** Batch push (not per-contract PPE)

***

### 📊 Data Fields Explained

#### **Contract Identification**

- **award\_id**: Unique contract identifier
- **title**: Contract description/scope
- **award\_type**: Contract, grant, loan, or direct payment

#### **Procurement Parties**

- **buyer**: Awarding federal agency
- **sub\_agency**: Specific sub-agency within buyer
- **vendor**: Winning contractor/vendor
- **vendor\_uei**: Unique Entity Identifier for vendor

#### **Financial Details**

- **value**: Contract award value (formatted)

#### **Timeline**

- **start\_date**: Performance start
- **end\_date**: Performance completion

#### **Classification**

- **naics\_code**: Industry classification
- **psc\_code**: Product/service classification
- **set\_aside**: Small business or special program

#### **Competitive Intelligence**

- **offers**: Number of companies that competed
- **location**: Work location

***

### 🏛️ Classification Codes

#### **NAICS (North American Industry Classification System)**

Examples relevant to procurement:

- **541511**: Custom Computer Programming Services
- **541512**: Computer Systems Design Services
- **541519**: Other Computer Related Services
- **336411**: Aircraft Manufacturing
- **334613**: Magnetic and Optical Recording Media Manufacturing

#### **PSC (Product/Service Code)**

Examples:

- **D301**: Automatic Data Processing (ADP)
- **D310**: Information Technology and Telecommunications
- **J006**: Maintenance, Repair and Renovation of Real Property
- **R299**: Consultant and Professional Services, Other
- **S799**: Other Supplies and Services

***

### 🏆 Award Types

The Actor searches across all award types:

- **Type A**: IDV (Indefinite Delivery) contracts
- **Type B**: Federal Agency contracts
- **Type C**: Grants and cooperative agreements
- **Type D**: Loans and other financial assistance

***

### 🎯 Use Cases

- **Business Development** – Identify **Public Procurement Intelligence** contract opportunities
- **Competitive Intelligence** – Track competitor contract wins
- **Market Research** – Analyze government spending trends
- **Target Identification** – Build list of federal agencies for business development
- **Proposal Planning** – Research similar contracts before bidding
- **Vendor Analysis** – Understand competitor wins and contracts
- **Compliance Tracking** – Monitor regulatory and compliance contracts
- **Industry Analysis** – Understand government spending by industry
- **Contract Intelligence** – Research contract values and scopes
- **Opportunity Pipeline** – Build pipeline of upcoming/active contracts
- **Pricing Benchmarking** – Compare contract values across similar scopes
- **Agency Intelligence** – Understand which agencies buy specific services
- **Capability Matching** – Find contracts matching your capabilities
- **Timeline Analysis** – Understand contract durations and schedules
- **Geographic Analysis** – Identify geographic procurement hotspots

***

### 🚀 Quick Start

#### **1. Prepare Input**

Go to Apify Console and enter:

```json
{
  "keyword": "cybersecurity",
  "limit": 50,
  "useApifyProxy": true
}
```

#### **2. Run the Actor**

Click **Start** button. The Actor will:

- Connect to USASpending.gov API
- Search for contracts matching keyword
- Fetch detailed information for each contract
- Extract comprehensive procurement data
- Deduplicate and push to Dataset

#### **3. Monitor Progress**

Console shows:

```
[USASpending.gov] Searching for procurement leads matching: 'cybersecurity'
Apify Proxy string built and integrated successfully.
Found 48 raw matching contract listings.
Fetching deeper nested award details...
Successfully processed and stored 45 unique procurement leads!
```

#### **4. View & Download Results**

- **Results Tab**: All procurement contracts with full details
- **Export**: JSON, CSV, Excel
- **Filter**: By agency, value, or date
- **Sort**: By contract value or date

***

### ⚙️ Configuration

#### **Search Scope**

Specific service:

```json
{
  "keyword": "managed IT services"
}
```

Broader category:

```json
{
  "keyword": "professional services"
}
```

#### **Result Limits**

Quick scan:

```json
{
  "limit": 25
}
```

Comprehensive:

```json
{
  "limit": 100
}
```

***

### 📈 Performance

#### **Processing Speed**

- \~2-3 seconds per contract detail fetch
- \~25-100 contracts per search
- Detail fetching dominates processing time
- Rate-limited to 300ms between API calls

#### **Resource Usage**

- Memory: ~100-200MB
- CPU: ~30-40% during processing
- Network: ~3-5MB per search
- API calls: 1 search + N details (where N = # results)

***

### 💰 Billing

#### **Batch Billing**

- **Billing Model:** Batch push (not per-contract PPE)
- **Typical Cost:** Single operation per search
- **Efficiency:** High efficiency, bulk processing

***

### ⚠️ Important Notes

#### **Legal & Compliance**

- **Fair Use**: Respects USASpending.gov ToS and rate limits
- **Attribution**: Public domain government data
- **Accuracy**: Data as maintained by federal agencies
- **Verification**: Information as of database update time
- **Rate Limiting**: Includes delays to respect API

#### **Data Quality**

- **Freshness**: Near real-time updates from USASpending
- **Completeness**: Varies by agency reporting quality
- **Accuracy**: As accurate as federal agency data
- **Reliability**: Highly reliable, official source
- **Verification**: Always verify with agency if needed

#### **Best Practices**

- Use residential proxies
- Respect API rate limits
- Verify contract details with agencies
- Check vendor UEI validity
- Confirm performance locations
- Review contract modifications
- Subscribe to SAM.gov for bidding
- Register DUNS/UEI before bidding
- Follow FedBizOpps for RFPs
- Understand NAICS/PSC codes
- Comply with small business classifications
- Maintain current registrations

***

***

### 📦 Changelog

**Initial Release:**

- USASpending.gov API integration
- Multi-award-type search (A, B, C, D codes)
- Configurable time period search (2023-2026)
- Keyword-based contract search
- Detail API fetching for field enrichment
- Intelligent field extraction from search + detail
- Contract value extraction and formatting
- Performance timeline extraction
- Location compilation (city, state, country)
- NAICS code and description extraction
- PSC code and description extraction
- Set-aside program identification
- Number of offers extraction
- Vendor information extraction (name, UEI)
- Buyer agency extraction (top-tier and sub-agency)
- Award type determination
- Direct USASpending detail URL generation
- Deduplication by award ID
- Results sorted by value (highest first)
- Rate limiting (300ms between detail calls)
- Batch dataset push
- Detailed progress logging
- Comprehensive error handling
- Asyncio executor support

***

### 🧑‍💻 Support & Feedback

- **Issues:** Submit via Apify console with keyword
- **Documentation:** Check Actor details page
- **Community:** Apify forum discussions
- **Feature Requests:** Suggest improvements
- **Bug Reports:** Include keyword and error details

***

### 💾 Apify Integration

#### **Automatic Features**

### 📄 License & Legal

**Terms of Use:**

- Use for legitimate business and research
- Respect USASpending.gov ToS
- Public domain data (no copyright restrictions)
- Use data ethically and responsibly
- Comply with federal procurement regulations

**Disclaimer:**
Public Procurement Intelligence Hub is provided as-is for research purposes. Users are responsible for compliance with USASpending.gov ToS and applicable procurement regulations. Always verify contract details with official sources and USASpending.gov database.

***

### 🎉 Get Started Today

**Deploy now for **Public Procurement Intelligence** research!**

Use for:

- 📊 Opportunity Discovery
- 🔍 Competitive Intelligence
- 💡 Market Research
- 📈 Trend Analysis
- 🎯 Business Development

**Perfect for:**

- Contractors
- Consultants
- Business Development
- Market Researchers
- Procurement Analysts

***

**Last Updated:** February 2025\
**Version:** 1.0.0\
**Status:** Production Ready\
**Platform:** Apify Actor\
**Architecture:** Async/Await\
**Python:** 3.8+\
**API Source:** USASpending.gov

***

### 📚 Related Tools

- Product Recall Monitor
- SaaS Launch Monitor
- Grants & Funding Opportunities Harvester
- News Mention Alert Engine

**Your complete Apify-powered **Public Procurement Intelligence** research solution!** 🚀✨

***

### 🏛️ Procurement Intelligence Excellence

This Actor is optimized for **Public Procurement Intelligence** research with:

- ✅ USASpending.gov API integration
- ✅ Multi-source data enrichment
- ✅ Comprehensive classification codes
- ✅ Vendor intelligence extraction
- ✅ Competitive intelligence tracking
- ✅ Batch processing efficiency
- ✅ Real-time Dataset push
- ✅ Error recovery
- ✅ Production-ready code

**Discover government contracts effortlessly!** 💎🚀

# Actor input Schema

## `keyword` (type: `string`):

Enter procurement keyword (e.g., IT services, construction, medical).

## `limit` (type: `integer`):

Maximum number of award records to fetch.

## `useApifyProxy` (type: `boolean`):

Enable proxy to route API requests securely through Apify servers.

## `apifyProxyGroups` (type: `array`):

Select proxy networks (RESIDENTIAL is highly recommended for official endpoints).

## Actor input object example

```json
{
  "keyword": "IT services",
  "limit": 25,
  "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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "keyword": "IT services"
};

// Run the Actor and wait for it to finish
const run = await client.actor("datapilot/public-procurement-intelligence-hub").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "keyword": "IT services" }

# Run the Actor and wait for it to finish
run = client.actor("datapilot/public-procurement-intelligence-hub").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 '{
  "keyword": "IT services"
}' |
apify call datapilot/public-procurement-intelligence-hub --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=datapilot/public-procurement-intelligence-hub",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Public Procurement Intelligence Hub",
        "description": "Search USASpending.gov for federal procurement contracts by keyword. Extract award ID, contract title, agency, vendor, UEI, contract value, NAICS, PSC, performance dates, location, set-aside type, offers received, and award details. Supports Apify Residential Proxy.",
        "version": "0.0",
        "x-build-id": "mk9TEMYxwjStJvgLz"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/datapilot~public-procurement-intelligence-hub/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-datapilot-public-procurement-intelligence-hub",
                "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/datapilot~public-procurement-intelligence-hub/runs": {
            "post": {
                "operationId": "runs-sync-datapilot-public-procurement-intelligence-hub",
                "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/datapilot~public-procurement-intelligence-hub/run-sync": {
            "post": {
                "operationId": "run-sync-datapilot-public-procurement-intelligence-hub",
                "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": [
                    "keyword"
                ],
                "properties": {
                    "keyword": {
                        "title": "Search Keyword",
                        "type": "string",
                        "description": "Enter procurement keyword (e.g., IT services, construction, medical)."
                    },
                    "limit": {
                        "title": "Max Results",
                        "minimum": 1,
                        "maximum": 100,
                        "type": "integer",
                        "description": "Maximum number of award records to fetch.",
                        "default": 25
                    },
                    "useApifyProxy": {
                        "title": "Use Apify Proxy",
                        "type": "boolean",
                        "description": "Enable proxy to route API requests securely through Apify servers.",
                        "default": true
                    },
                    "apifyProxyGroups": {
                        "title": "Proxy Groups",
                        "uniqueItems": true,
                        "type": "array",
                        "description": "Select proxy networks (RESIDENTIAL is highly recommended for official endpoints).",
                        "items": {
                            "type": "string",
                            "enum": [
                                "RESIDENTIAL",
                                "DATACENTER"
                            ]
                        },
                        "default": [
                            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
