alabamabids.com APIalabamabids.com ↗
Access Alabama Bid Network bid opportunities, award results, and classifieds via API. Browse by date, get bid details, and retrieve winning bidder data.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/e9fed907-0c0e-4e0e-a3f2-678122e2dc59/get_available_bid_months' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve all available year/month combinations that have bid opportunities listed. Returns a descending chronological list spanning several years of historical data.
No input parameters required.
{
"type": "object",
"fields": {
"available_months": "array of objects each containing year, month (zero-padded), and url"
},
"sample": {
"data": {
"available_months": [
{
"url": "https://www.alabamabids.com/bid_opportunities/2026/05/",
"year": "2026",
"month": "05"
},
{
"url": "https://www.alabamabids.com/bid_opportunities/2026/04/",
"year": "2026",
"month": "04"
}
]
},
"status": "success"
}
}About the alabamabids.com API
The Alabama Bids API exposes 9 endpoints covering bid solicitations, award results, and classified listings from alabamabids.com. Use get_bids_by_date to pull every bid posted on a given day — including title, scope, bid_id, and detail URL — or get_bid_result_detail to retrieve the winning bidder name, bid amount, opening date, and contract description for a specific award announcement.
Browsing and Filtering Bid Opportunities
The API provides a full date-navigation path for bid solicitations. Call get_available_bid_months to retrieve every year/month combination in the archive, then use get_bids_by_month with year and month parameters to see which specific days have listings. Passing day, month, and year to get_bids_by_date returns the full list of bids for that date, each with a bid_id, title, scope, added_updated_date, and url. For the most recent activity without date navigation, get_latest_bids supports a page integer for pagination through the homepage feed.
Bid Detail and Award Results
get_bid_detail accepts a full detail page URL (obtained from listing endpoints) and returns the solicitation's title, scope, and added_updated date. For completed solicitations, get_bid_results lists recent award announcements paginated by page, with each entry carrying a summary, url, and id. Fetching a specific award via get_bid_result_detail yields structured fields: title, low_bidder, bid_amount, opening_date, description, and a raw_content string containing the full page text for cases where structured parsing does not capture every detail.
Classified Listings
get_classifieds returns the classified ads board with optional category filtering. Each classified object includes title, url, description_snippet, updated, and price. The dataset is noted to be small and may contain older listings. For full text, pass any classified's URL to get_classified_detail, which returns title and description.
- Monitor daily Alabama government contract solicitations by polling
get_bids_by_dateand alerting on newbid_idvalues. - Build a bid-award tracker by correlating
get_bid_resultsentries withlow_bidderandbid_amountfields fromget_bid_result_detail. - Aggregate historical bidding activity across multiple years using
get_available_bid_monthsto iterate the full archive. - Identify active vendors in Alabama public contracting by collecting
low_biddernames from award detail records. - Track time-to-award by comparing
added_updateddates from bid listings withopening_datefrom matching award results. - Screen classified equipment listings for public-sector surplus by filtering
get_classifiedsby category and checkingpriceandupdatedfields. - Populate a procurement calendar app with bid deadlines by extracting
titleandadded_updated_datefrom date-range queries.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does alabamabids.com have an official developer API?+
What does `get_bid_result_detail` return beyond the structured fields?+
title, low_bidder, bid_amount, opening_date, and description, the endpoint returns a raw_content field containing the full text of the award page. This is useful when the structured fields do not capture every line item or note present in the original listing.Does `get_bid_detail` return a bid due date or deadline?+
title, scope, and added_updated. Due date is returned when available, but it is not guaranteed to be present for every solicitation — the source listing may omit it. The API surfaces what the detail page provides.Is there an endpoint to search bids by keyword or agency name?+
get_bids_by_date, paginated latest listings via get_latest_bids, and detail lookup by URL. Keyword or agency-name search is not exposed. You can fork this API on Parse and revise it to add a search endpoint if the source supports query filtering.How fresh is the classified ads data from `get_classifieds`?+
updated field so you can check recency. The get_classified_detail endpoint retrieves the full description text if the snippet alone is insufficient.