{
  "data": {
    "id": "rrmdtbUsqvOpaJhvp",
    "actId": "sb1M0G4fhxNdl7fWj",
    "userId": "4BicJNfmk8uEe3GtT",
    "startedAt": "2026-11-22T02:42:52.855Z",
    "finishedAt": "2026-11-22T02:42:57.541Z",
    "status": "SUCCEEDED",
    "meta": {
      "origin": "CLI"
    },
    "stats": {
      "durationMillis": 4599,
      "runTimeSecs": 4.599,
      "computeUnits": 0.00511,
      "imageSizeBytes": 319242752
    },
    "options": {
      "useCache": true,
      "betaPackages": false,
      "memoryMbytes": 4096,
      "diskMbytes": 8192
    },
    "createdByOrganizationMemberUserId": "chIfRjofLtMMYtdFe",
    "exitCode": 0,
    "inputSchema": "{\n  \"title\": \"SAM.gov Contract & Award Notice Scraper Input\",\n  \"description\": \"Search US federal contract opportunities and award notices on SAM.gov, or fetch specific notices by ID or URL. No account, API key or cookie is required.\",\n  \"type\": \"object\",\n  \"schemaVersion\": 1,\n  \"properties\": {\n    \"operation\": {\n      \"title\": \"Operation\",\n      \"type\": \"string\",\n      \"description\": \"Search notices with filters, or fetch specific notices by ID or sam.gov URL.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"search\",\n        \"getNoticeDetails\"\n      ],\n      \"enumTitles\": [\n        \"Search contract and award notices\",\n        \"Fetch specific notices by ID or URL\"\n      ],\n      \"default\": \"search\",\n      \"prefill\": \"search\"\n    },\n    \"mode\": {\n      \"title\": \"Legacy mode\",\n      \"type\": \"string\",\n      \"description\": \"Legacy mode value accepted for backward compatibility. Use `operation` instead.\",\n      \"editor\": \"hidden\"\n    },\n    \"searchQuery\": {\n      \"title\": \"Search keywords\",\n      \"type\": \"string\",\n      \"description\": \"Words to match in notice titles and descriptions. Leave empty to browse by filters only.\",\n      \"editor\": \"textfield\",\n      \"sectionCaption\": \"Search filters\",\n      \"prefill\": \"software\"\n    },\n    \"matchMode\": {\n      \"title\": \"Keyword matching\",\n      \"type\": \"string\",\n      \"description\": \"How multiple keywords must match. Best match sorting uses relevance when keywords are set.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"ALL\",\n        \"ANY\",\n        \"EXACT\"\n      ],\n      \"enumTitles\": [\n        \"All words\",\n        \"Any words\",\n        \"Exact phrase\"\n      ],\n      \"default\": \"ALL\",\n      \"prefill\": \"ALL\"\n    },\n    \"noticeType\": {\n      \"title\": \"Notice type\",\n      \"type\": \"string\",\n      \"description\": \"Restrict results to one notice type, such as solicitations or award notices.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"\",\n        \"a\",\n        \"k\",\n        \"o\",\n        \"p\",\n        \"r\",\n        \"s\",\n        \"g\",\n        \"i\",\n        \"u\"\n      ],\n      \"enumTitles\": [\n        \"All notice types\",\n        \"Award Notice\",\n        \"Combined Synopsis/Solicitation\",\n        \"Solicitation\",\n        \"Presolicitation\",\n        \"Sources Sought\",\n        \"Special Notice\",\n        \"Sale of Surplus Property\",\n        \"Consolidate/(Substantially) Bundle\",\n        \"Justification\"\n      ],\n      \"default\": \"\",\n      \"prefill\": \"\"\n    },\n    \"naicsCode\": {\n      \"title\": \"NAICS code\",\n      \"type\": \"string\",\n      \"description\": \"One or more NAICS codes, comma-separated. Ranges are accepted, e.g. 541511,541512 or 561730-561740.\",\n      \"editor\": \"textfield\",\n      \"prefill\": \"\"\n    },\n    \"pscCode\": {\n      \"title\": \"Product Service Code (PSC)\",\n      \"type\": \"string\",\n      \"description\": \"One or more PSC codes, comma-separated, e.g. D302 or 7A21.\",\n      \"editor\": \"textfield\",\n      \"prefill\": \"\"\n    },\n    \"setAside\": {\n      \"title\": \"Set-aside\",\n      \"type\": \"string\",\n      \"description\": \"Small-business and socioeconomic set-aside designation.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"\",\n        \"SBA\",\n        \"SBP\",\n        \"8A\",\n        \"8AN\",\n        \"HZC\",\n        \"HZS\",\n        \"SDVOSBC\",\n        \"SDVOSBS\",\n        \"WOSB\",\n        \"WOSBSS\",\n        \"EDWOSB\",\n        \"EDWOSBSS\",\n        \"IEE\",\n        \"ISBEE\",\n        \"LAS\"\n      ],\n      \"enumTitles\": [\n        \"All set-asides\",\n        \"Total Small Business\",\n        \"Partial Small Business\",\n        \"8(a) Set-Aside\",\n        \"8(a) Sole Source\",\n        \"HUBZone Set-Aside\",\n        \"HUBZone Sole Source\",\n        \"Service-Disabled Veteran-Owned Small Business\",\n        \"Service-Disabled Veteran-Owned Small Business Sole Source\",\n        \"Women-Owned Small Business\",\n        \"Women-Owned Small Business Sole Source\",\n        \"Economically Disadvantaged WOSB\",\n        \"Economically Disadvantaged WOSB Sole Source\",\n        \"Indian Economic Enterprise\",\n        \"Indian Small Business Economic Enterprise\",\n        \"Local Area Set-Aside\"\n      ],\n      \"default\": \"\",\n      \"prefill\": \"\"\n    },\n    \"organizationId\": {\n      \"title\": \"Organization ID\",\n      \"type\": \"string\",\n      \"description\": \"Optional SAM.gov federal organization ID, or a comma-separated list, to restrict results to specific departments, agencies or offices.\",\n      \"editor\": \"textfield\",\n      \"prefill\": \"\"\n    },\n    \"placeOfPerformanceState\": {\n      \"title\": \"Place of performance state\",\n      \"type\": \"string\",\n      \"description\": \"US state or territory where the work will be performed.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"\",\n        \"AL\",\n        \"AK\",\n        \"AZ\",\n        \"AR\",\n        \"CA\",\n        \"CO\",\n        \"CT\",\n        \"DE\",\n        \"DC\",\n        \"FL\",\n        \"GA\",\n        \"HI\",\n        \"ID\",\n        \"IL\",\n        \"IN\",\n        \"IA\",\n        \"KS\",\n        \"KY\",\n        \"LA\",\n        \"ME\",\n        \"MD\",\n        \"MA\",\n        \"MI\",\n        \"MN\",\n        \"MS\",\n        \"MO\",\n        \"MT\",\n        \"NE\",\n        \"NV\",\n        \"NH\",\n        \"NJ\",\n        \"NM\",\n        \"NY\",\n        \"NC\",\n        \"ND\",\n        \"OH\",\n        \"OK\",\n        \"OR\",\n        \"PA\",\n        \"RI\",\n        \"SC\",\n        \"SD\",\n        \"TN\",\n        \"TX\",\n        \"UT\",\n        \"VT\",\n        \"VA\",\n        \"WA\",\n        \"WV\",\n        \"WI\",\n        \"WY\",\n        \"AS\",\n        \"GU\",\n        \"MP\",\n        \"PR\",\n        \"VI\"\n      ],\n      \"enumTitles\": [\n        \"Any state\",\n        \"Alabama\",\n        \"Alaska\",\n        \"Arizona\",\n        \"Arkansas\",\n        \"California\",\n        \"Colorado\",\n        \"Connecticut\",\n        \"Delaware\",\n        \"District of Columbia\",\n        \"Florida\",\n        \"Georgia\",\n        \"Hawaii\",\n        \"Idaho\",\n        \"Illinois\",\n        \"Indiana\",\n        \"Iowa\",\n        \"Kansas\",\n        \"Kentucky\",\n        \"Louisiana\",\n        \"Maine\",\n        \"Maryland\",\n        \"Massachusetts\",\n        \"Michigan\",\n        \"Minnesota\",\n        \"Mississippi\",\n        \"Missouri\",\n        \"Montana\",\n        \"Nebraska\",\n        \"Nevada\",\n        \"New Hampshire\",\n        \"New Jersey\",\n        \"New Mexico\",\n        \"New York\",\n        \"North Carolina\",\n        \"North Dakota\",\n        \"Ohio\",\n        \"Oklahoma\",\n        \"Oregon\",\n        \"Pennsylvania\",\n        \"Rhode Island\",\n        \"South Carolina\",\n        \"South Dakota\",\n        \"Tennessee\",\n        \"Texas\",\n        \"Utah\",\n        \"Vermont\",\n        \"Virginia\",\n        \"Washington\",\n        \"West Virginia\",\n        \"Wisconsin\",\n        \"Wyoming\",\n        \"American Samoa\",\n        \"Guam\",\n        \"Northern Mariana Islands\",\n        \"Puerto Rico\",\n        \"US Virgin Islands\"\n      ],\n      \"default\": \"\",\n      \"prefill\": \"\"\n    },\n    \"placeOfPerformanceCountry\": {\n      \"title\": \"Place of performance country\",\n      \"type\": \"string\",\n      \"description\": \"Three-letter country code, e.g. USA. Leave empty for all countries.\",\n      \"editor\": \"textfield\",\n      \"prefill\": \"\"\n    },\n    \"postedFrom\": {\n      \"title\": \"Posted from\",\n      \"type\": \"string\",\n      \"description\": \"Only notices published on or after this date (YYYY-MM-DD).\",\n      \"editor\": \"textfield\",\n      \"sectionCaption\": \"Date filters\",\n      \"prefill\": \"\"\n    },\n    \"postedTo\": {\n      \"title\": \"Posted to\",\n      \"type\": \"string\",\n      \"description\": \"Only notices published on or before this date (YYYY-MM-DD).\",\n      \"editor\": \"textfield\",\n      \"prefill\": \"\"\n    },\n    \"responseFrom\": {\n      \"title\": \"Response deadline from\",\n      \"type\": \"string\",\n      \"description\": \"Only notices whose response deadline is on or after this date (YYYY-MM-DD).\",\n      \"editor\": \"textfield\",\n      \"prefill\": \"\"\n    },\n    \"responseTo\": {\n      \"title\": \"Response deadline to\",\n      \"type\": \"string\",\n      \"description\": \"Only notices whose response deadline is on or before this date (YYYY-MM-DD).\",\n      \"editor\": \"textfield\",\n      \"prefill\": \"\"\n    },\n    \"activeOnly\": {\n      \"title\": \"Active notices only\",\n      \"type\": \"boolean\",\n      \"description\": \"Keep only currently active notices. Turn off to include archived and inactive notices.\",\n      \"editor\": \"checkbox\",\n      \"default\": true,\n      \"prefill\": true,\n      \"sectionCaption\": \"Status and sorting\"\n    },\n    \"sort\": {\n      \"title\": \"Sort results\",\n      \"type\": \"string\",\n      \"description\": \"Order of returned notices. Best match needs search keywords.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"-modifiedDate\",\n        \"modifiedDate\",\n        \"-relevance\",\n        \"title\",\n        \"-title\"\n      ],\n      \"enumTitles\": [\n        \"Recently updated\",\n        \"Least recently updated\",\n        \"Best match\",\n        \"Title A-Z\",\n        \"Title Z-A\"\n      ],\n      \"default\": \"-modifiedDate\",\n      \"prefill\": \"-modifiedDate\"\n    },\n    \"awardNumber\": {\n      \"title\": \"Award or delivery order number\",\n      \"type\": \"string\",\n      \"description\": \"Filter award notices by contract award number or task/delivery order number.\",\n      \"editor\": \"textfield\",\n      \"sectionCaption\": \"Award filters\",\n      \"prefill\": \"\"\n    },\n    \"awardeeState\": {\n      \"title\": \"Awardee state\",\n      \"type\": \"string\",\n      \"description\": \"US state or territory of the awardee. Applies to award notices.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"\",\n        \"AL\",\n        \"AK\",\n        \"AZ\",\n        \"AR\",\n        \"CA\",\n        \"CO\",\n        \"CT\",\n        \"DE\",\n        \"DC\",\n        \"FL\",\n        \"GA\",\n        \"HI\",\n        \"ID\",\n        \"IL\",\n        \"IN\",\n        \"IA\",\n        \"KS\",\n        \"KY\",\n        \"LA\",\n        \"ME\",\n        \"MD\",\n        \"MA\",\n        \"MI\",\n        \"MN\",\n        \"MS\",\n        \"MO\",\n        \"MT\",\n        \"NE\",\n        \"NV\",\n        \"NH\",\n        \"NJ\",\n        \"NM\",\n        \"NY\",\n        \"NC\",\n        \"ND\",\n        \"OH\",\n        \"OK\",\n        \"OR\",\n        \"PA\",\n        \"RI\",\n        \"SC\",\n        \"SD\",\n        \"TN\",\n        \"TX\",\n        \"UT\",\n        \"VT\",\n        \"VA\",\n        \"WA\",\n        \"WV\",\n        \"WI\",\n        \"WY\",\n        \"AS\",\n        \"GU\",\n        \"MP\",\n        \"PR\",\n        \"VI\"\n      ],\n      \"enumTitles\": [\n        \"Any state\",\n        \"Alabama\",\n        \"Alaska\",\n        \"Arizona\",\n        \"Arkansas\",\n        \"California\",\n        \"Colorado\",\n        \"Connecticut\",\n        \"Delaware\",\n        \"District of Columbia\",\n        \"Florida\",\n        \"Georgia\",\n        \"Hawaii\",\n        \"Idaho\",\n        \"Illinois\",\n        \"Indiana\",\n        \"Iowa\",\n        \"Kansas\",\n        \"Kentucky\",\n        \"Louisiana\",\n        \"Maine\",\n        \"Maryland\",\n        \"Massachusetts\",\n        \"Michigan\",\n        \"Minnesota\",\n        \"Mississippi\",\n        \"Missouri\",\n        \"Montana\",\n        \"Nebraska\",\n        \"Nevada\",\n        \"New Hampshire\",\n        \"New Jersey\",\n        \"New Mexico\",\n        \"New York\",\n        \"North Carolina\",\n        \"North Dakota\",\n        \"Ohio\",\n        \"Oklahoma\",\n        \"Oregon\",\n        \"Pennsylvania\",\n        \"Rhode Island\",\n        \"South Carolina\",\n        \"South Dakota\",\n        \"Tennessee\",\n        \"Texas\",\n        \"Utah\",\n        \"Vermont\",\n        \"Virginia\",\n        \"Washington\",\n        \"West Virginia\",\n        \"Wisconsin\",\n        \"Wyoming\",\n        \"American Samoa\",\n        \"Guam\",\n        \"Northern Mariana Islands\",\n        \"Puerto Rico\",\n        \"US Virgin Islands\"\n      ],\n      \"default\": \"\",\n      \"prefill\": \"\"\n    },\n    \"awardAmountFrom\": {\n      \"title\": \"Award amount from\",\n      \"type\": \"string\",\n      \"description\": \"Minimum award amount in US dollars, e.g. 100000.\",\n      \"editor\": \"textfield\",\n      \"prefill\": \"\"\n    },\n    \"awardAmountTo\": {\n      \"title\": \"Award amount to\",\n      \"type\": \"string\",\n      \"description\": \"Maximum award amount in US dollars, e.g. 5000000.\",\n      \"editor\": \"textfield\",\n      \"prefill\": \"\"\n    },\n    \"includeDetails\": {\n      \"title\": \"Include full notice details\",\n      \"type\": \"boolean\",\n      \"description\": \"Fetch each notice's detail page for NAICS/PSC, set-aside, award amount, contacts and description. Adds one request per notice.\",\n      \"editor\": \"checkbox\",\n      \"default\": true,\n      \"prefill\": true,\n      \"sectionCaption\": \"Record options\"\n    },\n    \"includeAttachments\": {\n      \"title\": \"Include attachment list\",\n      \"type\": \"boolean\",\n      \"description\": \"List each notice's attachments with public download links. Adds one request per notice.\",\n      \"editor\": \"checkbox\",\n      \"default\": true,\n      \"prefill\": true\n    },\n    \"noticeIds\": {\n      \"title\": \"Notice IDs or URLs\",\n      \"type\": \"array\",\n      \"description\": \"Used in fetch mode. Paste SAM.gov notice IDs, solicitation numbers, or sam.gov/opp/<id>/view URLs.\",\n      \"editor\": \"stringList\",\n      \"sectionCaption\": \"Direct notice lookup\",\n      \"prefill\": []\n    },\n    \"maxItems\": {\n      \"title\": \"Maximum notices\",\n      \"type\": \"integer\",\n      \"description\": \"Maximum number of notices to return (1-10,000). SAM.gov caps any single query at 10,000 records.\",\n      \"minimum\": 1,\n      \"maximum\": 10000,\n      \"default\": 25,\n      \"prefill\": 2\n    }\n  },\n  \"required\": []\n}",
    "readme": "# SAM.gov Federal Contract & Award Notice Scraper\n\nSAM.gov is the US government's official portal for federal contracting. This actor turns its public Contract Opportunities search into a clean dataset of solicitations, presolicitations, sources-sought notices, special notices, surplus-property sales, justifications and award notices — with no API key, account, cookie or proxy setup — cookieless from the first request.\n\n## What you get\n\n- **Filtered notice search.** Match keywords across titles and descriptions, then narrow by notice type, NAICS, PSC, set-aside, state, country, federal organization, award number, award amount and publication or response-deadline dates.\n- **Award notices alongside solicitations.** Award records include the contract award number, delivery/task order number, award date, amount, awardee name, UEI, CAGE code and awardee address when SAM.gov publishes them.\n- **Full notice enrichment.** Each record can include the department/agency/office hierarchy, contracting-office address, contracting officer contacts, place of performance, NAICS and PSC classification, response deadline, plain-text description and a list of attachments with public download links.\n- **Direct lookup.** Paste one or more SAM.gov notice IDs, solicitation numbers or `sam.gov/opp/<id>/view` links to fetch those notices directly.\n- **Stable links.** Every record has a `sourceUrl` that opens the official notice on SAM.gov.\n\n## Data source\n\nThe actor reads the same public JSON endpoints that power the SAM.gov Contract Opportunities search and notice pages. No developer key is involved, so results are available to every user immediately. Attachments are listed with their public `sam.gov` download links; file bytes are not copied into the dataset.\n\n## Modes\n\n| Mode | Use it for |\n|---|---|\n| Search contract and award notices | Keyword and filter discovery with pagination |\n| Fetch specific notices by ID or URL | A known notice, solicitation number or SAM.gov link |\n\nSearch results are de-duplicated by notice ID and paginated until `maxItems` is reached or SAM.gov runs out of matches. SAM.gov caps any single query at 10,000 records; the actor reports that ceiling in the run status when a query reaches it.\n\n## Input\n\n| Field | Type | Default | Notes |\n|---|---|---|---|\n| `operation` | select | `search` | Search or direct notice lookup |\n| `searchQuery` | text | – | Words matched in titles and descriptions (prefilled with `software`) |\n| `matchMode` | select | `ALL` | All words, any words or exact phrase |\n| `noticeType` | select | all | Award, solicitation, presolicitation, sources sought and more |\n| `naicsCode` | text | – | Comma-separated codes or ranges |\n| `pscCode` | text | – | Product Service Code list |\n| `setAside` | select | all | Small-business and socioeconomic set-asides |\n| `organizationId` | text | – | Federal organization ID(s) |\n| `placeOfPerformanceState` | select | any | US state or territory |\n| `placeOfPerformanceCountry` | text | – | Three-letter country code |\n| `postedFrom` / `postedTo` | text | – | Publication date range (`YYYY-MM-DD`) |\n| `responseFrom` / `responseTo` | text | – | Response-deadline range (`YYYY-MM-DD`) |\n| `activeOnly` | boolean | `true` | Include archived/inactive notices when off |\n| `sort` | select | `-modifiedDate` | Recently updated; also oldest, best match, title A-Z/Z-A |\n| `awardNumber` | text | – | Award or delivery-order number |\n| `awardeeState` | select | any | Awardee state or territory |\n| `awardAmountFrom` / `awardAmountTo` | text | – | Award amount range in USD |\n| `includeDetails` | boolean | `true` | Enrich from the detail page |\n| `includeAttachments` | boolean | `true` | Add attachment metadata and links |\n| `noticeIds` | array | – | Notice IDs, solicitation numbers or SAM.gov URLs (lookup mode) |\n| `maxItems` | integer | `25` | 1–10,000 |\n\n### Example: software awards above $1M\n\n```json\n{\n  \"operation\": \"search\",\n  \"searchQuery\": \"software\",\n  \"noticeType\": \"a\",\n  \"awardAmountFrom\": \"1000000\",\n  \"postedFrom\": \"2026-01-01\",\n  \"activeOnly\": true,\n  \"maxItems\": 100\n}\n```\n\n### Example: solicitations for one NAICS in one state\n\n```json\n{\n  \"operation\": \"search\",\n  \"noticeType\": \"k\",\n  \"naicsCode\": \"561730\",\n  \"placeOfPerformanceState\": \"PA\",\n  \"postedFrom\": \"2026-10-01\",\n  \"postedTo\": \"2026-11-30\",\n  \"maxItems\": 50\n}\n```\n\n### Example: fetch notices from links\n\n```json\n{\n  \"operation\": \"getNoticeDetails\",\n  \"noticeIds\": [\n    \"d24e3bf678c04995a191257b45bfb7e0\",\n    \"https://sam.gov/opp/211fae31d1dc44e4acca55c00a57c224/view\"\n  ]\n}\n```\n\n## Output fields\n\nCore identity and dates: `noticeId`, `title`, `solicitationNumber`, `type`, `typeCode`, `baseType`, `postedDate`, `modifiedDate`, `responseDeadline`, `responseDeadlineTimezone`, `archiveDate`, `archiveType`, `status`, `active`, `isCanceled`, `sourceUrl`, `recordType`, `scrapedAt`.\n\nOrganization and place: `department`, `agency`, `office`, `officeAddress`, `placeOfPerformance`.\n\nClassification and set-aside: `classificationCode` (PSC), `naicsCode`, `naicsCodes`, `setAside`, `setAsideCode`.\n\nAward outcome: `awardDate`, `awardAmount`, `awardNumber`, `deliveryOrderNumber`, `awardeeName`, `awardeeUei`, `awardeeCageCode`, `awardeeAddress`.\n\nPeople and content: `pointOfContact`, `description`, `attachments`, `attachmentCount`.\n\nFields SAM.gov does not publish for a particular notice are omitted rather than written as `null` or an empty string.\n\n## Backward compatibility\n\nSaved tasks that use the earlier `mode` field with `searchOpportunities` / `getOpportunityDetail` values, `opportunityType`, `postedFrom` / `postedTo`, `setAside`, `noticeIds` or `maxItems` keep working. The old `apiKey` value is accepted and ignored — no key is needed now. Existing output fields keep their names; new fields are additive.\n\n## Limits and notes\n\n- **10,000 records per query.** This is SAM.gov's own search ceiling. Narrow by date, NAICS/PSC, state, notice type or set-aside to reach older notices.\n- **Attachments are metadata plus links.** SAM.gov serves the files themselves from its own download endpoint; the actor does not rehost multi-hundred-MB drawings.\n- **Descriptions are plain text.** Formatting and tables from the source HTML are flattened for dataset compatibility.\n- **Award fields are conditional.** Solicitations that have not been awarded yet have no award amount or awardee.\n- **Not affiliated with SAM.gov or GSA.** Public federal data is provided as-is by the source.\n\n## FAQ\n\n**Do I need a SAM.gov API key?** No. The actor uses the public search, notice and attachment endpoints that SAM.gov serves to every visitor.\n\n**Why did I get fewer rows than `maxItems`?** The filters matched fewer notices, SAM.gov's 10,000-record ceiling was reached, or records were de-duplicated across pages.\n\n**Can I filter by agency name?** Use `organizationId` with SAM.gov's numeric organization ID. A keyword or NAICS filter is often easier for departments with many offices.\n\n**Does it monitor for new notices?** No. Schedule the actor and use `postedFrom` or `activeOnly` to focus each run; de-duplicate across runs by `noticeId`.\n",
    "actorDefinition": {
      "actorSpecification": 1,
      "name": "sam-gov-federal-contract-and-award-notice-scraper",
      "title": "SAM.gov Federal Contract & Award Notice Scraper",
      "description": "Search US federal contract opportunities and award notices on SAM.gov by keyword, NAICS/PSC code, set-aside, state, agency, award number and date range, or fetch specific notices by ID or URL. No API key, account or cookie required; returns full details, contacts and attachment links.",
      "version": "1.0",
      "buildTag": "latest",
      "dockerfile": "../Dockerfile",
      "readme": "# SAM.gov Federal Contract & Award Notice Scraper\n\nSAM.gov is the US government's official portal for federal contracting. This actor turns its public Contract Opportunities search into a clean dataset of solicitations, presolicitations, sources-sought notices, special notices, surplus-property sales, justifications and award notices — with no API key, account, cookie or proxy setup — cookieless from the first request.\n\n## What you get\n\n- **Filtered notice search.** Match keywords across titles and descriptions, then narrow by notice type, NAICS, PSC, set-aside, state, country, federal organization, award number, award amount and publication or response-deadline dates.\n- **Award notices alongside solicitations.** Award records include the contract award number, delivery/task order number, award date, amount, awardee name, UEI, CAGE code and awardee address when SAM.gov publishes them.\n- **Full notice enrichment.** Each record can include the department/agency/office hierarchy, contracting-office address, contracting officer contacts, place of performance, NAICS and PSC classification, response deadline, plain-text description and a list of attachments with public download links.\n- **Direct lookup.** Paste one or more SAM.gov notice IDs, solicitation numbers or `sam.gov/opp/<id>/view` links to fetch those notices directly.\n- **Stable links.** Every record has a `sourceUrl` that opens the official notice on SAM.gov.\n\n## Data source\n\nThe actor reads the same public JSON endpoints that power the SAM.gov Contract Opportunities search and notice pages. No developer key is involved, so results are available to every user immediately. Attachments are listed with their public `sam.gov` download links; file bytes are not copied into the dataset.\n\n## Modes\n\n| Mode | Use it for |\n|---|---|\n| Search contract and award notices | Keyword and filter discovery with pagination |\n| Fetch specific notices by ID or URL | A known notice, solicitation number or SAM.gov link |\n\nSearch results are de-duplicated by notice ID and paginated until `maxItems` is reached or SAM.gov runs out of matches. SAM.gov caps any single query at 10,000 records; the actor reports that ceiling in the run status when a query reaches it.\n\n## Input\n\n| Field | Type | Default | Notes |\n|---|---|---|---|\n| `operation` | select | `search` | Search or direct notice lookup |\n| `searchQuery` | text | – | Words matched in titles and descriptions (prefilled with `software`) |\n| `matchMode` | select | `ALL` | All words, any words or exact phrase |\n| `noticeType` | select | all | Award, solicitation, presolicitation, sources sought and more |\n| `naicsCode` | text | – | Comma-separated codes or ranges |\n| `pscCode` | text | – | Product Service Code list |\n| `setAside` | select | all | Small-business and socioeconomic set-asides |\n| `organizationId` | text | – | Federal organization ID(s) |\n| `placeOfPerformanceState` | select | any | US state or territory |\n| `placeOfPerformanceCountry` | text | – | Three-letter country code |\n| `postedFrom` / `postedTo` | text | – | Publication date range (`YYYY-MM-DD`) |\n| `responseFrom` / `responseTo` | text | – | Response-deadline range (`YYYY-MM-DD`) |\n| `activeOnly` | boolean | `true` | Include archived/inactive notices when off |\n| `sort` | select | `-modifiedDate` | Recently updated; also oldest, best match, title A-Z/Z-A |\n| `awardNumber` | text | – | Award or delivery-order number |\n| `awardeeState` | select | any | Awardee state or territory |\n| `awardAmountFrom` / `awardAmountTo` | text | – | Award amount range in USD |\n| `includeDetails` | boolean | `true` | Enrich from the detail page |\n| `includeAttachments` | boolean | `true` | Add attachment metadata and links |\n| `noticeIds` | array | – | Notice IDs, solicitation numbers or SAM.gov URLs (lookup mode) |\n| `maxItems` | integer | `25` | 1–10,000 |\n\n### Example: software awards above $1M\n\n```json\n{\n  \"operation\": \"search\",\n  \"searchQuery\": \"software\",\n  \"noticeType\": \"a\",\n  \"awardAmountFrom\": \"1000000\",\n  \"postedFrom\": \"2026-01-01\",\n  \"activeOnly\": true,\n  \"maxItems\": 100\n}\n```\n\n### Example: solicitations for one NAICS in one state\n\n```json\n{\n  \"operation\": \"search\",\n  \"noticeType\": \"k\",\n  \"naicsCode\": \"561730\",\n  \"placeOfPerformanceState\": \"PA\",\n  \"postedFrom\": \"2026-10-01\",\n  \"postedTo\": \"2026-11-30\",\n  \"maxItems\": 50\n}\n```\n\n### Example: fetch notices from links\n\n```json\n{\n  \"operation\": \"getNoticeDetails\",\n  \"noticeIds\": [\n    \"d24e3bf678c04995a191257b45bfb7e0\",\n    \"https://sam.gov/opp/211fae31d1dc44e4acca55c00a57c224/view\"\n  ]\n}\n```\n\n## Output fields\n\nCore identity and dates: `noticeId`, `title`, `solicitationNumber`, `type`, `typeCode`, `baseType`, `postedDate`, `modifiedDate`, `responseDeadline`, `responseDeadlineTimezone`, `archiveDate`, `archiveType`, `status`, `active`, `isCanceled`, `sourceUrl`, `recordType`, `scrapedAt`.\n\nOrganization and place: `department`, `agency`, `office`, `officeAddress`, `placeOfPerformance`.\n\nClassification and set-aside: `classificationCode` (PSC), `naicsCode`, `naicsCodes`, `setAside`, `setAsideCode`.\n\nAward outcome: `awardDate`, `awardAmount`, `awardNumber`, `deliveryOrderNumber`, `awardeeName`, `awardeeUei`, `awardeeCageCode`, `awardeeAddress`.\n\nPeople and content: `pointOfContact`, `description`, `attachments`, `attachmentCount`.\n\nFields SAM.gov does not publish for a particular notice are omitted rather than written as `null` or an empty string.\n\n## Backward compatibility\n\nSaved tasks that use the earlier `mode` field with `searchOpportunities` / `getOpportunityDetail` values, `opportunityType`, `postedFrom` / `postedTo`, `setAside`, `noticeIds` or `maxItems` keep working. The old `apiKey` value is accepted and ignored — no key is needed now. Existing output fields keep their names; new fields are additive.\n\n## Limits and notes\n\n- **10,000 records per query.** This is SAM.gov's own search ceiling. Narrow by date, NAICS/PSC, state, notice type or set-aside to reach older notices.\n- **Attachments are metadata plus links.** SAM.gov serves the files themselves from its own download endpoint; the actor does not rehost multi-hundred-MB drawings.\n- **Descriptions are plain text.** Formatting and tables from the source HTML are flattened for dataset compatibility.\n- **Award fields are conditional.** Solicitations that have not been awarded yet have no award amount or awardee.\n- **Not affiliated with SAM.gov or GSA.** Public federal data is provided as-is by the source.\n\n## FAQ\n\n**Do I need a SAM.gov API key?** No. The actor uses the public search, notice and attachment endpoints that SAM.gov serves to every visitor.\n\n**Why did I get fewer rows than `maxItems`?** The filters matched fewer notices, SAM.gov's 10,000-record ceiling was reached, or records were de-duplicated across pages.\n\n**Can I filter by agency name?** Use `organizationId` with SAM.gov's numeric organization ID. A keyword or NAICS filter is often easier for departments with many offices.\n\n**Does it monitor for new notices?** No. Schedule the actor and use `postedFrom` or `activeOnly` to focus each run; de-duplicate across runs by `noticeId`.\n",
      "input": {
        "title": "SAM.gov Contract & Award Notice Scraper Input",
        "description": "Search US federal contract opportunities and award notices on SAM.gov, or fetch specific notices by ID or URL. No account, API key or cookie is required.",
        "type": "object",
        "schemaVersion": 1,
        "properties": {
          "operation": {
            "title": "Operation",
            "type": "string",
            "description": "Search notices with filters, or fetch specific notices by ID or sam.gov URL.",
            "editor": "select",
            "enum": [
              "search",
              "getNoticeDetails"
            ],
            "enumTitles": [
              "Search contract and award notices",
              "Fetch specific notices by ID or URL"
            ],
            "default": "search",
            "prefill": "search"
          },
          "mode": {
            "title": "Legacy mode",
            "type": "string",
            "description": "Legacy mode value accepted for backward compatibility. Use `operation` instead.",
            "editor": "hidden"
          },
          "searchQuery": {
            "title": "Search keywords",
            "type": "string",
            "description": "Words to match in notice titles and descriptions. Leave empty to browse by filters only.",
            "editor": "textfield",
            "sectionCaption": "Search filters",
            "prefill": "software"
          },
          "matchMode": {
            "title": "Keyword matching",
            "type": "string",
            "description": "How multiple keywords must match. Best match sorting uses relevance when keywords are set.",
            "editor": "select",
            "enum": [
              "ALL",
              "ANY",
              "EXACT"
            ],
            "enumTitles": [
              "All words",
              "Any words",
              "Exact phrase"
            ],
            "default": "ALL",
            "prefill": "ALL"
          },
          "noticeType": {
            "title": "Notice type",
            "type": "string",
            "description": "Restrict results to one notice type, such as solicitations or award notices.",
            "editor": "select",
            "enum": [
              "",
              "a",
              "k",
              "o",
              "p",
              "r",
              "s",
              "g",
              "i",
              "u"
            ],
            "enumTitles": [
              "All notice types",
              "Award Notice",
              "Combined Synopsis/Solicitation",
              "Solicitation",
              "Presolicitation",
              "Sources Sought",
              "Special Notice",
              "Sale of Surplus Property",
              "Consolidate/(Substantially) Bundle",
              "Justification"
            ],
            "default": "",
            "prefill": ""
          },
          "naicsCode": {
            "title": "NAICS code",
            "type": "string",
            "description": "One or more NAICS codes, comma-separated. Ranges are accepted, e.g. 541511,541512 or 561730-561740.",
            "editor": "textfield",
            "prefill": ""
          },
          "pscCode": {
            "title": "Product Service Code (PSC)",
            "type": "string",
            "description": "One or more PSC codes, comma-separated, e.g. D302 or 7A21.",
            "editor": "textfield",
            "prefill": ""
          },
          "setAside": {
            "title": "Set-aside",
            "type": "string",
            "description": "Small-business and socioeconomic set-aside designation.",
            "editor": "select",
            "enum": [
              "",
              "SBA",
              "SBP",
              "8A",
              "8AN",
              "HZC",
              "HZS",
              "SDVOSBC",
              "SDVOSBS",
              "WOSB",
              "WOSBSS",
              "EDWOSB",
              "EDWOSBSS",
              "IEE",
              "ISBEE",
              "LAS"
            ],
            "enumTitles": [
              "All set-asides",
              "Total Small Business",
              "Partial Small Business",
              "8(a) Set-Aside",
              "8(a) Sole Source",
              "HUBZone Set-Aside",
              "HUBZone Sole Source",
              "Service-Disabled Veteran-Owned Small Business",
              "Service-Disabled Veteran-Owned Small Business Sole Source",
              "Women-Owned Small Business",
              "Women-Owned Small Business Sole Source",
              "Economically Disadvantaged WOSB",
              "Economically Disadvantaged WOSB Sole Source",
              "Indian Economic Enterprise",
              "Indian Small Business Economic Enterprise",
              "Local Area Set-Aside"
            ],
            "default": "",
            "prefill": ""
          },
          "organizationId": {
            "title": "Organization ID",
            "type": "string",
            "description": "Optional SAM.gov federal organization ID, or a comma-separated list, to restrict results to specific departments, agencies or offices.",
            "editor": "textfield",
            "prefill": ""
          },
          "placeOfPerformanceState": {
            "title": "Place of performance state",
            "type": "string",
            "description": "US state or territory where the work will be performed.",
            "editor": "select",
            "enum": [
              "",
              "AL",
              "AK",
              "AZ",
              "AR",
              "CA",
              "CO",
              "CT",
              "DE",
              "DC",
              "FL",
              "GA",
              "HI",
              "ID",
              "IL",
              "IN",
              "IA",
              "KS",
              "KY",
              "LA",
              "ME",
              "MD",
              "MA",
              "MI",
              "MN",
              "MS",
              "MO",
              "MT",
              "NE",
              "NV",
              "NH",
              "NJ",
              "NM",
              "NY",
              "NC",
              "ND",
              "OH",
              "OK",
              "OR",
              "PA",
              "RI",
              "SC",
              "SD",
              "TN",
              "TX",
              "UT",
              "VT",
              "VA",
              "WA",
              "WV",
              "WI",
              "WY",
              "AS",
              "GU",
              "MP",
              "PR",
              "VI"
            ],
            "enumTitles": [
              "Any state",
              "Alabama",
              "Alaska",
              "Arizona",
              "Arkansas",
              "California",
              "Colorado",
              "Connecticut",
              "Delaware",
              "District of Columbia",
              "Florida",
              "Georgia",
              "Hawaii",
              "Idaho",
              "Illinois",
              "Indiana",
              "Iowa",
              "Kansas",
              "Kentucky",
              "Louisiana",
              "Maine",
              "Maryland",
              "Massachusetts",
              "Michigan",
              "Minnesota",
              "Mississippi",
              "Missouri",
              "Montana",
              "Nebraska",
              "Nevada",
              "New Hampshire",
              "New Jersey",
              "New Mexico",
              "New York",
              "North Carolina",
              "North Dakota",
              "Ohio",
              "Oklahoma",
              "Oregon",
              "Pennsylvania",
              "Rhode Island",
              "South Carolina",
              "South Dakota",
              "Tennessee",
              "Texas",
              "Utah",
              "Vermont",
              "Virginia",
              "Washington",
              "West Virginia",
              "Wisconsin",
              "Wyoming",
              "American Samoa",
              "Guam",
              "Northern Mariana Islands",
              "Puerto Rico",
              "US Virgin Islands"
            ],
            "default": "",
            "prefill": ""
          },
          "placeOfPerformanceCountry": {
            "title": "Place of performance country",
            "type": "string",
            "description": "Three-letter country code, e.g. USA. Leave empty for all countries.",
            "editor": "textfield",
            "prefill": ""
          },
          "postedFrom": {
            "title": "Posted from",
            "type": "string",
            "description": "Only notices published on or after this date (YYYY-MM-DD).",
            "editor": "textfield",
            "sectionCaption": "Date filters",
            "prefill": ""
          },
          "postedTo": {
            "title": "Posted to",
            "type": "string",
            "description": "Only notices published on or before this date (YYYY-MM-DD).",
            "editor": "textfield",
            "prefill": ""
          },
          "responseFrom": {
            "title": "Response deadline from",
            "type": "string",
            "description": "Only notices whose response deadline is on or after this date (YYYY-MM-DD).",
            "editor": "textfield",
            "prefill": ""
          },
          "responseTo": {
            "title": "Response deadline to",
            "type": "string",
            "description": "Only notices whose response deadline is on or before this date (YYYY-MM-DD).",
            "editor": "textfield",
            "prefill": ""
          },
          "activeOnly": {
            "title": "Active notices only",
            "type": "boolean",
            "description": "Keep only currently active notices. Turn off to include archived and inactive notices.",
            "editor": "checkbox",
            "default": true,
            "prefill": true,
            "sectionCaption": "Status and sorting"
          },
          "sort": {
            "title": "Sort results",
            "type": "string",
            "description": "Order of returned notices. Best match needs search keywords.",
            "editor": "select",
            "enum": [
              "-modifiedDate",
              "modifiedDate",
              "-relevance",
              "title",
              "-title"
            ],
            "enumTitles": [
              "Recently updated",
              "Least recently updated",
              "Best match",
              "Title A-Z",
              "Title Z-A"
            ],
            "default": "-modifiedDate",
            "prefill": "-modifiedDate"
          },
          "awardNumber": {
            "title": "Award or delivery order number",
            "type": "string",
            "description": "Filter award notices by contract award number or task/delivery order number.",
            "editor": "textfield",
            "sectionCaption": "Award filters",
            "prefill": ""
          },
          "awardeeState": {
            "title": "Awardee state",
            "type": "string",
            "description": "US state or territory of the awardee. Applies to award notices.",
            "editor": "select",
            "enum": [
              "",
              "AL",
              "AK",
              "AZ",
              "AR",
              "CA",
              "CO",
              "CT",
              "DE",
              "DC",
              "FL",
              "GA",
              "HI",
              "ID",
              "IL",
              "IN",
              "IA",
              "KS",
              "KY",
              "LA",
              "ME",
              "MD",
              "MA",
              "MI",
              "MN",
              "MS",
              "MO",
              "MT",
              "NE",
              "NV",
              "NH",
              "NJ",
              "NM",
              "NY",
              "NC",
              "ND",
              "OH",
              "OK",
              "OR",
              "PA",
              "RI",
              "SC",
              "SD",
              "TN",
              "TX",
              "UT",
              "VT",
              "VA",
              "WA",
              "WV",
              "WI",
              "WY",
              "AS",
              "GU",
              "MP",
              "PR",
              "VI"
            ],
            "enumTitles": [
              "Any state",
              "Alabama",
              "Alaska",
              "Arizona",
              "Arkansas",
              "California",
              "Colorado",
              "Connecticut",
              "Delaware",
              "District of Columbia",
              "Florida",
              "Georgia",
              "Hawaii",
              "Idaho",
              "Illinois",
              "Indiana",
              "Iowa",
              "Kansas",
              "Kentucky",
              "Louisiana",
              "Maine",
              "Maryland",
              "Massachusetts",
              "Michigan",
              "Minnesota",
              "Mississippi",
              "Missouri",
              "Montana",
              "Nebraska",
              "Nevada",
              "New Hampshire",
              "New Jersey",
              "New Mexico",
              "New York",
              "North Carolina",
              "North Dakota",
              "Ohio",
              "Oklahoma",
              "Oregon",
              "Pennsylvania",
              "Rhode Island",
              "South Carolina",
              "South Dakota",
              "Tennessee",
              "Texas",
              "Utah",
              "Vermont",
              "Virginia",
              "Washington",
              "West Virginia",
              "Wisconsin",
              "Wyoming",
              "American Samoa",
              "Guam",
              "Northern Mariana Islands",
              "Puerto Rico",
              "US Virgin Islands"
            ],
            "default": "",
            "prefill": ""
          },
          "awardAmountFrom": {
            "title": "Award amount from",
            "type": "string",
            "description": "Minimum award amount in US dollars, e.g. 100000.",
            "editor": "textfield",
            "prefill": ""
          },
          "awardAmountTo": {
            "title": "Award amount to",
            "type": "string",
            "description": "Maximum award amount in US dollars, e.g. 5000000.",
            "editor": "textfield",
            "prefill": ""
          },
          "includeDetails": {
            "title": "Include full notice details",
            "type": "boolean",
            "description": "Fetch each notice's detail page for NAICS/PSC, set-aside, award amount, contacts and description. Adds one request per notice.",
            "editor": "checkbox",
            "default": true,
            "prefill": true,
            "sectionCaption": "Record options"
          },
          "includeAttachments": {
            "title": "Include attachment list",
            "type": "boolean",
            "description": "List each notice's attachments with public download links. Adds one request per notice.",
            "editor": "checkbox",
            "default": true,
            "prefill": true
          },
          "noticeIds": {
            "title": "Notice IDs or URLs",
            "type": "array",
            "description": "Used in fetch mode. Paste SAM.gov notice IDs, solicitation numbers, or sam.gov/opp/<id>/view URLs.",
            "editor": "stringList",
            "sectionCaption": "Direct notice lookup",
            "prefill": []
          },
          "maxItems": {
            "title": "Maximum notices",
            "type": "integer",
            "description": "Maximum number of notices to return (1-10,000). SAM.gov caps any single query at 10,000 records.",
            "minimum": 1,
            "maximum": 10000,
            "default": 25,
            "prefill": 2
          }
        },
        "required": []
      },
      "output": {
        "actorOutputSchemaVersion": 1,
        "title": "SAM.gov Federal Contract & Award Notice Scraper Output",
        "description": "US federal contract opportunities and award notices from SAM.gov, including organization, classification, set-aside, deadlines, award outcome, contacts, place of performance, descriptions and attachments.",
        "properties": {
          "notices": {
            "type": "string",
            "title": "Contract and award notices",
            "description": "Dataset containing every scraped SAM.gov notice record.",
            "template": "{{links.apiDefaultDatasetUrl}}/items"
          }
        }
      },
      "storages": {
        "dataset": {
          "actorSpecification": 1,
          "views": {
            "overview": {
              "title": "Opportunities",
              "transformation": {
                "fields": [
                  "noticeId",
                  "title",
                  "type",
                  "department",
                  "agency",
                  "postedDate",
                  "responseDeadline",
                  "naicsCode",
                  "setAside",
                  "awardAmount",
                  "awardeeName",
                  "sourceUrl"
                ]
              },
              "display": {
                "component": "table",
                "properties": {}
              }
            }
          }
        }
      },
      "environmentVariables": {}
    },
    "buildNumber": "1.0.2",
    "imageDigest": "9c581e112d708dee6362b71275e44de4757d231e1a15d76c62fba776232d47db",
    "actVersion": {
      "sourceType": "SOURCE_FILES",
      "buildTag": "latest",
      "versionNumber": "1.0"
    },
    "usage": {
      "ACTOR_COMPUTE_UNITS": 0.00511
    }
  }
}