Ambolt SAM.gov API

openapi: 3.2.0
info:
  title: Ambolt data tools SAM.gov API
  version: 0.1.1
  description: Pay-per-call data endpoints using the x402 protocol (USDC on Base, Polygon and Solana). Failed calls are not charged.
  x-guidance: 'Call GET /v1/<tool> with the documented query parameters. Without payment the response is 402 with the price and payment requirements; an x402 client pays in USDC and retries. Add free=1 for one free call per tool and IP per day. Company, tender, document, rates, on-chain and web tools; every response carries source and date. The same tools are available as MCP tools at /mcp (free, 30 requests a minute) and as Apify Actors. Company-level data only: no personal data.'
  contact:
    email: hello@ambolt.dev
    url: https://ambolt.dev
servers:
- url: https://api.ambolt.dev
security: []
tags:
- name: SAM.gov
paths:
  /v1/sam-gov-opportunities:
    get:
      operationId: sam_gov_opportunities
      summary: 'SAM.gov Opportunities Search: US Federal Contract Notices'
      description: 'Search US federal contract opportunities and awards from the public SAM.gov daily extract: solicitations, award notices and other notice types with agency, office, NAICS and PSC codes, set-aside, response deadline, place of performance, award number, amount and awardee company, and the notice link. Newest first, no API key and no daily request limit. Contact persons, e-mail addresses, phone numbers and free-text descriptions are not returned.'
      tags:
      - SAM.gov
      parameters:
      - name: since
        in: query
        required: false
        schema:
          type: string
          pattern: ^\d{4}-\d{2}-\d{2}$
          description: 'Only notices posted on or after this date (YYYY-MM-DD). Default: 7 days ago. Use the date of your last run for new notices only.'
        description: 'Only notices posted on or after this date (YYYY-MM-DD). Default: 7 days ago. Use the date of your last run for new notices only.'
      - name: until
        in: query
        required: false
        schema:
          type: string
          pattern: ^\d{4}-\d{2}-\d{2}$
          description: Only notices posted on or before this date.
        description: Only notices posted on or before this date.
      - name: naics
        in: query
        required: false
        schema:
          type: array
          maxItems: 10
          items:
            type: string
            pattern: ^\d{2,6}$
          description: NAICS codes or prefixes (for example 5415 for computer systems design).
        description: NAICS codes or prefixes (for example 5415 for computer systems design).
      - name: psc
        in: query
        required: false
        schema:
          type: array
          maxItems: 10
          items:
            type: string
            maxLength: 4
          description: Product and service codes or prefixes (for example D3 or R4).
        description: Product and service codes or prefixes (for example D3 or R4).
      - name: setAside
        in: query
        required: false
        schema:
          type: array
          maxItems: 10
          items:
            type: string
            maxLength: 12
          description: Set-aside codes (for example SBA, 8A, HZC, SDVOSBC, WOSB).
        description: Set-aside codes (for example SBA, 8A, HZC, SDVOSBC, WOSB).
      - name: states
        in: query
        required: false
        schema:
          type: array
          maxItems: 20
          items:
            type: string
            pattern: ^[A-Za-z]{2}$
          description: Place-of-performance state codes (for example VA, TX).
        description: Place-of-performance state codes (for example VA, TX).
      - name: types
        in: query
        required: false
        schema:
          type: array
          maxItems: 8
          items:
            type: string
            maxLength: 40
          description: Notice types (for example Solicitation, Combined Synopsis/Solicitation, Award Notice, Sources Sought, Special Notice, Presolicitation).
        description: Notice types (for example Solicitation, Combined Synopsis/Solicitation, Award Notice, Sources Sought, Special Notice, Presolicitation).
      - name: keyword
        in: query
        required: false
        schema:
          type: string
          maxLength: 80
          pattern: ^[\p{L}\p{N} ./&'-]+$
          description: Words that must appear in the title.
        description: Words that must appear in the title.
      - name: activeOnly
        in: query
        required: false
        schema:
          type: boolean
          default: true
          description: Only notices that are still active (default). Set false to include archived notices and awards.
        description: Only notices that are still active (default). Set false to include archived notices and awards.
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 500
          default: 25
          description: Maximum notices returned, newest first. Each returned notice is one billable result.
        description: Maximum notices returned, newest first. Each returned notice is one billable result.
      - name: free
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
        description: Set to 1 for one free call per tool and IP address per day (no payment).
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.050000'
        protocols:
        - x402: {}
      responses:
        '200':
          description: Result (JSON). Every result names its source and the time it was read.
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Invalid input; not charged.
        '402':
          description: 'Payment required: 0.05 USD in USDC (x402 v2).'