# Gov Contract Scout – SAM.gov Opportunity Search

> Gov Contract Scout – SAM.gov Opportunity Search is a paid API for AI agents from agentic-gov-contracts.vercel.app, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-15).

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.

## Facts

- Endpoint: GET https://agentic-gov-contracts.vercel.app/api/opportunities/search
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentic-gov-contracts-vercel-app-ef60c727
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cZVzbDYoOnDgMgpp6ajQY

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agentic-gov-contracts-vercel-app-ef60c727
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Search normalized SAM.gov contract opportunities with full-text and structured filters. Supports SAM.gov-compatible aliases where useful.

## Output

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).

## Example request

```json
{
 "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"
 }
}
```

## Request schema (JSON Schema)

```json
{
 "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; 
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentic-gov-contracts-vercel-app-ef60c727/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentic-gov-contracts.vercel.app](https://www.zero.xyz/host/agentic-gov-contracts.vercel.app/llms.txt)