---
type: "firecrawl-provider"
description: "COMMBUYS (www.commbuys.com), the Commonwealth of Massachusetts' public procurement portal on Periscope BuySpeed Online: keyword and filtered bid solicitation search (organization, buyer, NIGP class, type, status, UNSPSC category, opening-date window) with the site's fixed 25-row pagination, the current Open Bids list, full bid solicitation detail pages with header fields, addresses, stateless attachment download URLs and UNSPSC line items, and master blanket / purchase order summaries. Anonymous public access only; quotes, bidding, bid holder lists and account actions are not covered."
use_when: "COMMBUYS (www.commbuys.com), the Commonwealth of Massachusetts' public procurement portal on Periscope BuySpeed Online: keyword and filtered bid solicitation search (organization, buyer, NIGP class, type, status, UNSPSC category, opening-date window) with the site's fixed 25-row pagination, the current Open Bids list, full bid solicitation detail pages with header fields, addresses, stateless attachment download URLs and UNSPSC line items, and master blanket / purchase order summaries. Anonymous public access only; quotes, bidding, bid holder lists and account actions are not covered."
categories: "Public records"
capabilities: 4
credits_per_call: 5
---
# COMMBUYS on Firecrawl Alexandria

COMMBUYS (www.commbuys.com), the Commonwealth of Massachusetts' public procurement portal on Periscope BuySpeed Online: keyword and filtered bid solicitation search (organization, buyer, NIGP class, type, status, UNSPSC category, opening-date window) with the site's fixed 25-row pagination, the current Open Bids list, full bid solicitation detail pages with header fields, addresses, stateless attachment download URLs and UNSPSC line items, and master blanket / purchase order summaries. Anonymous public access only; quotes, bidding, bid holder lists and account actions are not covered.

- Categories: Public records
- Category index: [Public records category](https://firecrawl.dev/alexandria/agents/categories/public-records)
- Provider key: `commbuys-com`
- Access: Firecrawl credits
- Cost: 5 credits per call

## More

- [Human guide](https://firecrawl.dev/app/alexandria/commbuys-com)
- [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/commbuys-com/openapi.json)

## Capabilities

- [Get bid](https://firecrawl.dev/alexandria/agents/providers/commbuys-com/public-tenders/get_bid): Fetch one COMMBUYS bid solicitation detail page (bidDetail.sda) by bid number or pasted URL: header fields (description, opening date, purchaser, organization, department, location, fiscal year, type code, bid type, purchase method, pre-bid conference, bulletin text), ship-to and bill-to addresses, the invitation-only and SBPP flags, public file attachments with stateless download URLs, form attachments, required quote attachments and the line items with UNSPSC codes, quantities, unit costs and units of measure. Values are the displayed strings; blanks are null, never zero.
- [Get blanket](https://firecrawl.dev/alexandria/agents/providers/commbuys-com/public-tenders/get_blanket): Fetch one COMMBUYS master blanket or purchase order summary page (poSummary.sda) by PO number (and release number, 0 for the master) or pasted URL: header fields (short description, status, purchaser, fiscal year, PO type, organization, department, location, alternate id, entered date), master blanket begin and end dates, cooperative purchasing flag, payment and shipping terms, actual cost, the vendor (id, name, address, profile URL), agency and vendor attachments with stateless download URLs, and the line items. Values are the displayed strings; blanks are null.
- [List open bids](https://firecrawl.dev/alexandria/agents/providers/commbuys-com/public-tenders/list_open_bids): List the solicitations COMMBUYS currently shows under Open Bids (the public `openBids=true` view, server-rendered for the first 25 rows and paginated through the site's datatable for later pages). Rows have the same shape as search_bids.
- [Search bids](https://firecrawl.dev/alexandria/agents/providers/commbuys-com/public-tenders/search_bids): Search COMMBUYS bid solicitations through the public Advanced Search form (a JSF session is opened, the search POSTed and, for offsets past the first page, the results datatable paginated), 25 rows a page. Dropdown filters (organization, buyer, NIGP class, category) accept the site's code or the name as listed and are resolved against the form's option lists before the search. Each row carries the bid solicitation number, organization, blanket number, buyer, description, bid opening date as displayed (Massachusetts time, no zone shown) with an ISO wall-clock conversion, awarded vendors, status, alternate id and the detail URL.

## 1. Choose this provider when

COMMBUYS (www.commbuys.com), the Commonwealth of Massachusetts' public procurement portal on Periscope BuySpeed Online: keyword and filtered bid solicitation search (organization, buyer, NIGP class, type, status, UNSPSC category, opening-date window) with the site's fixed 25-row pagination, the current Open Bids list, full bid solicitation detail pages with header fields, addresses, stateless attachment download URLs and UNSPSC line items, and master blanket / purchase order summaries. Anonymous public access only; quotes, bidding, bid holder lists and account actions are not covered.

## 2. Minimal request

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.

```json
{
  "provider": "commbuys-com",
  "capability": "public-tenders/get_bid",
  "options": {
    "bid_number": "BD-27-1060-ITD00-ITD00-133949"
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `bid_number` (string): Bid solicitation number (the site's docId), e.g. `BD-27-1060-ITD00-ITD00-133949`. Pattern: ^[A-Za-z0-9]+(-[A-Za-z0-9]+)+$. Example: `BD-27-1060-ITD00-ITD00-133949`
- `url` (string): A pasted bidDetail.sda URL carrying `docId=`; used when `bid_number` is absent. Example: `docId=`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "commbuys-com",
    capability: "public-tenders/get_bid",
    options: {
      bid_number: "BD-27-1060-ITD00-ITD00-133949",
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "commbuys-com",
  "capability": "public-tenders/get_bid",
  "options": {
    "bid_number": "BD-27-1060-ITD00-ITD00-133949"
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "commbuys-com",
    "capability": "public-tenders/get_bid",
    "options": {
      "bid_number": "BD-27-1060-ITD00-ITD00-133949"
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'commbuys-com/public-tenders/get_bid' \
  --options '{"bid_number":"BD-27-1060-ITD00-ITD00-133949"}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "commbuys-com",
  "capability": "public-tenders/get_bid",
  "options": {
    "bid_number": "BD-27-1060-ITD00-ITD00-133949"
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "commbuys-com",
  "capability": "public-tenders/get_bid",
  "options": {
    "bid_number": "BD-27-1060-ITD00-ITD00-133949"
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "allow_electronic_quote": true,
  "alternate_id": "PCR-27-05699",
  "bid_number": "BD-27-1060-ITD00-ITD00-133949",
  "bid_opening_date_local": "2026-10-20T15:00:00",
  "bid_opening_date_text": "10/20/2026 03:00:00 PM",
  "bid_type": "CLOSED",
  "bill_to_address": "Attention: EOTSS Accounts Payable\nOne Ashburton Place Room 804\nBoston, MA 02108\nUS\nEmail: itdinvoices@mass.gov\nPhone: (617) 626-5626\nAlt. Reference: Tiffany.Chen3@mass.gov",
  "bulletin_description": null,
  "department": "ITD0001 - Executive Office of Technology Services and Security",
  "description": "RFQ-27-05699 Accela Software Solution and Support",
  "file_attachments": [
    {
      "download_url": "https://www.commbuys.com/bso/external/bidDetail.sda?docId=BD-27-1060-ITD00-ITD00-133949&mode=download&downloadFileNbr=2270533&external=true&parentUrl=close",
      "file_name": "RFQ-27-05699 Accela Software Solution and Support~1.docx",
      "file_number": "2270533"
    }
  ],
  "fiscal_year": "27",
  "form_attachments": [],
  "info_contact": "Contact Nelson Wong at (617) 626-4553",
  "informal_bid": true,
  "invitation_only": true,
  "items": [
    {
      "description": "The purpose of this RFQ is to solicit quotes for Accela Software Solution and Support. See attached RFQ document for complete detail. This RFQ is restricted to vendors on the Statewide Contracts ITS81and ITS86 Category 1.",
      "item_number": 1,
      "quantity": 1,
      "total_cost": null,
      "total_discount_amount": null,
      "unit_cost": null,
      "unit_of_measure": "EA - Each",
      "unspsc_code": "43-23-00-00-0000",
      "unspsc_codes": [
        "43-23-00",
        "43-23-00-00",
        "43-23-00-00-0000"
      ],
      "unspsc_description": "Software"
    }
  ],
  "location": "ITD00 - TSS General",
  "observed_at_ms": 1791237543385,
  "organization": "Executive Office of Technology Services and Security",
  "pre_bid_conference": null,
  "print_format": null,
  "purchase_method": "Open Market",
  "purchaser": "Nelson Wong",
  "required_date": null,
  "required_quote_attachments": [],
  "sbpp_eligible": false,
  "ship_to_address": "1 No Address See Item Section for specific information\nVendors need to check the Items section\nof the PO for ship to information\nBoston, MA 02108\nUS\nEmail: seeitemsssection@xxx.com\nPhone: (617) 626-4400",
  "source_url": "https://www.commbuys.com/bso/external/bidDetail.sda?docId=BD-27-1060-ITD00-ITD00-133949&external=true&parentUrl=close",
  "time_zone": "America/New_York",
  "type_code": null
}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### Get bid

- Capability: `public-tenders/get_bid`
- Description: Fetch one COMMBUYS bid solicitation detail page (bidDetail.sda) by bid number or pasted URL: header fields (description, opening date, purchaser, organization, department, location, fiscal year, type code, bid type, purchase method, pre-bid conference, bulletin text), ship-to and bill-to addresses, the invitation-only and SBPP flags, public file attachments with stateless download URLs, form attachments, required quote attachments and the line items with UNSPSC codes, quantities, unit costs and units of measure. Values are the displayed strings; blanks are null, never zero.
- Instructions: After search_bids or list_open_bids, to read a solicitation in full or to get its attachment download URLs. An unknown bid number is `not_found`; supplier-only pages (bid holder list, quotes) are not fetched.
- Cost: 5 credits per call
- Capability file: [Get bid](https://firecrawl.dev/alexandria/agents/providers/commbuys-com/public-tenders/get_bid)

Accepted options:
- `bid_number` (string): Bid solicitation number (the site's docId), e.g. `BD-27-1060-ITD00-ITD00-133949`. Pattern: ^[A-Za-z0-9]+(-[A-Za-z0-9]+)+$. Example: `BD-27-1060-ITD00-ITD00-133949`
- `url` (string): A pasted bidDetail.sda URL carrying `docId=`; used when `bid_number` is absent. Example: `docId=`

Response schema example:
```json
{
  "allow_electronic_quote": true,
  "alternate_id": "PCR-27-05699",
  "bid_number": "BD-27-1060-ITD00-ITD00-133949",
  "bid_opening_date_local": "2026-10-20T15:00:00",
  "bid_opening_date_text": "10/20/2026 03:00:00 PM",
  "bid_type": "CLOSED",
  "bill_to_address": "Attention: EOTSS Accounts Payable\nOne Ashburton Place Room 804\nBoston, MA 02108\nUS\nEmail: itdinvoices@mass.gov\nPhone: (617) 626-5626\nAlt. Reference: Tiffany.Chen3@mass.gov",
  "bulletin_description": null,
  "department": "ITD0001 - Executive Office of Technology Services and Security",
  "description": "RFQ-27-05699 Accela Software Solution and Support",
  "file_attachments": [
    {
      "download_url": "https://www.commbuys.com/bso/external/bidDetail.sda?docId=BD-27-1060-ITD00-ITD00-133949&mode=download&downloadFileNbr=2270533&external=true&parentUrl=close",
      "file_name": "RFQ-27-05699 Accela Software Solution and Support~1.docx",
      "file_number": "2270533"
    }
  ],
  "fiscal_year": "27",
  "form_attachments": [],
  "info_contact": "Contact Nelson Wong at (617) 626-4553",
  "informal_bid": true,
  "invitation_only": true,
  "items": [
    {
      "description": "The purpose of this RFQ is to solicit quotes for Accela Software Solution and Support. See attached RFQ document for complete detail. This RFQ is restricted to vendors on the Statewide Contracts ITS81and ITS86 Category 1.",
      "item_number": 1,
      "quantity": 1,
      "total_cost": null,
      "total_discount_amount": null,
      "unit_cost": null,
      "unit_of_measure": "EA - Each",
      "unspsc_code": "43-23-00-00-0000",
      "unspsc_codes": [
        "43-23-00",
        "43-23-00-00",
        "43-23-00-00-0000"
      ],
      "unspsc_description": "Software"
    }
  ],
  "location": "ITD00 - TSS General",
  "observed_at_ms": 1791237543385,
  "organization": "Executive Office of Technology Services and Security",
  "pre_bid_conference": null,
  "print_format": null,
  "purchase_method": "Open Market",
  "purchaser": "Nelson Wong",
  "required_date": null,
  "required_quote_attachments": [],
  "sbpp_eligible": false,
  "ship_to_address": "1 No Address See Item Section for specific information\nVendors need to check the Items section\nof the PO for ship to information\nBoston, MA 02108\nUS\nEmail: seeitemsssection@xxx.com\nPhone: (617) 626-4400",
  "source_url": "https://www.commbuys.com/bso/external/bidDetail.sda?docId=BD-27-1060-ITD00-ITD00-133949&external=true&parentUrl=close",
  "time_zone": "America/New_York",
  "type_code": null
}
```

### Get blanket

- Capability: `public-tenders/get_blanket`
- Description: Fetch one COMMBUYS master blanket or purchase order summary page (poSummary.sda) by PO number (and release number, 0 for the master) or pasted URL: header fields (short description, status, purchaser, fiscal year, PO type, organization, department, location, alternate id, entered date), master blanket begin and end dates, cooperative purchasing flag, payment and shipping terms, actual cost, the vendor (id, name, address, profile URL), agency and vendor attachments with stateless download URLs, and the line items. Values are the displayed strings; blanks are null.
- Instructions: After search_bids returns a `blanket_number`, or with a statewide contract number such as `C14597-vCurrent`, to read the awarded contract's summary and attachment URLs. An unknown PO number is `not_found`.
- Cost: 5 credits per call
- Capability file: [Get blanket](https://firecrawl.dev/alexandria/agents/providers/commbuys-com/public-tenders/get_blanket)

Accepted options:
- `po_number` (string): Purchase order / master blanket number (the site's docId), e.g. `C14597-vCurrent` or `PO-21-1080-OSD03-SRC04-21090`. Pattern: ^[A-Za-z0-9]+(-[A-Za-z0-9]+)+$. Example: `C14597-vCurrent`
- `release_number` (string): Release number (`releaseNbr`); 0 is the master blanket. Defaults to the URL's value, else 0. Pattern: ^[0-9]{1,6}$. Example: `0`
- `url` (string): A pasted poSummary.sda URL carrying `docId=` (and optionally `releaseNbr=`); used when `po_number` is absent. Example: `docId=`

Response schema example:
```json
{
  "actual_cost": "$0.00",
  "agency_attachments": [
    {
      "download_url": "https://www.commbuys.com/bso/external/purchaseorder/poSummary.sda?docId=C14597-vCurrent&releaseNbr=0&mode=download&downloadFileNbr=928359&external=true&parentUrl=close",
      "file_name": "0145970001",
      "file_number": "928359"
    },
    {
      "download_url": "https://www.commbuys.com/bso/external/purchaseorder/poSummary.sda?docId=C14597-vCurrent&releaseNbr=0&mode=download&downloadFileNbr=928360&external=true&parentUrl=close",
      "file_name": "0145970002",
      "file_number": "928360"
    },
    {
      "download_url": "https://www.commbuys.com/bso/external/purchaseorder/poSummary.sda?docId=C14597-vCurrent&releaseNbr=0&mode=download&downloadFileNbr=928361&external=true&parentUrl=close",
      "file_name": "0145970003",
      "file_number": "928361"
    },
    {
      "download_url": "https://www.commbuys.com/bso/external/purchaseorder/poSummary.sda?docId=C14597-vCurrent&releaseNbr=0&mode=download&downloadFileNbr=928362&external=true&parentUrl=close",
      "file_name": "0145970004",
      "file_number": "928362"
    },
    {
      "download_url": "https://www.commbuys.com/bso/external/purchaseorder/poSummary.sda?docId=C14597-vCurrent&releaseNbr=0&mode=download&downloadFileNbr=928363&external=true&parentUrl=close",
      "file_name": "0145970005",
      "file_number": "928363"
    },
    {
      "download_url": "https://www.commbuys.com/bso/external/purchaseorder/poSummary.sda?docId=C14597-vCurrent&releaseNbr=0&mode=download&downloadFileNbr=928364&external=true&parentUrl=close",
      "file_name": "0145970006",
      "file_number": "928364"
    },
    {
      "download_url": "https://www.commbuys.com/bso/external/purchaseorder/poSummary.sda?docId=C14597-vCurrent&releaseNbr=0&mode=download&downloadFileNbr=928365&external=true&parentUrl=close",
      "file_name": "0145970007",
      "file_number": "928365"
    },
    {
      "download_url": "https://www.commbuys.com/bso/external/purchaseorder/poSummary.sda?docId=C14597-vCurrent&releaseNbr=0&mode=download&downloadFileNbr=928366&external=true&parentUrl=close",
      "file_name": "0145970008",
      "file_number": "928366"
    },
    {
      "download_url": "https://www.commbuys.com/bso/external/purchaseorder/poSummary.sda?docId=C14597-vCurrent&releaseNbr=0&mode=download&downloadFileNbr=928367&external=true&parentUrl=close",
      "file_name": "ContractInfo_014597",
      "file_number": "928367"
    },
    {
      "download_url": "https://www.commbuys.com/bso/external/purchaseorder/poSummary.sda?docId=C14597-vCurrent&releaseNbr=0&mode=download&downloadFileNbr=928368&external=true&parentUrl=close",
      "file_name": "Summary_014597",
      "file_number": "928368"
    },
    {
      "download_url": "https://www.commbuys.com/bso/external/purchaseorder/poSummary.sda?docId=C14597-vCurrent&releaseNbr=0&mode=download&downloadFileNbr=1033461&external=true&parentUrl=close",
      "file_name": "C14597-vCurrent_OD.xlsx",
      "file_number": "1033461"
    }
  ],
  "alternate_id": null,
  "begin_date": "2003-07-01",
  "begin_date_text": "07/01/2003",
  "contact_instructions": "Eva Beurs, , Address: Dept.of Public Health State Laboratory Institue 305 South Street Jamaica Plain, MA 02130, Phone: (617) 983-6225, Email: eva.beurs@state.ma.us",
  "cooperative_purchasing_allowed": false,
  "days_aro": "0",
  "department": "1031CONVD - Default Data Conversion Department",
  "discount_percent": "0.00%",
  "end_date": "2112-06-30",
  "end_date_text": "06/30/2112",
  "entered_date_local": "2003-02-10T14:05:03",
  "entered_date_text": "02/10/2003 02:05:03 PM",
  "fiscal_year": "2003",
  "freight_terms": null,
  "heading": "Master Blanket Purchase Order C14597-vCurrent",
  "items": [
    {
      "description": null,
      "item_number": 1,
      "quantity": 1,
      "total_cost": "$0.00",
      "total_discount_amount": "$0.00",
      "unit_cost": "$0.00",
      "unit_of_measure": "EA - Each",
      "unspsc_code": null,
      "unspsc_codes": [],
      "unspsc_description": null
    }
  ],
  "location": "1031L - Default Data Conversion Location",
  "minor_status": null,
  "observed_at_ms": 1791237577125,
  "organization": "Department of Public Health",
  "payment_terms": null,
  "po_number": "C14597-vCurrent",
  "po_type": "Blanket",
  "print_format": null,
  "purchaser": "Charles Caron",
  "receipt_method": "Quantity",
  "release_number": "0",
  "release_type": "Standard Release",
  "retainage_percent": "0.00%",
  "shipping_method": null,
  "shipping_terms": null,
  "short_description": "400",
  "source_url": "https://www.commbuys.com/bso/external/purchaseorder/poSummary.sda?docId=C14597-vCurrent&releaseNbr=0&external=true&parentUrl=close",
  "special_instructions": null,
  "status": "3PS - Sent",
  "time_zone": "America/New_York",
  "type_code": "Non-Statewide Contract",
  "vendor": {
    "address": [
      "COMMBUYS Notifications",
      "One Ashburton Place",
      "Room 1017",
      "Boston, MA 02108",
      "US",
      "Email: commbuysnotifications@mass.gov",
      "Phone: (617) 720-3100"
    ],
    "name": "Conversion Vendor",
    "profile_url": "https://www.commbuys.com/bso/external/vendor/vendorProfileOrgInfo.sda?external=true&vendorId=99000000",
    "vendor_id": "99000000"
  },
  "vendor_attachments": []
}
```

### List open bids

- Capability: `public-tenders/list_open_bids`
- Description: List the solicitations COMMBUYS currently shows under Open Bids (the public `openBids=true` view, server-rendered for the first 25 rows and paginated through the site's datatable for later pages). Rows have the same shape as search_bids.
- Instructions: Enumerate everything currently open for responses without choosing a filter; follow `next_cursor` for later pages and pass a row's `bid_number` to get_bid.
- Cost: 5 credits per call
- Capability file: [List open bids](https://firecrawl.dev/alexandria/agents/providers/commbuys-com/public-tenders/list_open_bids)

Accepted options:
- `cursor` (string): Row offset of the page to return (a multiple of 25), from the previous answer's `next_cursor`. Omit for the first page. Pattern: ^[0-9]{1,6}$. Example: `next_cursor`

Response schema example:
```json
{
  "count": 25,
  "next_cursor": "25",
  "observed_at_ms": 1791237561545,
  "offset": 0,
  "page_size": 25,
  "records": [
    {
      "alternate_id": "PCR-27-04987",
      "awarded_vendors": null,
      "bid_number": "BD-27-1060-ITD00-ITD00-134163",
      "bid_opening_date_local": "2026-10-29T15:00:00",
      "bid_opening_date_text": "10/29/2026 3:00 PM",
      "blanket_number": null,
      "buyer": "Nelson Wong",
      "description": "RFQ 27-04987 for M365 Migration Services",
      "detail_url": "https://www.commbuys.com/bso/external/bidDetail.sda?docId=BD-27-1060-ITD00-ITD00-134163&external=true&parentUrl=close",
      "organization_name": "Executive Office of Technology Services and Security",
      "status": "Sent"
    },
    {
      "alternate_id": null,
      "awarded_vendors": null,
      "bid_number": "BD-27-1206-40000-40000-134158",
      "bid_opening_date_local": "2026-10-26T00:00:00",
      "bid_opening_date_text": "10/26/2026 12:00 AM",
      "blanket_number": null,
      "buyer": "Lalita Jadav",
      "description": "IFB 131-26 Widett Layover Facility-MBTA Composite Tie Turnout- F60PS01",
      "detail_url": "https://www.commbuys.com/bso/external/bidDetail.sda?docId=BD-27-1206-40000-40000-134158&external=true&parentUrl=close",
      "organization_name": "Massachusetts Bay Transportation Authority",
      "status": "Sent"
    },
    {
      "alternate_id": "27TALAP1 - Due Diligence",
      "awarded_vendors": null,
      "bid_number": "BD-27-1026-DOE02-DOE01-134154",
      "bid_opening_date_local": "2026-10-19T12:00:00",
      "bid_opening_date_text": "10/19/2026 12:00 PM",
      "blanket_number": null,
      "buyer": "Deborah Dahl",
      "description": "27TALAP1 - Due Diligence | Technical Assistance for EIR & DESE-sponsored Early Literacy Tutoring",
      "detail_url": "https://www.commbuys.com/bso/external/bidDetail.sda?docId=BD-27-1026-DOE02-DOE01-134154&external=true&parentUrl=close",
      "organization_name": "Department of Elementary and Secondary Education",
      "status": "Sent"
    },
    {
      "alternate_id": null,
      "awarded_vendors": null,
      "bid_number": "BD-27-1149-FTBRG-FTBRG-134148",
      "bid_opening_date_local": "2026-10-22T11:00:00",
      "bid_opening_date_text": "10/22/2026 11:00 AM",
      "blanket_number": null,
      "buyer": "Samantha Sauer",
      "description": "27-043 Residuals Hauling",
      "detail_url": "https://www.commbuys.com/bso/external/bidDetail.sda?docId=BD-27-1149-FTBRG-FTBRG-134148&external=true&parentUrl=close",
      "organization_name": "City of Fitchburg",
      "status": "Sent"
    },
    {
      "alternate_id": "FY27_ITS86_Veterans Cemetery Digital Services Port",
      "awarded_vendors": null,
      "bid_number": "BD-27-1110-1110C-1110L-134139",
      "bid_opening_date_local": "2026-10-12T15:00:00",
      "bid_opening_date_text": "10/12/2026 3:00 PM",
      "blanket_number": null,
      "buyer": "Erin Veilleux",
      "description": "FY27_ITS86_Veterans Cemetery Digital Services Portal",
      "detail_url": "https://www.commbuys.com/bso/external/bidDetail.sda?docId=BD-27-1110-1110C-1110L-134139&external=true&parentUrl=close",
      "organization_name": "Department of Veterans Services",
      "status": "Sent"
    },
    {
      "alternate_id": null,
      "awarded_vendors": null,
      "bid_number": "BD-27-1138-CHAAD-02-134137",
      "bid_opening_date_local": "2026-10-21T14:00:00",
      "bid_opening_date_text": "10/21/2026 2:00 PM",
      "blanket_number": null,
      "buyer": "Sharon Smith",
      "description": "ASHP Suffolk County",
      "detail_url": "https://www.commbuys.com/bso/external/bidDetail.sda?docId=BD-27-1138-CHAAD-02-134137&external=true&parentUrl=close",
      "organization_name": "Chelmsford Housing Authority",
      "status": "Sent"
    },
    {
      "alternate_id": null,
      "awarded_vendors": null,
      "bid_number": "BD-27-1030-0H100-0H002-134134",
      "bid_opening_date_local": "2026-10-27T14:00:00",
      "bid_opening_date_text": "10/27/2026 2:00 PM",
      "blanket_number": null,
      "buyer": "Alex Deng",
      "description": "616507 DISTRICT 6 Generator Maintenance and Testing at Various Locations (3 Yrs)",
      "detail_url": "https://www.commbuys.com/bso/external/bidDetail.sda?docId=BD-27-1030-0H100-0H002-134134&external=true&parentUrl=close",
      "organization_name": "Department of Transportation",
      "status": "Sent"
    },
    {
      "alternate_id": null,
      "awarded_vendors": null,
      "bid_number": "BD-27-1030-0H100-0H002-134132",
      "bid_opening_date_local": "2026-11-03T14:00:00",
      "bid_opening_date_text": "11/03/2026 2:00 PM",
      "blanket_number": null,
      "buyer": "Alex Deng",
      "description": "616509 DISTRICT 6 Scheduled & Emergency Tree Trimming & Sight Distance Improvement at Various Loca",
      "detail_url": "https://www.commbuys.com/bso/external/bidDetail.sda?docId=BD-27-1030-0H100-0H002-134132&external=true&parentUrl=close",
      "organization_name": "Department of Transportation",
      "status": "Sent"
    },
    {
      "alternate_id": null,
      "awarded_vendors": null,
      "bid_number": "BD-27-1030-0H100-0H002-134131",
      "bid_opening_date_local": "2026-11-03T14:00:00",
      "bid_opening_date_text": "11/03/2026 2:00 PM",
      "blanket_number": null,
      "buyer": "Alex Deng",
      "description": "616410 DISTRICT 5 Scheduled and Emergency Fabrication and Installation of Overhead and Ground Moun",
      "detail_url": "https://www.commbuys.com/bso/external/bidDetail.sda?docId=BD-27-1030-0H100-0H002-134131&external=true&parentUrl=close",
      "organization_name": "Department of Transportation",
      "status": "Sent"
    },
    {
      "alternate_id": null,
      "awarded_vendors": null,
      "bid_number": "BD-27-1030-0H100-0H002-134129",
      "bid_opening_date_local": "2026-10-27T14:00:00",
      "bid_opening_date_text": "10/27/2026 2:00 PM",
      "blanket_number": null,
      "buyer": "Alex Deng",
      "description": "616408 DISTRICT 5 Scheduled and Emergency Cleaning of Drainage Structures and Pipes at Various Loc",
      "detail_url": "https://www.commbuys.com/bso/external/bidDetail.sda?docId=BD-27-1030-0H100-0H002-134129&external=true&parentUrl=close",
      "organization_name": "Department of Transportation",
      "status": "Sent"
    },
    {
      "alternate_id": null,
      "awarded_vendors": null,
      "bid_number": "BD-27-1167-PUR02-PUR01-134127",
      "bid_opening_date_local": "2026-10-23T14:00:00",
      "bid_opening_date_text": "10/23/2026 2:00 PM",
      "blanket_number": null,
      "buyer": "Carol Teixeira-Dragon",
      "description": "27-057 Price Agreement for Pierce Parts and Services",
      "detail_url": "https://www.commbuys.com/bso/external/bidDetail.sda?docId=BD-27-1167-PUR02-PUR01-134127&external=true&parentUrl=close",
      "organization_name": "City of Springfield",
      "status": "Sent"
    },
    {
      "alternate_id": "Project # FY27LAND0018",
      "awarded_vendors": null,
      "bid_number": "BD-27-1042-ENV-ENV01-134124",
      "bid_opening_date_local": "2026-12-17T23:59:00",
      "bid_opening_date_text": "12/17/2026 11:59 PM",
      "blanket_number": null,
      "buyer": "Richard Calderon",
      "description": "Tribal Land Acquisition Grant Program FY27-28 RFR",
      "detail_url": "https://www.commbuys.com/bso/external/bidDetail.sda?docId=BD-27-1042-ENV-ENV01-134124&external=true&parentUrl=close",
      "organization_name": "Executive Office of Energy and Environmental Affairs",
      "status": "Sent"
    },
    {
      "alternate_id": null,
      "awarded_vendors": null,
      "bid_number": "BD-27-1499-TS001-TS001-134121",
      "bid_opening_date_local": "2026-10-27T15:00:00",
      "bid_opening_date_text": "10/27/2026 3:00 PM",
      "blanket_number": null,
      "buyer": "Joe LaCivita",
      "description": "MUNICIPAL FINANCIAL SERVICES",
      "detail_url": "https://www.commbuys.com/bso/external/bidDetail.sda?docId=BD-27-1499-TS001-TS001-134121&external=true&parentUrl=close",
      "organization_name": "Town of Tisbury",
      "status": "Sent"
    },
    {
      "alternate_id": null,
      "awarded_vendors": null,
      "bid_number": "BD-27-1262-EB126-EB-134120",
      "bid_opening_date_local": "2026-10-26T14:00:00",
      "bid_opening_date_text": "10/26/2026 2:00 PM",
      "blanket_number": null,
      "buyer": "Charles Seelig",
      "description": "Materials Testing and Inspection Services",
      "detail_url": "https://www.commbuys.com/bso/external/bidDetail.sda?docId=BD-27-1262-EB126-EB-134120&external=true&parentUrl=close",
      "organization_name": "Town of East Bridgewater",
      "status": "Sent"
    },
    {
      "alternate_id": null,
      "awarded_vendors": null,
      "bid_number": "BD-27-1800-TOL01-TOL01-134117",
      "bid_opening_date_local": "2026-10-21T16:30:00",
      "bid_opening_date_text": "10/21/2026 4:30 PM",
      "blanket_number": null,
      "buyer": "Daniel Pereira",
      "description": "Conservation Department Equipment Barn Renovation 2026",
      "detail_url": "https://www.commbuys.com/bso/external/bidDetail.sda?docId=BD-27-1800-TOL01-TOL01-134117&external=true&parentUrl=close",
      "organization_name": "Town of Lincoln",
      "status": "Sent"
    },
    {
      "alternate_id": null,
      "awarded_vendors": null,
      "bid_number": "BD-27-1035-DYS01-DYS01-134113",
      "bid_opening_date_local": "2026-10-16T16:00:00",
      "bid_opening_date_text": "10/16/2026 4:00 PM",
      "blanket_number": null,
      "buyer": "Jannelvy Martinez",
      "description": "FAC120 - Snow Removal and Sanding Services",
      "detail_url": "https://www.commbuys.com/bso/external/bidDetail.sda?docId=BD-27-1035-DYS01-DYS01-134113&external=true&parentUrl=close",
      "organization_name": "Department of Youth Services",
      "status": "Sent"
    },
    {
      "alternate_id": null,
      "awarded_vendors": null,
      "bid_number": "BD-27-1155-CMOMA-MAY01-134110",
      "bid_opening_date_local": "2026-11-02T15:00:00",
      "bid_opening_date_text": "11/02/2026 3:00 PM",
      "blanket_number": null,
      "buyer": "Jane Pitts",
      "description": "Interior Plaster Mem Bldg",
      "detail_url": "https://www.commbuys.com/bso/external/bidDetail.sda?docId=BD-27-1155-CMOMA-MAY01-134110&external=true&parentUrl=close",
      "organization_name": "City of Melrose",
      "status": "Sent"
    },
    {
      "alternate_id": null,
      "awarded_vendors": null,
      "bid_number": "BD-27-1047-1047C-1047L-134106",
      "bid_opening_date_local": "2026-11-10T16:00:00",
      "bid_opening_date_text": "11/10/2026 4:00 PM",
      "blanket_number": null,
      "buyer": "Moira Rouse",
      "description": "RFP-27-01 Public Safety Radio Communication Upgrade",
      "detail_url": "https://www.commbuys.com/bso/external/bidDetail.sda?docId=BD-27-1047-1047C-1047L-134106&external=true&parentUrl=close",
      "organization_name": "Framingham State University",
      "status": "Sent"
    },
    {
      "alternate_id": null,
      "awarded_vendors": null,
      "bid_number": "BD-26-1202-COCC1-COCC1-134103",
      "bid_opening_date_local": "2026-10-30T11:00:00",
      "bid_opening_date_text": "10/30/2026 11:00 AM",
      "blanket_number": null,
      "buyer": "Rita Brousseau",
      "description": "IFB 2026-26 ASBESTOS ABATEMENT SERVICES",
      "detail_url": "https://www.commbuys.com/bso/external/bidDetail.sda?docId=BD-26-1202-COCC1-COCC1-134103&external=true&parentUrl=close",
      "organization_name": "Lowell Housing Authority",
      "status": "Sent"
    },
    {
      "alternate_id": null,
      "awarded_vendors": null,
      "bid_number": "BD-26-1202-COCC1-COCC1-134102",
      "bid_opening_date_local": "2026-10-30T11:00:00",
      "bid_opening_date_text": "10/30/2026 11:00 AM",
      "blanket_number": null,
      "buyer": "Rita Brousseau",
      "description": "IFB 2026-25 HVAC EQUIPMENT MAINTENANCE AND REPAIR SERVICES",
      "detail_url": "https://www.commbuys.com/bso/external/bidDetail.sda?docId=BD-26-1202-COCC1-COCC1-134102&external=true&parentUrl=close",
      "organization_name": "Lowell Housing Authority",
      "status": "Sent"
    },
    {
      "alternate_id": null,
      "awarded_vendors": null,
      "bid_number": "BD-27-1459-BTV06-BTV06-134100",
      "bid_opening_date_local": "2026-10-21T09:00:00",
      "bid_opening_date_text": "10/21/2026 9:00 AM",
      "blanket_number": null,
      "buyer": "Rachel Leonardo",
      "description": "Sewer Pump Station On-Call Repair & Maintenance",
      "detail_url": "https://www.commbuys.com/bso/external/bidDetail.sda?docId=BD-27-1459-BTV06-BTV06-134100&external=true&parentUrl=close",
      "organization_name": "Town of Burlington",
      "status": "Sent"
    },
    {
      "alternate_id": null,
      "awarded_vendors": null,
      "bid_number": "BD-27-1438-FRTA1-FRTA1-134099",
      "bid_opening_date_local": "2026-10-23T13:00:00",
      "bid_opening_date_text": "10/23/2026 1:00 PM",
      "blanket_number": null,
      "buyer": "Michael Perreault",
      "description": "Invitation For Bids 2026.08.4 JWO Transit Center Hydronic System Cleaning and Glycol Replacement",
      "detail_url": "https://www.commbuys.com/bso/external/bidDetail.sda?docId=BD-27-1438-FRTA1-FRTA1-134099&external=true&parentUrl=close",
      "organization_name": "Franklin Regional Transit Authority",
      "status": "Sent"
    },
    {
      "alternate_id": null,
      "awarded_vendors": null,
      "bid_number": "BD-27-2182-SWMHA-SWMHA-134096",
      "bid_opening_date_local": "2026-10-16T14:00:00",
      "bid_opening_date_text": "10/16/2026 2:00 PM",
      "blanket_number": null,
      "buyer": "Sharon Smith",
      "description": "FISH 291085",
      "detail_url": "https://www.commbuys.com/bso/external/bidDetail.sda?docId=BD-27-2182-SWMHA-SWMHA-134096&external=true&parentUrl=close",
      "organization_name": "Swampscott Housing Authority",
      "status": "Sent"
    },
    {
      "alternate_id": null,
      "awarded_vendors": null,
      "bid_number": "BD-27-2182-SWMHA-SWMHA-134095",
      "bid_opening_date_local": "2026-10-16T14:00:00",
      "bid_opening_date_text": "10/16/2026 2:00 PM",
      "blanket_number": null,
      "buyer": "Sharon Smith",
      "description": "FISH 291084",
      "detail_url": "https://www.commbuys.com/bso/external/bidDetail.sda?docId=BD-27-2182-SWMHA-SWMHA-134095&external=true&parentUrl=close",
      "organization_name": "Swampscott Housing Authority",
      "status": "Sent"
    },
    {
      "alternate_id": "FAC127 - FHAO Office Move",
      "awarded_vendors": null,
      "bid_number": "BD-27-1023-DMR11-DMRCW-134093",
      "bid_opening_date_local": "2026-10-19T13:00:00",
      "bid_opening_date_text": "10/19/2026 1:00 PM",
      "blanket_number": null,
      "buyer": "Shannon Juda",
      "description": "DDS Northampton Office Move FHAO",
      "detail_url": "https://www.commbuys.com/bso/external/bidDetail.sda?docId=BD-27-1023-DMR11-DMRCW-134093&external=true&parentUrl=close",
      "organization_name": "Department of Developmental Services",
      "status": "Sent"
    }
  ],
  "source_url": "https://www.commbuys.com/bso/view/search/external/advancedSearchBid.xhtml?openBids=true",
  "time_zone": "America/New_York",
  "total_count": 940
}
```

### Search bids

- Capability: `public-tenders/search_bids`
- Description: Search COMMBUYS bid solicitations through the public Advanced Search form (a JSF session is opened, the search POSTed and, for offsets past the first page, the results datatable paginated), 25 rows a page. Dropdown filters (organization, buyer, NIGP class, category) accept the site's code or the name as listed and are resolved against the form's option lists before the search. Each row carries the bid solicitation number, organization, blanket number, buyer, description, bid opening date as displayed (Massachusetts time, no zone shown) with an ISO wall-clock conversion, awarded vendors, status, alternate id and the detail URL.
- Instructions: Find solicitations by keyword (description; with `match: any` also item description, bid number and alternate id), organization (agency), buyer, NIGP class, type code, status, UNSPSC category or opening-date window; pass a row's `bid_number` to get_bid and a `blanket_number` to get_blanket. Use list_open_bids instead for the site's curated list of currently open solicitations. At least one criterion is required; a legitimate zero-row answer sets `total_count` to 0.
- Cost: 5 credits per call
- Capability file: [Search bids](https://firecrawl.dev/alexandria/agents/providers/commbuys-com/public-tenders/search_bids)

Accepted options:
- `bid_number` (string): Bid solicitation number or prefix, e.g. `BD-27-1060-ITD00-ITD00-133949` or `BD-27-1060` (the form's Bid # field). Example: `BD-27-1060-ITD00-ITD00-133949`
- `buyer` (string): Buyer id as the site uses it (e.g. `AUDREY.BANKS`) or the buyer's name as listed (`Last, First`); a unique fragment is accepted. Example: `AUDREY.BANKS`
- `category_code` (string): UNSPSC segment of the form's Category dropdown: the two-digit code, e.g. `43` (Information Technology Broadcasting and Telecommunications) or `00` (Grants), or a unique fragment of its name. Example: `43`
- `cursor` (string): Row offset of the page to return (a multiple of 25), as given by the previous answer's `next_cursor`. Omit for the first page. The same criteria must be passed again; the site's session is re-established on every call. Pattern: ^[0-9]{1,6}$. Example: `next_cursor`
- `keyword` (string): Free text matched against the solicitation description (the form's Description field). With `match: any` it is also applied to the item description, bid number and alternate id, as the site's quick search does. Example: `match: any`
- `match` (string): `all` (default): every filled criterion must match (the form's default). `any`: the site's Any/OR switch; the keyword is copied into the description, item description, bid number and alternate id fields, and a row matches when ANY filled criterion matches - so combining `any` with `status` or `type_code` returns every bid with that status or type, not the intersection. Use `any` for keyword-only quick searches and `all` when combining filters. Example: `all`
- `nigp_class` (string): NIGP class code of the form's NIGP Class dropdown, e.g. `43-23`. Pattern: ^[0-9]{2}-[0-9]{2}$. Example: `43-23`
- `opening_date_from` (string): Bid opening date lower bound as the form takes it, MM/DD/YYYY. Pattern: ^(0[1-9]|1[0-2])/(0[1-9]|[12][0-9]|3[01])/[0-9]{4}$. Example: `<opening_date_from>`
- `opening_date_to` (string): Bid opening date upper bound, MM/DD/YYYY. Pattern: ^(0[1-9]|1[0-2])/(0[1-9]|[12][0-9]|3[01])/[0-9]{4}$. Example: `<opening_date_to>`
- `organization` (string): Organization (agency) code as the site uses it, e.g. `1060`, or its name as listed, e.g. `Executive Office of Technology Services and Security`; a unique case-insensitive fragment of the name is accepted, an ambiguous one is rejected with candidates. Example: `1060`
- `status` (string): Status code: 2BA Approved, 2BCL Closed, 2BE Evaluated, 2BIA Intent To Award, 2BO Opened, 2BPO Bid to PO, 2BS Sent (open for responses). Example: `2BA`
- `type_code` (string): Solicitation type: NS Non-Statewide Solicitation, SH Historical Solicitation, SS Statewide Solicitation. Example: `NS`

Response schema example:
```json
{
  "count": 1,
  "next_cursor": null,
  "observed_at_ms": 1791237568583,
  "offset": 0,
  "page_size": 25,
  "query": {
    "bid_number": "BD-27-1060-ITD00-ITD00-133949",
    "buyer_id": null,
    "buyer_name": null,
    "category_code": null,
    "category_name": null,
    "keyword": null,
    "match": "all",
    "nigp_class": null,
    "nigp_class_name": null,
    "opening_date_from": null,
    "opening_date_to": null,
    "organization_code": null,
    "organization_name": null,
    "status": null,
    "type_code": null
  },
  "records": [
    {
      "alternate_id": "PCR-27-05699",
      "awarded_vendors": null,
      "bid_number": "BD-27-1060-ITD00-ITD00-133949",
      "bid_opening_date_local": "2026-10-20T15:00:00",
      "bid_opening_date_text": "10/20/2026 3:00 PM",
      "blanket_number": null,
      "buyer": "Nelson Wong",
      "description": "RFQ-27-05699 Accela Software Solution and Support",
      "detail_url": "https://www.commbuys.com/bso/external/bidDetail.sda?docId=BD-27-1060-ITD00-ITD00-133949&external=true&parentUrl=close",
      "organization_name": "Executive Office of Technology Services and Security",
      "status": "Sent"
    }
  ],
  "source_url": "https://www.commbuys.com/bso/view/search/external/advancedSearchBid.xhtml",
  "time_zone": "America/New_York",
  "total_count": 1
}
```