# Municibid — US municipal surplus auctions (trucks, plows, police cars, equipment), live and sold

> 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.
> ReefAPI engine `municibid` · 19 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/municibid/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/municibid/v1/search — 3 credits
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.

**Parameters:**
- `query` (string, optional) — Keyword text, 1-200 characters, matched by Municibid against lot titles and descriptions. When nothing matches exactly the source broadens the match itself and says so — returned as relaxed: true.
- `category_id` (integer, optional) — Municibid category id from the categories or subcategories action — top level (160883 Automotive, 169106 Heavy Equipment, 169147 Snow Removal) or any sub-level (5797474 Dump Trucks). Measured to bite: Automotive 161 of 519 live lots, Dump Trucks 20.
- `state` (string, optional) — Two-letter state of the selling agency's region (or ON for Ontario). Measured to bite: PA 352 of 519 live lots, MA 61. Hawaii, Mississippi and Nevada have never carried a Municibid lot and return zero rows.
- `seller` (string, optional) — The agency's Municibid username, exactly as seller_username in any row (also accepts its /seller/<name> URL). Measured to bite: LSSD 8 live lots, 112 closed.
- `zip` (string, optional) — Five-digit US ZIP to search around; every row then carries distance_miles. Without radius_miles the source applies its own default radius (50 lots around 15104 against 519 site-wide). A ZIP the source does not recognise is rejected rather than silently ignored.
- `radius_miles` (integer, optional) — Radius in miles around zip. Measured to bite around 15104: 10 miles 4 lots, 25 miles 42, 30 miles 43.
- `min_price` (number, optional) — Lowest current price in USD, inclusive. Measured: 'truck' 71 lots, min_price 5000 24.
- `max_price` (number, optional) — Highest current price in USD, inclusive. Measured: 'truck' 71 lots, max_price 1000 26.
- `sort` (enum, optional, default "ending_soonest") — Result order — the site's own eight sort options, each measured to reorder the result. [one of: ending_soonest, newest, price_low, price_high, most_bids, closest, title_az, title_za]
- `page` (integer, optional, default 1) — One-based page. last_page in the response is the final page that carries rows; beyond it the source answers with zero rows (measured) and page_beyond_last says so.
- `limit` (integer, optional, default 24) — Rows per page, 1-100. The source honours every value up to 100 and caps silently above it, so 100 is the published ceiling.

**Returns:** total (the source's own count), page, limit, last_page, has_more, page_beyond_last, relaxed (the source broadened a keyword with no exact match), filters echo, measured_at_utc, and listings[]: listing_id, title, subtitle, url, status, current_price with price_basis (current_bid / opening_bid on live lots; final_price, high_bid_not_sold or opening_bid_not_sold on closed ones), bid_count, is_sold (closed lots), reserve_price, ends_at (ISO-8601 UTC), ends_at_local (US Eastern, the zone the site shows), ends_at_zone_label, ends_at_offset_hours, starts_at, seconds_remaining, ended, location, city, state, distance_miles (with zip), seller_username, agency_name, seller_url, image_url and has_video.

**Example request body:**
```json
{
  "query": "truck",
  "sort": "ending_soonest",
  "limit": 24
}
```

### POST https://api.reefapi.com/municibid/v1/sold — 3 credits
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.

**Parameters:**
- `query` (string, optional) — Keyword text, 1-200 characters, matched by Municibid against lot titles and descriptions. When nothing matches exactly the source broadens the match itself and says so — returned as relaxed: true.
- `category_id` (integer, optional) — Municibid category id from the categories or subcategories action — top level (160883 Automotive, 169106 Heavy Equipment, 169147 Snow Removal) or any sub-level (5797474 Dump Trucks). Measured to bite: Automotive 161 of 519 live lots, Dump Trucks 20.
- `state` (string, optional) — Two-letter state of the selling agency's region (or ON for Ontario). Measured to bite: PA 352 of 519 live lots, MA 61. Hawaii, Mississippi and Nevada have never carried a Municibid lot and return zero rows.
- `seller` (string, optional) — The agency's Municibid username, exactly as seller_username in any row (also accepts its /seller/<name> URL). Measured to bite: LSSD 8 live lots, 112 closed.
- `zip` (string, optional) — Five-digit US ZIP to search around; every row then carries distance_miles. Without radius_miles the source applies its own default radius (50 lots around 15104 against 519 site-wide). A ZIP the source does not recognise is rejected rather than silently ignored.
- `radius_miles` (integer, optional) — Radius in miles around zip. Measured to bite around 15104: 10 miles 4 lots, 25 miles 42, 30 miles 43.
- `min_price` (number, optional) — Lowest current price in USD, inclusive. Measured: 'truck' 71 lots, min_price 5000 24.
- `max_price` (number, optional) — Highest current price in USD, inclusive. Measured: 'truck' 71 lots, max_price 1000 26.
- `sort` (enum, optional, default "recently_closed") — Result order on closed lots — the site's own sort options, each measured to reorder the result. [one of: recently_closed, newest, price_high, price_low, most_bids, closest, title_az, title_za]
- `page` (integer, optional, default 1) — One-based page. last_page in the response is the final page that carries rows; beyond it the source answers with zero rows (measured) and page_beyond_last says so.
- `limit` (integer, optional, default 24) — Rows per page, 1-100. The source honours every value up to 100 and caps silently above it, so 100 is the published ceiling.

**Returns:** total (the source's own count), page, limit, last_page, has_more, page_beyond_last, relaxed (the source broadened a keyword with no exact match), filters echo, measured_at_utc, and page_sold_count, and listings[]: listing_id, title, subtitle, url, status, current_price with price_basis (current_bid / opening_bid on live lots; final_price, high_bid_not_sold or opening_bid_not_sold on closed ones), bid_count, is_sold (closed lots), reserve_price, ends_at (ISO-8601 UTC), ends_at_local (US Eastern, the zone the site shows), ends_at_zone_label, ends_at_offset_hours, starts_at, seconds_remaining, ended, location, city, state, distance_miles (with zip), seller_username, agency_name, seller_url, image_url and has_video.

**Example request body:**
```json
{
  "query": "dump truck",
  "state": "PA",
  "limit": 24
}
```

### POST https://api.reefapi.com/municibid/v1/detail — 3 credits
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.

**Parameters:**
- `listing_id` (string, required) — Numeric Municibid listing id (the number in /listing/<id>/...), or the lot URL itself.

**Returns:** listing_id, title, subtitle, url, status (Active / Successful / Unsuccessful), is_sold, type, lot_number, event_id, quantity, currency, current_price, price_basis, opening_bid, bid_increment, min_next_bid, bid_count, bidder_count, high_bidder (masked by the source), highest_proxy_bid, watchers, page_views, no_reserve, reserve_price, reserve_met, buy_it_now, fixed_price, buyer_premium_percent, buyer_premium_tiers[], starts_at(_local), ends_at, ends_at_local, ends_at_zone_label, ends_at_offset_hours, seconds_remaining, ended, category_id, category_name, category_path[], region_id, region_name, seller_username, agency_name, seller_url, location{display, city, state, zip, latitude, longitude}, pickup_location, will_ship, inspection_info, description, description_html, appended_description, payment_instructions, seller_terms, attributes[], raw_properties[], images[], image_count, images_original[], videos[], attachments[], shipping_options[], recent_bids[], measured_at_utc.

**Example request body:**
```json
{
  "listing_id": "86276004"
}
```

### POST https://api.reefapi.com/municibid/v1/bids — 3 credits
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.

**Parameters:**
- `listing_id` (string, required) — Numeric Municibid listing id (the number in /listing/<id>/...), or the lot URL itself.

**Returns:** listing_id, url, total, highest_bid, distinct_bidders, proxy_bid_count and bids[] newest first: bidder (masked by the source), amount, placed_at (UTC), placed_at_local (US Eastern), placed_at_zone_label, is_proxy_bid.

**Example request body:**
```json
{
  "listing_id": "86276004"
}
```

### POST https://api.reefapi.com/municibid/v1/questions — 3 credits
The public question-and-answer thread of one lot: what bidders asked the agency (condition, hours, pickup) and the agency's answers.

**Parameters:**
- `listing_id` (string, required) — Numeric Municibid listing id (the number in /listing/<id>/...), or the lot URL itself.

**Returns:** listing_id, url, total, answered and questions[]: question_id, question, answer, asked_by (masked by the source), answered_by, asked_at, answered_at, is_answered, is_edited, edited_at, replies[].

**Example request body:**
```json
{
  "listing_id": "86276004"
}
```

### POST https://api.reefapi.com/municibid/v1/live — 3 credits
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.

**Parameters:**
- `listing_id` (string, required) — Numeric Municibid listing id (the number in /listing/<id>/...), or the lot URL itself.

**Returns:** listing_id, status, is_sold, current_price, price_basis, bid_count, accepted_action_count, high_bidder, bid_increment, min_next_bid, reserve_met, ends_at, ends_at_local, ends_at_zone_label, seconds_remaining (against the source's own clock), ended, server_now_utc, url.

**Example request body:**
```json
{
  "listing_id": "86276004"
}
```

### POST https://api.reefapi.com/municibid/v1/similar — 3 credits
The live lots Municibid itself shows under 'Related Auctions You Might Be Interested In' on a lot page.

**Parameters:**
- `listing_id` (string, required) — Numeric Municibid listing id (the number in /listing/<id>/...), or the lot URL itself.

**Returns:** listing_id, total and listings[]: listing_id, title, subtitle, url, status, current_price with price_basis (current_bid / opening_bid on live lots; final_price, high_bid_not_sold or opening_bid_not_sold on closed ones), bid_count, is_sold (closed lots), reserve_price, ends_at (ISO-8601 UTC), ends_at_local (US Eastern, the zone the site shows), ends_at_zone_label, ends_at_offset_hours, starts_at, seconds_remaining, ended, location, city, state, distance_miles (with zip), seller_username, agency_name, seller_url, image_url and has_video.

**Example request body:**
```json
{
  "listing_id": "86276004"
}
```

### POST https://api.reefapi.com/municibid/v1/seller — 3 credits
Public profile of one selling agency: name, city, state, live and sold lot counts, member since, storefront details. Use seller_listings for its lots.

**Parameters:**
- `seller` (string, required) — The agency's Municibid username, as seller_username in any row, or its /seller/<name> URL.

**Returns:** seller_username, agency_name, city, state, active_listing_count, sold_listing_count, member_since, url, storefront_title, storefront_subtitle, storefront_background_url, storefront_logos, terms_of_sale_url, disclaimer_url.

**Example request body:**
```json
{
  "seller": "LSSD"
}
```

### POST https://api.reefapi.com/municibid/v1/seller_listings — 3 credits
Every lot of one agency, live or closed, paginated — the agency's storefront as a list.

**Parameters:**
- `seller` (string, required) — The agency's Municibid username, as seller_username in any row.
- `status` (enum, optional, default "active") — Live or closed lots. [one of: active, completed]
- `sort` (enum, optional, default "ending_soonest") — Result order; recently_closed applies to closed lots. [one of: ending_soonest, newest, price_low, price_high, most_bids, title_az, title_za, recently_closed]
- `page` (integer, optional, default 1) — One-based page. last_page in the response is the final page that carries rows; beyond it the source answers with zero rows (measured) and page_beyond_last says so.
- `limit` (integer, optional, default 24) — Rows per page, 1-100. The source honours every value up to 100 and caps silently above it, so 100 is the published ceiling.

**Returns:** total (the source's own count), page, limit, last_page, has_more, page_beyond_last, relaxed (the source broadened a keyword with no exact match), filters echo, measured_at_utc, and listings[]: listing_id, title, subtitle, url, status, current_price with price_basis (current_bid / opening_bid on live lots; final_price, high_bid_not_sold or opening_bid_not_sold on closed ones), bid_count, is_sold (closed lots), reserve_price, ends_at (ISO-8601 UTC), ends_at_local (US Eastern, the zone the site shows), ends_at_zone_label, ends_at_offset_hours, starts_at, seconds_remaining, ended, location, city, state, distance_miles (with zip), seller_username, agency_name, seller_url, image_url and has_video.

**Example request body:**
```json
{
  "seller": "LSSD",
  "status": "completed"
}
```

### POST https://api.reefapi.com/municibid/v1/sellers — 3 credits
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.

**Parameters:**
- `state` (string, optional) — Only agencies in this state.
- `query` (string, optional) — Case-insensitive name fragment.
- `min_lots` (integer, optional) — Only agencies with at least this many live lots.

**Returns:** total, returned, state_count and sellers[] (most live lots first): seller_username, agency_name, state, state_name, region_id, active_lot_count, url.

**Example request body:**
```json
{
  "state": "PA"
}
```

### POST https://api.reefapi.com/municibid/v1/agency_lookup — 3 credits
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.

**Parameters:**
- `agency_name` (string, required) — Part of the public agency name, 2-120 characters, for example 'Lampeter' or 'Springfield Township'.
- `state` (string, optional) — Two-letter state to narrow common names.

**Returns:** agency_name, seller_username, city, county, state, active_auction_count, recent_sold_count, url, browse_url. The source returns its single best match.

**Example request body:**
```json
{
  "agency_name": "Lampeter"
}
```

### POST https://api.reefapi.com/municibid/v1/agencies — 3 credits
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).

**Parameters:**
- `state` (string, optional) — Only agencies in this state.
- `query` (string, optional) — Case-insensitive fragment of the agency name or username.
- `min_closed_lots` (integer, optional) — Only agencies with at least this many closed lots.
- `sort` (enum, optional, default "closed_lots") — Order of the directory. [one of: closed_lots, name]
- `page` (integer, optional, default 1) — One-based page.
- `limit` (integer, optional, default 100) — Agencies per page, 1-1000.

**Returns:** total_agencies, matched, page, limit, last_page, has_more, state_totals[] (state, name, region_id, closed_lot_count) and agencies[]: seller_username, agency_name, state, region_id, closed_lot_count, url.

**Example request body:**
```json
{
  "state": "NJ",
  "limit": 50
}
```

### POST https://api.reefapi.com/municibid/v1/categories — 3 credits
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.

**Parameters:**
- `flat` (boolean, optional, default false) — Return one flat list instead of a tree.
- `top_level_only` (boolean, optional, default false) — Only the 46 top-level categories.

**Returns:** top_level_count, total_count and categories[]: category_id, name (top level; sub-levels carry the source's slug — names via subcategories), slug, parent_id, level, active_lot_count (top level), url, children[].

**Example request body:**
```json
{
  "flat": false
}
```

### POST https://api.reefapi.com/municibid/v1/subcategories — 3 credits
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).

**Parameters:**
- `parent_id` (integer, required) — Category id from categories, for example 160883 (Automotive).

**Returns:** parent_id, total and subcategories[]: category_id, parent_id, name, active_lot_count, url.

**Example request body:**
```json
{
  "parent_id": 160883
}
```

### POST https://api.reefapi.com/municibid/v1/locations — 3 credits
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.

**Parameters:** none

**Returns:** live_states[] (state, name, region_id, active_lot_count, agency_count), live_lot_total, regions[] (state, name, region_id) and never_listed[].

### POST https://api.reefapi.com/municibid/v1/suggest — 3 credits
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.

**Parameters:**
- `query` (string, required) — Typed text, 2-100 characters.
- `limit` (integer, optional, default 9) — Suggestions to return; the site shows 9.

**Returns:** query, total, suggestions[]: kind (category / location / agency / listing_number), label, detail, active_lot_count, filter (the search parameter that reproduces it), url.

**Example request body:**
```json
{
  "query": "snow"
}
```

### POST https://api.reefapi.com/municibid/v1/map — 3 credits
Every live Municibid lot with coordinates — the data behind the site's map view. Optional state, agency or bounding-box filter.

**Parameters:**
- `state` (string, optional) — Only lots in this state.
- `seller` (string, optional) — Only one agency's lots.
- `min_lat` (number, optional) — Bounding box south edge.
- `max_lat` (number, optional) — Bounding box north edge.
- `min_lng` (number, optional) — Bounding box west edge.
- `max_lng` (number, optional) — Bounding box east edge.

**Returns:** source_total, total and lots[]: listing_id, title, url, current_price, price_basis, bid_count, ends_at, ends_at_local, seconds_remaining, location, city, state, latitude, longitude, seller_username, agency_name, image_url.

**Example request body:**
```json
{
  "state": "PA"
}
```

### POST https://api.reefapi.com/municibid/v1/sold_comps — 3 credits
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.

**Parameters:**
- `query` (string, optional) — Keyword text, 1-200 characters, matched by Municibid against lot titles and descriptions. When nothing matches exactly the source broadens the match itself and says so — returned as relaxed: true.
- `make` (string, optional) — Manufacturer, for example Ford, Mack, John Deere.
- `model` (string, optional) — Model, for example F-350.
- `year` (integer, optional) — Model year.
- `state` (string, optional) — Two-letter state of the selling agency, for example PA.
- `category` (string, optional) — Category NAME as Municibid writes it, for example Trucks, Dump Trucks, Tractors (names from categories / subcategories).
- `date_from` (string, optional) — Closed on or after, YYYY-MM-DD.
- `date_to` (string, optional) — Closed on or before, YYYY-MM-DD.
- `limit` (integer, optional, default 20) — Comparables to return, 1-50.

**Returns:** comp_count (all matches the source found), returned, generated_at and comps[]: listing_id, title, url, category, seller_name, city, state, sold_price, bid_count, closed_at (UTC), closed_at_local (US Eastern), closed_at_source, similarity_reason.

**Example request body:**
```json
{
  "query": "dump truck",
  "state": "PA",
  "limit": 20
}
```

### POST https://api.reefapi.com/municibid/v1/market_value — 3 credits
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.

**Parameters:**
- `query` (string, optional) — Keyword text, 1-200 characters, matched by Municibid against lot titles and descriptions. When nothing matches exactly the source broadens the match itself and says so — returned as relaxed: true.
- `listing_id` (string, optional) — Value this Municibid lot instead of a keyword.
- `make` (string, optional) — Manufacturer, for example Ford, Mack, John Deere.
- `model` (string, optional) — Model, for example F-350.
- `year` (integer, optional) — Model year.
- `state` (string, optional) — Two-letter state of the selling agency, for example PA.
- `category` (string, optional) — Category NAME as Municibid writes it, for example Trucks, Dump Trucks, Tractors (names from categories / subcategories).
- `lookback_months` (integer, optional, default 24) — How far back the comparables reach, 1-60 months.

**Returns:** estimate{low, median, high, currency, confidence, comp_count}, comps_used[] (listing_id, title, url, sold_price, closed_at, closed_at_local), notes[], disclaimer.

**Example request body:**
```json
{
  "query": "ford f-350"
}
```

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=municibid
- Human docs page: https://reefapi.com/docs/municibid
- Overview page: https://reefapi.com/municibid-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
