hexadatalabs/sam-gov-opportunities-scraper
hexadatalabs--sam-gov-opportunities-scraperDestructive
This tool calls the Actor "hexadatalabs/sam-gov-opportunities-scraper" and retrieves its output results. Actor description: Use this when you need US federal contract opportunities from SAM.gov: solicitations, sources sought and awards by keyword, NAICS, set-aside, agency, state and date, with deadline, award value and link. Public daily extract, no API key. Pay per result.
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": "hexadatalabs--sam-gov-opportunities-scraper"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dateTo | No | Only notices posted on or before this date (YYYY-MM-DD). | |
| states | No | Two-letter US state or territory codes of the place of performance (the contracting office state is used when the notice has none), e.g. TX, VA, CA, DC. | |
| agencies | No | Substrings matched in the department, sub-tier or office name, e.g. "DEPT OF DEFENSE", "VETERANS AFFAIRS", "NASA", "HOMELAND SECURITY". | |
| dateFrom | No | Only notices posted on or after this date (YYYY-MM-DD). With no other filter, the last 7 days are used. A date also makes runs faster: the download stops once older notices are reached. | |
| 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. | |
| setAsides | No | Only notices with these small-business set-asides: SBA (total small business), SBP (partial), 8A, 8AN, HZC, HZS (HUBZone), SDVOSBC, SDVOSBS (service-disabled veteran), WOSB, WOSBSS, EDWOSB, EDWOSBSS (women-owned), VSA, VSS (veteran), LAS, IEE, ISBEE, BICIV, NONE. Empty = any. | |
| includeRaw | No | Attach the original 47-column row of the SAM.gov extract under "raw" (includes contact columns). For debugging or custom parsing. | |
| maxResults | No | Stop after this many opportunities. Newest notices come first. Example values: 50 | |
| naicsCodes | No | North American Industry Classification codes, 2 to 6 digits, prefix match: "541512" = computer systems design, "5415" = all computer services, "23" = construction. Find codes at https://www.census.gov/naics/ | |
| onlyActive | No | Keep only notices SAM.gov marks as active (not archived). Turn off to include inactive and archived notices present in the extract. Example values: true | |
| noticeTypes | No | Use "solicitation" for notices you can bid on now (Solicitation + Combined Synopsis/Solicitation), "sources-sought" and "presolicitation" for early market research, "award" for award notices with awardee and amount. Example values: "all" | all |
| searchQueries | No | Case-insensitive phrases matched in the title, solicitation number and description, one per line, e.g. "cybersecurity", "janitorial services", "drone". Leave empty to filter only by NAICS / set-aside / agency / state / date. Example values: ["cybersecurity"] | |
| includeContacts | No | Add the primary and secondary point of contact published in the notice (name, title, e-mail, phone). Off by default because these are named individuals; turn on only if you have a lawful basis to use them (they are published by SAM.gov for vendors to ask questions about the notice). | |
| proxyConfiguration | No | The SAM.gov public extract does not need a proxy; leave it off. Example values: {"useApifyProxy":false} | |
| onlyNewSinceLastRun | No | Use this on a schedule: the Actor remembers when it last ran (shared store "hexadata-sam-gov-opportunities" in your account) and returns only notices posted since then that it has not delivered before. The first run saves everything that matches. |
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 |