Spiral gives your agent every tool with one account. Browse the tools →

AlexandriaPublic RecordsAvailable now

COMMBUYS · Search bids

commbuys-com/public-tenders/search_bids

Search public records with COMMBUYS · Search bids from Alexandria through one Spiral API key. 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. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

Pricing

$0.00873 per call.

Limits

Runs
In the background
Returns
json
Longest queue wait
1 hour
Run deadline
5 minutes
Longest run, end to end
225 minutes
Largest inline input
1 MB
Largest input file
2 GB
Largest output
5 GB

Input

FieldKindDefaultDescription
buyertext—

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.

matchone of
all, any
all

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.

cursortext—

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}$.

statusone of
2BA, 2BCL, 2BE, 2BIA, 2BO, 2BPO, 2BS
—

Status code: 2BA Approved, 2BCL Closed, 2BE Evaluated, 2BIA Intent To Award, 2BO Opened, 2BPO Bid to PO, 2BS Sent (open for responses).

keywordtext—

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.

type_codeone of
NS, SH, SS
—

Solicitation type: NS Non-Statewide Solicitation, SH Historical Solicitation, SS Statewide Solicitation.

bid_numbertext—

Bid solicitation number or prefix, e.g. BD-27-1060-ITD00-ITD00-133949 or BD-27-1060 (the form's Bid # field).

nigp_classtext—

NIGP class code of the form's NIGP Class dropdown, e.g. 43-23. Pattern: ^[0-9]{2}-[0-9]{2}$.

organizationtext—

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.

category_codetext—

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.

opening_date_totext—

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}$.

opening_date_fromtext—

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}$.

Same request in code

curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "commbuys-com/public-tenders/search_bids",
    "input": {
      "buyer": "<buyer>"
    }
  }'

Frequently asked questions

How much does COMMBUYS · Search bids cost?

$0.00873 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

How do I use COMMBUYS · Search bids through an API?

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "commbuys-com/public-tenders/search_bids"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

Do I need an account with Alexandria to use COMMBUYS · Search bids?

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

Can my AI agent use COMMBUYS · Search bids?

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.