Government Opportunity Finder

Aggregate public procurement, grant and spending opportunities from a set of keyless public government APIs into one clean, deduplicated dataset. Every record is an officially published opportunity — the Actor collects and normalises only public data and never invents conclusions. Each opportunity ships with a matchReason explaining why it surfaced for your keyword, and the Actor can flag newly appeared opportunities between runs.

What does this Actor do?

It queries the following keyless, public sources and merges the results:

• Grants.gov — US federal grant opportunities (search2 API).
• USAspending — US federal awards / spending (spending_by_award API).
• GOV.UK — UK government publications and announcements (search API).
• TED — European Union public procurement tenders (TED notices API).

Results are normalised to a single canonical shape, annotated with a match reason, and deduplicated by (source, identifier).

Why use it?

• Sales, grants and bid teams get a single, structured feed across US and EU public opportunities without juggling four different APIs.
• Every opportunity is backed by a citable, public record and a URL you can open.
• Optional change monitoring flags what is genuinely new since your last run — ideal for scheduled scans.

How to use it

1. Enter a keyword (e.g. cybersecurity).
2. Pick your sources (default grants_gov).
3. Optionally set agency, grant statuses, maxResults, and enable monitorChanges.
4. Run the Actor and download the dataset as JSON, CSV or Excel.

Input

Field	Type	Description
keyword	string (required)	Keyword to search opportunities for.
sources	array	grants_gov, usaspending, gov_uk, ted_eu (default ["grants_gov"]).
country	string	Informational context only — does not filter; choose sources instead.
agency	string	Optional agency filter (grants.gov).
statuses	array	Grant statuses: posted, forecasted, closed, archived (default ["posted"]).
maxResults	integer	Max opportunities to return (default 100).
monitorChanges	boolean	Flag newly appeared opportunities vs. the previous run (default false).
proxyConfiguration	object	Proxy settings (usually optional — the APIs are keyless).

Input example

{
  "keyword": "renewable energy",
  "sources": ["grants_gov", "ted_eu"],
  "statuses": ["posted"],
  "maxResults": 100,
  "monitorChanges": true
}

Output

One record per opportunity. Canonical fields:

Field	Description
title	Opportunity title.
agency	Publishing agency / buyer.
description	Description when the source provides one.
eligibility	Eligibility notes when available.
deadline	Close / submission date when available.
value	Award ceiling / estimated value when available.
status	Source status / notice type.
url	Link to the official listing.
source	grants_gov, usaspending, gov_uk, or ted_eu.
identifier	Source-native identifier (used for dedupe).
matchReason	Why this record matched your keyword.
isNew	Present when monitorChanges is on — true for newly appeared opportunities.

Output example

{
  "title": "Community Renewable Energy Program",
  "agency": "Department of Energy",
  "status": "posted",
  "value": 5000000,
  "deadline": "2026-10-01",
  "source": "grants_gov",
  "identifier": "DE-FOA-0001234",
  "url": "https://www.grants.gov/search-results-detail/123456",
  "matchReason": "keyword 'renewable energy' matched title",
  "isNew": true
}

You can download the dataset in various formats such as JSON, HTML, CSV, or Excel.

Change monitoring

When monitorChanges is enabled the Actor stores each run's opportunity list as a snapshot in the Apify key-value store (via the shared ChangeMonitor). On the next run it diffs the current list against that snapshot by (source, identifier) and marks freshly appeared opportunities with isNew: true. Schedule the Actor to receive a running feed of only what changed.

Sources & configuration

• All four sources are keyless public APIs — no credentials required.
• Environment variables — none required. The Apify Proxy password is injected by the platform when a proxy is configured.

Local execution

pip install -r requirements.txt
# put input in storage/key_value_stores/default/INPUT.json
python src/main.py

Apify execution

Deploy with apify push, then run from the Console or via the API. Schedule it to re-scan a market on a cadence and use monitorChanges to surface only new opportunities.

Limitations & legal

• Only publicly accessible government data is processed. No authentication is bypassed and no private data is collected.
• Field coverage varies by source — some APIs omit descriptions, deadlines or values.
• Respect each source's Terms of Service and applicable laws in your jurisdiction.