kadi_bence/sam-gov-scraper
kadi_bence--sam-gov-scraperThis tool calls the Actor "kadi_bence/sam-gov-scraper" and retrieves its output results. Actor description: $1.50 per 1,000 notices. Search US federal contract opportunities, RFPs and awards on SAM.gov (no API key). Input: keywords, notice types, NAICS/PSC codes, set-asides, agencies, states, posted dates. Returns per notice: title, agency, NAICS, set-aside, response deadline, place of performance, URL.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "kadi_bence--sam-gov-scraper"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| apiKey | No | Not needed for active notices. Your own free public API key from SAM.gov (Account Details > Public API Key) unlocks archived notices and attachment links through the official Get Opportunities API. Personal keys allow 10 requests per day (1,000 records each). Stored encrypted, never logged. | |
| agencies | No | Words from the department, agency or office name, e.g. 'Veterans Affairs', 'Navy', 'Army Corps of Engineers', or an abbreviation (DOD, VA, GSA, DHS, NASA, HHS, NIH, USDA...). Several lines = any of them. | |
| keywords | No | Searched in the title, solicitation number and full description. One line = all its words must appear (e.g. 'cloud migration'); put a line in quotes for an exact phrase ("janitorial services"). Several lines = any of them. Leave empty to get every notice that matches the other filters. | |
| postedTo | No | Last posted date (YYYY-MM-DD). | |
| pscCodes | No | e.g. D302 (IT systems development), R425 (engineering support), 7030 (software). Prefixes work: D3 returns all D3xx codes. | |
| waitSecs | No | Max seconds (0–45, default 30) to cap the wait for the Actor run to reach terminal state. For long-running Actors the response returns at the cap with the current run status; follow `nextStep` to poll via get-actor-run. Set to 0 to fire-and-forget. | |
| activeOnly | No | Archived (inactive) notices are only available with your own SAM.gov API key (see Advanced). Example values: true | |
| dataSource | No | Auto: the keyless official daily extract of all active notices; the official API (needs your key) only when you ask for archived notices or attachment links. Example values: "auto" | auto |
| maxResults | No | Stop after this many opportunities. 0 = no limit (there is no 10,000 cap). The default without input (API, MCP and AI-agent calls) is 20. Example values: 20 | |
| naicsCodes | No | Industry codes, e.g. 541511 (custom programming) or 236220 (commercial construction). Prefixes work: 5415 returns every 5415xx code, 23 all construction. | |
| postedFrom | No | First posted date (YYYY-MM-DD). | |
| monitorName | No | Keeps separate 'already seen' lists for different schedules. Example values: "default" | default |
| noticeTypes | No | Leave empty for all types. 'Solicitation' and 'Combined synopsis/solicitation' are open bids; 'Award notice' shows who won and for how much. Example values: ["solicitation","combined_synopsis_solicitation"] | |
| setAsideTypes | No | Small-business set-asides. Leave empty for all. 'No set-aside' = full and open competition. | |
| minAwardAmount | No | Only award notices with at least this awarded amount. Leave empty for all notices. | |
| postedWithinDays | No | e.g. 7 for the last week, 1 for yesterday and today. Leave empty to use the date range below (or no date limit). Short windows are also faster. Example values: 7 | |
| fetchDescriptions | No | The official API returns descriptions as separate links: each one costs one request of your key's daily quota. The keyless extract always includes descriptions. | |
| includeAttachments | No | Adds direct download links to the notice's documents (RFP, SOW, amendments). Uses the official API, so it needs your key. | |
| proxyConfiguration | No | Not needed: SAM.gov publishes this data as official open data. Example values: {"useApifyProxy":false} | |
| onlyNewOpportunities | No | Remember returned notices and output only NEW ones on the next runs with the same search. Ideal for a daily schedule: you only pay for new opportunities. | |
| responseDeadlineAfter | No | Only bids you can still answer: notices whose response deadline is on or after this date (notices without a deadline are left out). Accepts YYYY-MM-DD, 'today' or '+7 days'. | |
| stateFallbackToOffice | No | Broadens the state filter: notices without a place-of-performance state are matched on the state of the buying office. | |
| placeOfPerformanceStates | No | 2-letter state codes. Note: only about 1 in 3 notices lists a place-of-performance state; tick the option below to fall back to the contracting office's state. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tip | No | Advisory guidance RAG Web Browser wrote to its key-value store under the reserved "TIP" key | |
| runId | Yes | Actor run ID | |
| stats | No | Run statistics | |
| status | Yes | Run status: READY | RUNNING | TIMING-OUT | TIMED-OUT | ABORTING | ABORTED | SUCCEEDED | FAILED | |
| actorId | Yes | Stable Apify Actor ID from the run record | |
| summary | Yes | Past-tense summary of the run state | |
| exitCode | No | Actor process exit code; populated for terminal states (especially FAILED) | |
| nextStep | Yes | One primary follow-up action with identifiers interpolated | |
| storages | Yes | Dataset and key-value store metadata, keyed by alias. "default" is always the primary entry. | |
| actorName | No | "username/actor-name" | |
| startedAt | No | ISO timestamp when the run started | |
| finishedAt | No | ISO timestamp when the run finished (terminal states only) | |
| statusMessage | No | Pass-through from Apify run.statusMessage | |
| apifyConsoleUrl | No | Personalized Apify Console link to the run; present only for Console sessions |