{"uid":"cap_cZVzbDYoOnDgMgpp6ajQY","slug":"agentic-gov-contracts-vercel-app-ef60c727","name":"Gov Contract Scout – SAM.gov Opportunity Search","description":"Search normalized SAM.gov contract opportunities with full-text and structured filters. Supports SAM.gov-compatible aliases where useful.","url":"https://agentic-gov-contracts.vercel.app/api/opportunities/search","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"q":{"type":"string","description":"Full-text query across title, solicitation number, organization, office, NAICS/PSC, set-aside, and description text."},"psc":{"type":"string","description":"Agent-friendly alias for SAM.gov ccode/classificationCode."},"zip":{"type":"string","x-sam-gov":{"name":"zip","required":false},"description":"Place of performance ZIP code. Original SAM.gov parameter: zip."},"ccode":{"type":"string","x-sam-gov":{"name":"ccode","required":false},"description":"Classification code / PSC. Original SAM.gov parameter: ccode."},"limit":{"type":"integer","x-sam-gov":{"name":"limit","required":false},"description":"Records per page. SAM.gov maximum is 1000 and default is 1; Gov Contract Scout public search caps at 100. Original SAM.gov parameter: limit."},"naics":{"type":"string","description":"Agent-friendly alias for SAM.gov ncode."},"ncode":{"type":"string","x-sam-gov":{"name":"ncode","required":false},"description":"NAICS code. SAM.gov documents a maximum of 6 digits. Original SAM.gov parameter: ncode."},"ptype":{"enum":["u","p","a","r","s","o","g","k","i"],"type":"string","x-sam-gov":{"name":"ptype","required":false},"description":"Procurement type code. May be repeated by SAM.gov; Gov Contract Scout also accepts comma-separated values. Original SAM.gov parameter: ptype."},"rdlto":{"type":"string","x-sam-gov":{"name":"rdlto","required":false},"description":"Response deadline to. SAM.gov format is MM/dd/yyyy; rdlfrom/rdlto date range is limited to one year. Original SAM.gov parameter: rdlto."},"state":{"type":"string","x-sam-gov":{"name":"state","required":false},"description":"Place of performance state. Original SAM.gov parameter: state."},"title":{"type":"string","x-sam-gov":{"name":"title","required":false},"description":"Opportunity title search. Original SAM.gov parameter: title."},"active":{"type":"boolean","description":"Agent-friendly active filter."},"agency":{"type":"string","description":"Agent-friendly alias for SAM.gov organizationName/fullParentPathName."},"offset":{"type":"integer","x-sam-gov":{"name":"offset","required":false},"description":"Page index. SAM.gov default starts with 0. Original SAM.gov parameter: offset."},"solnum":{"type":"string","x-sam-gov":{"name":"solnum","required":false},"description":"Solicitation number. Original SAM.gov parameter: solnum."},"status":{"enum":["active","inactive","archived","cancelled","deleted"],"type":"string","x-sam-gov":{"name":"status","required":false},"description":"Opportunity status. SAM.gov notes this as coming soon; documented values are active, inactive, archived, cancelled, and deleted. Original SAM.gov parameter: status."},"rdlfrom":{"type":"string","x-sam-gov":{"name":"rdlfrom","required":false},"description":"Response deadline from. SAM.gov format is MM/dd/yyyy; rdlfrom/rdlto date range is limited to one year. Original SAM.gov parameter: rdlfrom."},"subtier":{"type":"string","x-sam-gov":{"name":"subtier","required":false},"description":"Agency Name (L2). Deprecated by SAM.gov. Original SAM.gov parameter: subtier."},"deptname":{"type":"string","x-sam-gov":{"name":"deptname","required":false},"description":"Department Name (L1). Deprecated by SAM.gov. Original SAM.gov parameter: deptname."},"dueAfter":{"type":"string","format":"date","description":"Agent-friendly alias for rdlfrom."},"keywords":{"type":"string","description":"Alias for q."},"location":{"type":"string","description":"Agent-friendly place-of-performance search across state/ZIP/address JSON."},"noticeid":{"type":"string","x-sam-gov":{"name":"noticeid","required":false},"description":"SAM.gov notice ID. Original SAM.gov parameter: noticeid."},"postedTo":{"type":"string","x-sam-gov":{"name":"postedTo","required":true},"description":"Posted date to. SAM.gov format is MM/dd/yyyy; date range between postedFrom and postedTo is limited to one year. Original SAM.gov parameter: postedTo."},"setAside":{"type":"string","description":"Agent-friendly search across typeOfSetAside and typeOfSetAsideDescription."},"dueBefore":{"type":"string","format":"date","description":"Agent-friendly alias for rdlto."},"complexity":{"enum":["low","medium","high"],"type":"string","description":"Estimated complexity label."},"noticeType":{"type":"string","description":"Opportunity type label, such as Solicitation, Sources Sought, or Award Notice."},"postedFrom":{"type":"string","x-sam-gov":{"name":"postedFrom","required":true},"description":"Posted date from. SAM.gov format is MM/dd/yyyy; date range between postedFrom and postedTo is limited to one year. Original SAM.gov parameter: postedFrom."},"postedAfter":{"type":"string","format":"date","description":"Agent-friendly alias for postedFrom."},"postedBefore":{"type":"string","format":"date","description":"Agent-friendly alias for postedTo."},"typeOfSetAside":{"enum":["SBA","SBP","8A","8AN","HZC","HZS","SDVOSBC","SDVOSBS","WOSB","WOSBSS","EDWOSB","EDWOSBSS","LAS","IEE","ISBEE","BICiv","VSA","VSS"],"type":"string","x-sam-gov":{"name":"typeOfSetAside","required":false},"description":"Set-aside code. Only one set-aside value is accepted by SAM.gov. Original SAM.gov parameter: typeOfSetAside."},"organizationCode":{"type":"string","x-sam-gov":{"name":"organizationCode","required":false},"description":"Code of associated organization. Original SAM.gov parameter: organizationCode."},"organizationName":{"type":"string","x-sam-gov":{"name":"organizationName","required":false},"description":"Name of associated organization. Can filter by Department Name or Subtier Name. Original SAM.gov parameter: organizationName."},"typeOfSetAsideDescription":{"type":"string","x-sam-gov":{"name":"typeOfSetAsideDescription","required":false},"description":"Set-aside code description. Original SAM.gov parameter: typeOfSetAsideDescription."}},"additionalProperties":false}},"additionalProperties":false}}},"responseSchema":null,"example":{"request":{"type":"http","method":"GET","queryParams":{"q":"information technology services","limit":25,"naics":"541512","state":"VA","active":true,"postedTo":"12/31/2024","postedFrom":"01/01/2024"}},"response":{"limit":20,"query":{"type":"http","method":"GET","queryParams":"{\"q\":\"information technology services\",\"state\":\"VA\",\"naics\":\"541512\",\"limit\":25,\"postedFrom\":\"01/01/2024\",\"postedTo\":\"12/31/2024\",\"active\":true}"},"total":4,"offset":0,"database":{"path":"./data/gov-contracts.sqlite","total":4,"active":4,"latestIngest":"2026-05-10T19:26:02.823Z","latestUpdate":"2026-05-10T19:25:56.221Z","lastIngestionRun":{"id":3,"error":null,"source":"sam.gov-api","status":"ok","startedAt":"2026-05-10T19:26:02.597Z","finishedAt":"2026-05-10T19:26:02.825Z","parameters":{"mode":"active","limit":1,"status":"active","maxPages":1,"postedTo":"05/10/2026","postedFrom":"05/08/2026","fetchDescriptions":false},"recordsSeen":1,"changeEvents":0,"recordsUpdated":0,"recordsInserted":0,"recordsUpserted":0,"recordsUnchanged":1}},"opportunities":[{"links":{"sam":"https://sam.gov/workspace/contract/opp/ffeebfd5c9ca44e0b66da925b10dd944/view","resources":[],"description":"https://api.sam.gov/prod/opportunities/v1/noticedesc?noticeid=ffeebfd5c9ca44e0b66da925b10dd944"},"title":"53--BOOT,DUST AND MOIST","active":true,"agency":"DEPT OF DEFENSE.DEFENSE LOGISTICS AGENCY.DLA LAND.DLA LAND COLUMBUS.DLA LAND AND MARITIME","office":"","source":"sam.gov-api","noticeId":"ffeebfd5c9ca44e0b66da925b10dd944","setAside":"","naicsCode":"326299","updatedAt":"2026-05-10T19:25:56.221Z","complexity":{"label":"low","score":35},"department":"","noticeType":"Combined Synopsis/Solicitation","postedDate":"2026-05-10","setAsideCode":"","responseDeadline":"2026-05-26","classificationCode":"53","placeOfPerformance":null,"solicitationNumber":"SPE7LX26U7296"},{"links":{"sam":"https://sam.gov/opportunities","resources":["https://sam.gov/sample/hazmat-sow.pdf","https://sam.gov/sample/hazmat-pricing.xlsx"],"description":""},"title":"Hazardous Waste Pickup and Disposal Support","active":true,"agency":"SAMPLE DEVELOPMENT DATA / NOT AN OFFICIAL SAM.GOV NOTICE / Sample Office","office":"Sample Office","source":"sample-development-data","noticeId":"sample-hazmat-002","setAside":"","naicsCode":"562112","updatedAt":"2026-05-10T00:44:13.719Z","complexity":{"label":"medium","score":68},"department":"SAMPLE DEVELOPMENT DATA","noticeType":"Combined Synopsis/Solicitation","postedDate":"2026-05-02","setAsideCode":"","responseDeadline":"2026-05-28","classificationCode":"F108","placeOfPerformance":{"city":{"name":"Baltimore"},"state":{"code":"MD"},"country":{"code":"USA"}},"solicitationNumber":"SAMPLE-26-R-0002"},{"links":{"sam":"https://sam.gov/opportunities","resources":[],"description":""},"title":"Catering and Boxed Meal Support for Training Event","active":true,"agency":"SAMPLE DEVELOPMENT DATA / NOT AN OFFICIAL SAM.GOV NOTICE / Sample Office","office":"Sample Office","source":"sample-development-data","noticeId":"sample-catering-003","setAside":"","naicsCode":"722320","updatedAt":"2026-05-10T00:44:13.720Z","complexity":{"label":"low","score":15},"department":"SAMPLE DEVELOPMENT DATA","noticeType":"Sources Sought","postedDate":"2026-05-03","setAsideCode":"","responseDeadline":"2026-06-05","classificationCode":"S203","placeOfPerformance":{"city":{"name":"Fort Worth"},"state":{"code":"TX"},"country":{"code":"USA"}},"solicitationNumber":"SAMPLE-26-Q-0003"},{"links":{"sam":"https://sam.gov/opportunities","resources":["https://sam.gov/sample/grounds-package.pdf","https://sam.gov/sample/grounds-amendment.pdf"],"description":""},"title":"Grounds Maintenance Services for Federal Field Office","active":true,"agency":"SAMPLE DEVELOPMENT DATA / NOT AN OFFICIAL SAM.GOV NOTICE / Sample Office","office":"Sample Office","source":"diff-smoke","noticeId":"sample-grounds-001","setAside":"Total Small Business Set-Aside (FAR 19.5)","naicsCode":"561730","updatedAt":"2026-05-10T19:19:52.336Z","complexity":{"label":"medium","score":48},"department":"SAMPLE DEVELOPMENT DATA","noticeType":"Solicitation","postedDate":"2026-05-01","setAsideCode":"SBA","responseDeadline":"2026-06-20","classificationCode":"S208","placeOfPerformance":{"city":{"name":"Richmond"},"state":{"code":"VA"},"country":{"code":"USA"}},"solicitationNumber":"SAMPLE-26-Q-0001"}],"samGovParameterMap":{"zip":{"type":"string","description":"Place of performance ZIP code.","requiredBySamGov":false},"ccode":{"type":"string","description":"Classification code / PSC.","requiredBySamGov":false},"limit":{"type":"integer","description":"Records per page. SAM.gov maximum is 1000 and default is 1; Gov Contract Scout public search caps at 100.","requiredBySamGov":false},"ncode":{"type":"string","description":"NAICS code. SAM.gov documents a maximum of 6 digits.","requiredBySamGov":false},"ptype":{"enum":["u","p","a","r","s","o","g","k","i"],"type":"string","description":"Procurement type code. May be repeated by SAM.gov; Gov Contract Scout also accepts comma-separated values.","requiredBySamGov":false},"rdlto":{"type":"string","description":"Response deadline to. SAM.gov format is MM/dd/yyyy; rdlfrom/rdlto date range is limited to one year.","requiredBySamGov":false},"state":{"type":"string","description":"Place of performance state.","requiredBySamGov":false},"title":{"type":"string","description":"Opportunity title search.","requiredBySamGov":false},"offset":{"type":"integer","description":"Page index. SAM.gov default starts with 0.","requiredBySamGov":false},"solnum":{"type":"string","description":"Solicitation number.","requiredBySamGov":false},"status":{"enum":["active","inactive","archived","cancelled","deleted"],"type":"string","description":"Opportunity status. SAM.gov notes this as coming soon; documented values are active, inactive, archived, cancelled, and deleted.","requiredBySamGov":false},"api_key":{"type":"string","description":"Public API key required by SAM.gov upstream. Buyers do not send this to Gov Contract Scout.","requiredBySamGov":true},"rdlfrom":{"type":"string","description":"Response deadline from. SAM.gov format is MM/dd/yyyy; rdlfrom/rdlto date range is limited to one year.","requiredBySamGov":false},"subtier":{"type":"string","description":"Agency Name (L2). Deprecated by SAM.gov.","requiredBySamGov":false},"deptname":{"type":"string","description":"Department Name (L1). Deprecated by SAM.gov.","requiredBySamGov":false},"noticeid":{"type":"string","description":"SAM.gov notice ID.","requiredBySamGov":false},"postedTo":{"type":"string","description":"Posted date to. SAM.gov format is MM/dd/yyyy; date range between postedFrom and postedTo is limited to one year.","requiredBySamGov":true},"postedFrom":{"type":"string","description":"Posted date from. SAM.gov format is MM/dd/yyyy; date range between postedFrom and postedTo is limited to one year.","requiredBySamGov":true},"typeOfSetAside":{"enum":["SBA","SBP","8A","8AN","HZC","HZS","SDVOSBC","SDVOSBS","WOSB","WOSBSS","EDWOSB","EDWOSBSS","LAS","IEE","ISBEE","BICiv","VSA","VSS"],"type":"string","description":"Set-aside code. Only one set-aside value is accepted by SAM.gov.","requiredBySamGov":false},"organizationCode":{"type":"string","description":"Code of associated organization.","requiredBySamGov":false},"organizationName":{"type":"string","description":"Name of associated organization. Can filter by Department Name or Subtier Name.","requiredBySamGov":false},"typeOfSetAsideDescription":{"type":"string","description":"Set-aside code description.","requiredBySamGov":false}}}},"exampleRequest":{"type":"http","method":"GET","queryParams":{"q":"information technology services","limit":25,"naics":"541512","state":"VA","active":true,"postedTo":"12/31/2024","postedFrom":"01/01/2024"}},"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_52h7vH49ar17F4-qYL7no","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search and filter normalized U.S. federal contract opportunities from SAM.gov using full-text queries and structured parameters like NAICS code, PSC, state, deadline, and procurement type.","exampleAgentPrompt":"Search SAM.gov for open IT services contract opportunities in Virginia with NAICS code 541512, show me up to 25 results with response deadlines after today.","exampleUseCases":null,"resultDescription":"A list of normalized federal contract opportunity records from SAM.gov, including solicitation numbers, titles, organization names, NAICS/PSC codes, procurement types, place of performance details, response deadlines, and other structured metadata — up to the requested limit (max 100 via this service).","failureModes":["Invalid or unsupported NAICS/PSC code returns empty results","Date format errors if deadline parameters are not in MM/dd/yyyy format","limit exceeding 100 returns an error or is capped","Missing required query parameters may return broad or unexpected results","SAM.gov upstream unavailability causes service errors","Payment of 0.002 USDC not fulfilled results in 402 rejection"],"whenToPreferThis":"Use this endpoint when an agent needs to search U.S. federal contract opportunities from SAM.gov with structured filters (NAICS, PSC, state, deadline) or full-text queries. It is preferable to raw SAM.gov API calls because it normalizes data, supports agent-friendly aliases (e.g. 'naics' instead of 'ncode'), and is accessible via micro-payment without requiring a SAM.gov API key.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:33:05.859Z","isFirstParty":false}