Municibid API & Scraper
Municibid is where US townships, boroughs, school districts, water and sewer authorities, police and fire departments, airports and universities auction their surplus directly to the public — plow trucks, dump trucks, police cruisers, tractors and mowers, kitchen and lab equipment, computers, scrap.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
On 2026-11-17 it had 519 live lots, 352 of them in Pennsylvania, 61 in Massachusetts and 56 in New Jersey, and 118,726 closed lots going back to 2019. Municibid publishes no developer API for this; this API returns it as JSON without an account. A search row carries the price together with what the price means (current bid, opening bid, final price, or the high bid on a lot that closed without selling), the bid count, the end time in UTC and in US Eastern time — the zone Municibid shows for every lot in every state — the selling agency and the lot's city and state. One lot in full adds the description, every photo in large and original resolution, the opening bid, bid increment, minimum next bid, bidder count, watchers, page views, reserve state, the buyer's fee tiers, the pickup address and coordinates, inspection and shipping notes, the agency's payment instructions and terms, and its full public bid log and question thread. Closed lots say whether they actually sold. On top of that: sold-only comparables filtered by make, model, year, state and close date, a low / median / high value range from those comparables, and a directory of all 5,031 agencies that have ever sold on Municibid with their closed-lot counts.
What the price and time fields mean
Measured on 2026-11-17 against Municibid's own lot pages: 8 lots (4 live, 2 sold, 2 closed unsold), 15 fields each, 120 of 120 values identical after one fix.
| Field | What it holds |
|---|---|
| current_price + price_basis | current_bid or opening_bid on a live lot; on a closed lot final_price if it sold, high_bid_not_sold if bidding ended without a sale (one 2024 lot: 60 bids, high bid $850, not sold), opening_bid_not_sold if nobody bid. Municibid's lot page prints the same number as Current Price or Final Bid. |
| is_sold | Only on closed lots: whether the agency actually sold. On the most recent 100 closed lots 55 sold and 45 did not. |
| ends_at / ends_at_local | ends_at is UTC. ends_at_local is US Eastern wall-clock (EST or EDT in ends_at_zone_label), because Municibid shows every lot in Eastern time even when the agency is in Illinois or Michigan. Our Eastern time matched the lot page's printed Start Date and End Date on 8 of 8 lots. |
| bid_increment + min_next_bid | The step and the next acceptable bid, from Municibid's live bid box. min_next_bid is null once a lot has closed. |
| buyer_premium_tiers | The buyer's fee schedule, for example 9% from $0 and 6% from $100,000. buyer_premium_percent is the first tier, which matched the lot page on 8 of 8 lots. |
| high_bidder, bids[].bidder | Bidder handles exactly as Municibid publishes them, already masked (h****p). |
| seller_username + agency_name | The agency's Municibid username — the value every agency filter takes — and its public name (Lampeter-Strasburg School District Building Services → LSSD). |
| relaxed | true when nothing matched the keyword exactly and Municibid broadened the match itself ("massey fergusen" returned 2 Massey Ferguson lots). |
Municibid has no sold-only filter on its closed-lot search; sold returns every closed lot with is_sold on each row, and sold_comps returns sold lots only. Lots are identified by Municibid's numeric listing id, the same in every action.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/municibid/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "truck",
"sort": "ending_soonest",
"limit": 24
}
}{
"ok": true,
"meta": {
"api": "municibid",
"endpoint": "search",
"mode": "live",
"latency_ms": 847.5,
"record_count": 24,
"bytes": 11419,
"cache_hit": false,
"upstream_requests": 1,
"time_zone_local": "America/New_York",
"charged_credits": 3,
"version": "1.0.0",
"request_id": "f1bff81cc32c475e",
"queue_ms": 1.3,
"fetched_at": "2026-11-17T14:55:20.294Z"
},
"data": {
"total": 71,
"page": 1,
"limit": 24,
"last_page": 3,
"has_more": true,
"page_beyond_last": false,
"relaxed": false,
"filters": {
"query": "truck",
"sort": "ending_soonest"
},
"measured_at_utc": "2026-11-17T14:55:19Z",
"listings": [
{
"listing_id": 86951901,
"title": "smaller truck toolbox",
"subtitle": null,
"url": "https://municibid.com/listing/86951901/smaller-truck-toolbox",
"status": "active",
"current_price": 50,
"price_basis": "opening_bid",
"bid_count": 0,
"is_sold": null,
"reserve_price": null,
"ends_at": "2026-11-18T14:58:00Z",
"ends_at_local": "2026-11-18T09:58:00",
"ends_at_zone_label": "EST",
"ends_at_offset_hours": -5,
"starts_at": null,
"seconds_remaining": 86560,
"ended": false,
"location": "Oakham, MA",
"city": "Oakham",
"state": "MA",
"distance_miles": null,
"seller_username": "OakhamHighway",
"agency_name": "Town of Oakham Highway Department",
"seller_url": "https://municibid.com/seller/oakhamhighway",
"image_url": "https://storagemunicibidpro.blob.core.windows.net/assets/media/bdd28fd2-a9de-a0f7-8f0a-5584217756d2_thumbcrop.jpg",
"has_video": false
},
{
"listing_id": 86783070,
"title": "2004 Ford Ranger 4X4 Truck",
"subtitle": null,
"url": "https://municibid.com/listing/86783070/2004-ford-ranger-4x4-truck",
"status": "active",
"current_price": 6600,
"price_basis": "current_bid",
"bid_count": 3,
"is_sold": null,
"reserve_price": null,
"ends_at": "2026-11-18T15:00:00Z",
"ends_at_local": "2026-11-18T10:00:00",
"ends_at_zone_label": "EST",
"ends_at_offset_hours": -5,
"starts_at": null,
"seconds_remaining": 86680,
"ended": false,
"location": "Waynesboro, PA",
"city": "Waynesboro",
"state": "PA",
"distance_miles": null,
"seller_username": "QuincyTwp",
"agency_name": "Quincy Township",
"seller_url": "https://municibid.com/seller/quincytwp",
"image_url": "https://storagemunicibidpro.blob.core.windows.net/assets/media/aae19cdf-7036-cf35-4ac4-b76b574ea81d_thumbcrop.jpg",
"has_video": false
},
{
"listing_id": 86917216,
"title": "2003 MACK DUMP TRUCK",
"subtitle": null,
"url": "https://municibid.com/listing/86917216/2003-mack-dump-truck",
"status": "active",
"current_price": 13100,
"price_basis": "current_bid",
"bid_count": 35,
"is_sold": null,
"reserve_price": null,
"ends_at": "2026-11-18T17:00:00Z",
"ends_at_local": "2026-11-18T12:00:00",
"ends_at_zone_label": "EST",
"ends_at_offset_hours": -5,
"starts_at": null,
"seconds_remaining": 93880,
"ended": false,
"location": "Greensburg, PA",
"city": "Greensburg",
"state": "PA",
"distance_miles": null,
"seller_username": "hempfield",
"agency_name": "Hempfield Township",
"seller_url": "https://municibid.com/seller/hempfield",
"image_url": "https://storagemunicibidpro.blob.core.windows.net/assets/media/92702674-378d-2251-1f37-875853e63a67_thumbcrop.jpg",
"has_video": false
}
]
}
}What the Municibid API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search LIVE Municibid lots — the auction site townships, boroughs, school districts, water and sewer authorities, police and fire departments use to sell surplus directly to the public (519 open lots measured 2026-11-17, 352 of them in Pennsylvania, then New Jersey and Massachusetts). Every row carries the price with its basis, the bid count, the end time in real UTC and US Eastern, the selling agency and where the lot is. All filters optional: no filter browses everything, as the site's own /browse does. | Pricing teams call search to search LIVE Municibid lots. | query, category_id, state, seller, zip, ... |
| sold | Search CLOSED Municibid lots with the final price — 118,726 closed auctions reachable (2026-11-17), back to 2019. Every row says whether the lot actually sold (is_sold) and what the price means: final_price when it sold, high_bid_not_sold when bidding ended below what the agency would accept. Same filters as search. For sold-only comparables filtered by make, model, year and date use sold_comps. | Marketplace operators call sold to search CLOSED Municibid lots with the final price. | query, category_id, state, seller, zip, ... |
| detail | One Municibid lot in full, live or closed: description, every photo (large and original resolution), opening bid, current price, bid increment, the minimum next bid, bid and bidder counts, the masked high bidder, watchers, page views, reserve state, buyer's-fee tiers, start and end time, category path, the agency, pickup address and coordinates, inspection and shipping notes, payment instructions, the seller's terms and the 20 most recent bids. | Catalog enrichment teams call detail to get one Municibid lot in full, live or closed. | listing_id |
| bids | The complete public bid log of one lot, live or closed: every bid with amount, UTC time and whether it was placed by the proxy (automatic) bidder. Bidder handles arrive masked by Municibid itself. | Retail analysts call bids to get the complete public bid log of one lot, live or closed. | listing_id |
| questions | The public question-and-answer thread of one lot: what bidders asked the agency (condition, hours, pickup) and the agency's answers. | Pricing teams call questions to get the public question-and-answer thread of one lot. | listing_id |
| live | The live bid box of one lot, the same small call the lot page polls: current price, bid count, minimum next bid, increment, masked high bidder, reserve state, status and the source's own server clock. Built for polling a lot near its close. | Marketplace operators call live to get the live bid box of one lot, the same small call the lot page polls. | listing_id |
| similar | The live lots Municibid itself shows under 'Related Auctions You Might Be Interested In' on a lot page. | Catalog enrichment teams call similar to get the live lots Municibid itself shows under 'Related Auctions You Might Be Interested In' on a…. | listing_id |
| seller | Public profile of one selling agency: name, city, state, live and sold lot counts, member since, storefront details. Use seller_listings for its lots. | Retail analysts call seller to get public profile of one selling agency. | seller |
| seller_listings | Every lot of one agency, live or closed, paginated — the agency's storefront as a list. | Pricing teams call seller_listings to get every lot of one agency, live or closed, paginated. | seller, status, sort, page, limit |
| sellers | Directory of the agencies with lots live right now, grouped by state, each with its live lot count — the index behind the site's location sidebar. | Marketplace operators call sellers to get directory of the agencies with lots live right now, grouped by state, each with its live lot…. | state, query, min_lots |
| agency_lookup | Find a Municibid agency by part of its name and get its username, location, live lot count and recent sold count — the source's single best match. Read from Municibid's own public AI connector, which knows agencies with RECENT activity only (measured: 'City of Philadelphia', 5,830 closed lots, is not found there); every agency that ever sold is in the agencies action. | Catalog enrichment teams call agency_lookup to find a Municibid agency by part of its name and get its username, location, live lot count an…. | agency_name, state |
| agencies | The full directory of every agency that has ever sold on Municibid — 5,031 agencies in 49 regions — 47 states, Washington DC and Ontario (2026-11-17) — each with the closed-lot count the site prints beside it, plus each state's total. Read from the site's own closed-lot page (one 1.9 MB request). | Retail analysts call agencies to get the full directory of every agency that has ever sold on Municibid. | state, query, min_closed_lots, sort, page, ... |
| categories | Municibid's whole category tree: 46 top-level categories with their live lot counts, and every sub-category id under them with its page URL. | Pricing teams call categories to get municibid's whole category tree. | flat, top_level_only |
| subcategories | The named sub-categories of one category with their live lot counts, read from the category page the site itself renders (for example Automotive -> Buses, Cars, Heavy Duty Trucks, SUV, Trucks, Vans). | Marketplace operators call subcategories to get the named sub-categories of one category with their live lot counts, read from the category p…. | parent_id |
| locations | Every state and agency with lots live right now and its live count, plus the full list of 49 regions Municibid has ever sold in with the id the state filter uses. | Catalog enrichment teams call locations to get every state and agency with lots live right now and its live count, plus the full list of 49…. | none |
| suggest | What the site's own search box suggests while typing: matching categories, states and agencies with their live lot counts, and a listing-number jump when the text is a number. | Retail analysts call suggest to get what the site's own search box suggests while typing. | query, limit |
| map | Every live Municibid lot with coordinates — the data behind the site's map view. Optional state, agency or bounding-box filter. | Pricing teams call map to get every live Municibid lot with coordinates. | state, seller, min_lat, max_lat, min_lng, ... |
| sold_comps | Sold-only comparables: closed Municibid lots that actually sold, filtered by keyword, make, model, year, state, category and close-date window, each with its sold price. Read from Municibid's own public AI connector. | Marketplace operators call sold_comps to get sold-only comparables. | query, make, model, year, state, ... |
| market_value | A low / median / high value range for an item from Municibid's own sold comparables (default lookback 24 months), with a confidence label and the comparables used. Directional, not an appraisal. Read from Municibid's own public AI connector. | Catalog enrichment teams call market_value to get a low / median / high value range for an item from Municibid's own sold comparables (default…. | query, listing_id, make, model, year, ... |
Call search from your stack
curl -X POST https://api.reefapi.com/municibid/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"truck","sort":"ending_soonest","limit":24}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/municibid/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "truck",
"sort": "ending_soonest",
"limit": 24
},
timeout=90,
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/municibid/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "truck",
"sort": "ending_soonest",
"limit": 24
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.municibid.search with {"query":"truck","sort":"ending_soonest","limit":24}.Who uses this API and why
- Alerts on municipal plow trucks, dump trucks, mowers and police vehicles by state, agency and price before they close.
- Sold-price comparables for public-sector fleet: final prices, bid counts and close dates by make, model and year.
- Pricing a lot before bidding with a low / median / high range from Municibid's own sales.
- Dealer sourcing across Pennsylvania, New Jersey and Massachusetts townships and school districts by ZIP and radius.
- Agency prospecting: every township, school district and authority that sells on Municibid, with its sales volume.
- Auction monitoring next to GovDeals, Public Surplus and HiBid with the same price and end-time fields.
Questions developers ask before integrating
Is there an official Municibid API?
No developer API. Municibid offers an AI-assistant connector for chat use; this API returns Municibid's public auction data as JSON for your own code: live and closed lots, full lot records, bid logs, questions, agencies and categories. No Municibid account is needed.
How many lots are there?
519 live lots on 2026-11-17 (Pennsylvania 352, Massachusetts 61, New Jersey 56, then Illinois, Indiana, New Hampshire, Michigan, Connecticut, New York and six more states) and 118,726 closed lots reachable, back to 2019. Closed lots by state, as Municibid counts them: Pennsylvania 79,457, New Jersey 20,671, Massachusetts 15,716, Louisiana 6,204, New Hampshire 3,463, New York 2,044, Minnesota 1,764, Texas 1,245.
Can I get what things actually sold for?
Yes, two ways. sold returns closed lots with the final price and whether each one sold — "dump truck" in Pennsylvania: 1,639 closed lots. sold_comps returns only lots that sold, filtered by make, model, year, state and close date: Ford F-350 sold 174 times; dump trucks in Pennsylvania 435 times. market_value turns those comparables into a low / median / high range: Ford F-350 $3,525 / $6,400 / $12,275 from 50 sales, confidence high.
Is the full bid history public?
Yes, on live and closed lots: every bid with amount, time and whether Municibid's automatic proxy bidding placed it. A lot with 89 bids returned 89 rows; a 2024 lot with 60 bids returned 60, its highest equal to its closing price. Handles arrive masked by Municibid.
Which filters work?
Each was checked against the unfiltered count of 519 live lots: keyword (truck 71), category (Automotive 161, Dump Trucks 20), state (PA 352, MA 61), agency (LSSD 8), ZIP with radius (15104: Municibid's default 50 lots, 10 miles 4), minimum price (truck: 71 to 24 at $5,000), maximum price (71 to 26 at $1,000). The same filters work on closed lots: Massachusetts above $5,000 1,263 of 118,726. A ZIP Municibid does not know is rejected instead of silently returning everything.
Which sort orders are there?
Municibid's own eight: ending soonest, newest, price low to high, price high to low, most bids, closest (with a ZIP), title A to Z and Z to A — each checked to reorder the result. On closed lots the default is most recently closed first.
How do I find the agencies?
sellers lists the 216 agencies with lots live right now by state. agencies lists all 5,031 agencies that have ever sold on Municibid with their closed-lot counts (City of Philadelphia 5,830, Williamsport Area School District 1,225, Temple University 987). seller returns one agency's profile with live and sold counts, and seller_listings its lots, live or closed.
What is not available?
Anything that needs a Municibid account: bidding, buy-now, your watchlist, followed agencies, whether you are winning, notifications, invoices and payment, and asking a question. Municibid has no sold-only filter on its own closed-lot search, so sold returns every closed lot with is_sold rather than only sold ones; use sold_comps for sold-only.
Which time zone are end times in?
ends_at is UTC. ends_at_local is US Eastern, because Municibid shows every lot in Eastern time, including lots from Illinois, Indiana or Michigan agencies. Checked against the printed Start Date and End Date of 8 lot pages: 8 of 8 matched.
What is the Municibid API?
Municibid API is a ReefAPI endpoint group for us township, school-district and municipal surplus auctions: live lots, bid logs, sold prices and agency directory. It returns live JSON through POST requests under /municibid/v1.
Is the Municibid API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Municibid calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Municibid login or account?
No login to Municibid is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Municibid data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Municibid API use?
Municibid actions currently cost 3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.