BidCatch

Search government bid opportunities (open and past) by keyword, state, and buyer level. Results are relevance-ranked; keyword matches in the title outrank passing mentions in the description.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "Keywords, e.g. 'fiber optic' or 'cyber'"
    },
    "state": {
      "description": "Two-letter US state code, e.g. TX",
      "type": "string",
      "minLength": 2,
      "maxLength": 2,
      "pattern": "^[A-Za-z]{2}$"
    },
    "tier": {
      "description": "Level of government buyer",
      "type": "string",
      "enum": [
        "federal",
        "state",
        "local"
      ]
    },
    "open_only": {
      "default": true,
      "description": "true = only bids whose deadline has not passed",
      "type": "boolean"
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Search federal contract award history — who won what, for how much, and when. Use it to size up incumbents, price work, or find buyers. Requires a BidCatch intel key.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "Keywords matched against description, recipient, and agency"
    },
    "state": {
      "description": "Two-letter US state code, e.g. TX",
      "type": "string",
      "minLength": 2,
      "maxLength": 2,
      "pattern": "^[A-Za-z]{2}$"
    },
    "sort": {
      "default": "recent",
      "type": "string",
      "enum": [
        "recent",
        "amount"
      ]
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List federal contracts nearing expiration — each one a competition about to reopen. Filter by keyword, NAICS code, or state. Requires a BidCatch intel key.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Keywords matched against description, recipient, and agency",
      "type": "string",
      "maxLength": 120
    },
    "naics": {
      "description": "NAICS industry code, e.g. 541512",
      "type": "string",
      "pattern": "^\\d{2,6}$"
    },
    "state": {
      "description": "Two-letter US state code, e.g. TX",
      "type": "string",
      "minLength": 2,
      "maxLength": 2,
      "pattern": "^[A-Za-z]{2}$"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List an agency's published procurement forecast — planned contract actions with estimated values and timelines, in the agency's own words. Planning-grade data; entries can be revised or cancelled. Requires a BidCatch intel key.

{
  "type": "object",
  "properties": {
    "agency": {
      "type": "string",
      "minLength": 2,
      "maxLength": 120,
      "description": "Agency name or distinctive fragment, e.g. 'Interior' or 'Veterans'"
    }
  },
  "required": [
    "agency"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Search Government Accountability Office (GAO) bid protest decisions — who challenged an award, and whether the referee sustained or denied it. Requires a BidCatch intel key.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "Keywords matched against agency and case matter"
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Check SAM.gov's exclusion (debarment) list for a company or person — entities the government has barred from receiving federal contracts or subcontracts. Run this before teaming with or subcontracting to anyone: one excluded partner can poison a bid. Match by exact company name or UEI; a state filter disambiguates common names. Records come from SAM.gov's published exclusions extract, refreshed weekly.

{
  "type": "object",
  "properties": {
    "name": {
      "description": "Company or person name, e.g. 'Acme Paving LLC'",
      "type": "string",
      "minLength": 2,
      "maxLength": 200
    },
    "uei": {
      "description": "SAM.gov Unique Entity ID — the strongest match key",
      "type": "string",
      "minLength": 4,
      "maxLength": 32
    },
    "state": {
      "description": "Two-letter US state code, e.g. TX",
      "type": "string",
      "minLength": 2,
      "maxLength": 2,
      "pattern": "^[A-Za-z]{2}$"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Find who a company teams with on federal contracts — the primes it subcontracts for and the subcontractors under it. Built from prime-reported subcontract records (USAspending/FSRS): real reported relationships, not guesses. Use it before a recompete to map an incumbent's bench, or to find primes a subcontractor already works with. Requires a BidCatch intel key.

{
  "type": "object",
  "properties": {
    "company": {
      "description": "Company name, e.g. 'Booz Allen Hamilton' — resolved to the strongest match",
      "type": "string",
      "minLength": 2,
      "maxLength": 200
    },
    "uei": {
      "description": "SAM.gov Unique Entity ID — the strongest match key",
      "type": "string",
      "minLength": 4,
      "maxLength": 32
    },
    "role": {
      "description": "prime = only partners they sub FOR; sub = only subs UNDER them; omit for both",
      "type": "string",
      "enum": [
        "prime",
        "sub"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Filter federal contract awards by exact fields — recipient, awarding agency, NAICS code, state — instead of keyword search. Includes a single-bid filter for awards that drew exactly one offer. Use this when you know the slice you want; use get_award_history for topic/keyword search. Requires a BidCatch intel key.

{
  "type": "object",
  "properties": {
    "recipient": {
      "description": "Recipient name (partial match), e.g. 'Lockheed'",
      "type": "string",
      "minLength": 2,
      "maxLength": 200
    },
    "agency": {
      "description": "Awarding agency (partial match), e.g. 'Veterans Affairs'",
      "type": "string",
      "minLength": 2,
      "maxLength": 200
    },
    "naics": {
      "description": "NAICS code, e.g. 541512",
      "type": "string",
      "pattern": "^\\d{2,6}$"
    },
    "state": {
      "description": "Two-letter US state code, e.g. TX",
      "type": "string",
      "minLength": 2,
      "maxLength": 2,
      "pattern": "^[A-Za-z]{2}$"
    },
    "one_bid_only": {
      "default": false,
      "description": "true = only awards that received exactly one offer",
      "type": "boolean"
    },
    "sort": {
      "default": "recent",
      "type": "string",
      "enum": [
        "recent",
        "amount"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}