Global Tender Match

Global Tender Match is an Apify Actor that finds open U.S. federal contract opportunities and ranks them for a specific business. It combines current notices from SAM.gov with comparable historical contract awards from USAspending.gov.

It does not use a paid AI API. Matching is deterministic, explainable, and inexpensive to run.

What it returns

Each dataset item contains:

• a 0-100 match score and plain-English scoring reasons;
• title, solicitation number, NAICS code, agency, dates, set-aside, contacts, and SAM.gov link;
• the amount published by SAM.gov, when one exists (many open notices do not include an estimated value);
• top comparable historical awards, recipient names, values, descriptions, and USAspending links;
• source labels and retrieval time.

Required setup

SAM.gov's public Opportunities API requires a personal API key. A registered SAM.gov user can request one from Account Details. The key is entered through the Actor's secret samApiKey field and is never written to the dataset or run summary.

USAspending currently requires no authorization.

Official references:

• SAM.gov Get Opportunities Public API
• USAspending API endpoints
• Apify Actor input schemas

Example input

{
  "samApiKey": "YOUR_PERSONAL_SAM_KEY",
  "businessDescription": "We build secure cloud software and provide data engineering services for public-sector organizations.",
  "keywords": ["cloud software", "data engineering"],
  "naicsCodes": ["541511", "541512"],
  "postedWithinDays": 30,
  "maxOpportunities": 50,
  "minMatchScore": 20,
  "includeHistoricalAwards": true,
  "awardsLookbackYears": 3,
  "maxHistoricalAwards": 5,
  "maxHistoricalQueries": 10
}

Use specific title phrases and six-digit NAICS codes when possible. If keywords is empty, the Actor derives up to five English terms from businessDescription.

Match score

The score is intentionally transparent:

Signal	Maximum points
Exact NAICS match	45
Related NAICS family	20
Search phrases found in title/agency text	35
Business capability terms found	10
Open or active response window	5
Recently posted	5

Expired/inactive notices, award notices, and justification records are excluded from open-opportunity results. The low score cap remains a defensive signal when scoring an individual raw record.

Run locally

Node.js 20 or newer is required.

npm install
npm test

The Apify SDK reads local input from storage/key_value_stores/default/INPUT.json when using its default local storage. Then run:

$npm start

Deploy to Apify

Create an Actor on Apify, upload or connect this source folder, and build it. The .actor folder contains the Dockerfile, input/output schemas, dataset table view, and memory limits. No separate server or database is required.

Product limitations

• This is opportunity discovery, not legal, procurement, or bid/no-bid advice.
• SAM.gov searches titles and NAICS codes; it does not offer a general full-description keyword parameter in this public endpoint.
• Open notices often omit contract value. The Actor returns null with an explanation instead of inventing an estimate.
• Historical awards are comparable by NAICS or keywords, not proof that the same buyer or requirement will recur.
• SAM.gov and USAspending can change fields or rate limits. API errors are retried, and historical enrichment failures do not discard current opportunities.