Municibid API

Municipal surplus auctions from 5,031 US agencies — live lots, every bid, and what things sold for

fields per listing
21
endpoints
19
credits per call
3

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.

POST/municibid/v1/search
Real result, captured Nov 17, 20263 of 24
titlecurrent_pricestatusbid_count
smaller truck toolbox50active0
2004 Ford Ranger 4X4 Truck6600active3
2003 MACK DUMP TRUCK13,100active35
19 active endpoints. Every call is 3 credits.search · sold · detail · bids · questions · live+13 more ↓OpenAPI 3.0 spec ↗

3 credits per call≈ $3/1,000 calls1,000 free credits, no card

Get a free API key
Try it live

Run the call yourself, on the real endpoint

Change a parameter and press Try it. The response on the right is what your code will receive.

Municibid API

5 of 19 endpoints, ready to run

View docs ↗

Live lots, closing first

3 credits0 required · 4 optional
POST/municibid/v1/search
ok822 ms · 24 records · sample
{
  "ok": true,
  "meta": {
    "api": "municibid",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 822.4,
    "record_count": 24,
    "cache_hit": false
  },
  "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:54:57Z",
    "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": 86582,
        "ended": false,
        "location": "Oakham, MA",
        "city": "Oakham",
        "state": "MA",
        "distance_miles": null,
        "seller_username": "OakhamHighway",
        "agency_name": "Town of Oakham Highway Department",
        "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": 86702,
        "ended": false,
        "location": "Waynesboro, PA",
        "city": "Waynesboro",
        "state": "PA",
        "distance_miles": null,
        "seller_username": "QuincyTwp",
        "agency_name": "Quincy Township",
        "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": 93902,
        "ended": false,
        "location": "Greensburg, PA",
        "city": "Greensburg",
        "state": "PA",
        "distance_miles": null,
        "seller_username": "hempfield",
        "agency_name": "Hempfield Township",
        "image_url": "https://storagemunicibidpro.blob.core.windows.net/assets/media/92702674-378d-2251-1f37-875853e63a67_thumbcrop.jpg",
        "has_video": false
      }
    ]
  }
}
Real response, fetched from the live endpoint with the parameters on the left — trimmed to the first few rows. Press Try it for the untrimmed response.

Try every endpoint in the playground

Endpoints

What Municibid endpoints does ReefAPI ship?

19 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.

  • search

    3 cr

    Search LIVE Municibid lots.

    required
    —
    optional
    query, category_id, state, seller, zip, radius_miles, min_price, max_price, sort, page, limit
  • sold

    3 cr

    Search CLOSED Municibid lots with the final price.

    required
    —
    optional
    query, category_id, state, seller, zip, radius_miles, min_price, max_price, sort, page, limit
  • detail

    3 cr

    One Municibid lot in full, live or closed.

    required
    listing_id
    optional
    —
  • bids

    3 cr

    The complete public bid log of one lot, live or closed.

    required
    listing_id
    optional
    —
  • questions

    3 cr

    The public question-and-answer thread of one lot.

    required
    listing_id
    optional
    —
  • live

    3 cr

    The live bid box of one lot, the same small call the lot page polls.

    required
    listing_id
    optional
    —
  • similar

    3 cr

    The live lots Municibid itself shows under 'Related Auctions You Might Be Interested In' on a…

    required
    listing_id
    optional
    —
  • seller

    3 cr

    Public profile of one selling agency.

    required
    seller
    optional
    —
  • seller_listings

    3 cr

    Every lot of one agency, live or closed, paginated.

    required
    seller
    optional
    status, sort, page, limit
  • sellers

    3 cr

    Directory of the agencies with lots live right now, grouped by state, each with its live lot…

    required
    —
    optional
    state, query, min_lots
  • agency_lookup

    3 cr

    Find a Municibid agency by part of its name and get its username, location, live lot count an…

    required
    agency_name
    optional
    state
  • agencies

    3 cr

    The full directory of every agency that has ever sold on Municibid.

    required
    —
    optional
    state, query, min_closed_lots, sort, page, limit
  • categories

    3 cr

    Municibid's whole category tree.

    required
    —
    optional
    flat, top_level_only
  • subcategories

    3 cr

    The named sub-categories of one category with their live lot counts, read from the category p…

    required
    parent_id
    optional
    —
  • locations

    3 cr

    Every state and agency with lots live right now and its live count, plus the full list of 49…

    required
    —
    optional
    —
  • suggest

    3 cr

    What the site's own search box suggests while typing.

    required
    query
    optional
    limit
  • map

    3 cr

    Every live Municibid lot with coordinates.

    required
    —
    optional
    state, seller, min_lat, max_lat, min_lng, max_lng
  • sold_comps

    3 cr

    Sold-only comparables.

    required
    —
    optional
    query, make, model, year, state, category, date_from, date_to, limit
  • market_value

    3 cr

    A low / median / high value range for an item from Municibid's own sold comparables (default…

    required
    —
    optional
    query, listing_id, make, model, year, state, category, lookback_months

Every parameter, every allowed value →

Missing a Municibid endpoint, or need a source we don't have yet?Contact us real people · same-day reply.
How it works

How the Municibid API works

Municibid is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.

Authenticate01
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 694 engines.

Call02
POST /municibid/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

Pay03
3 credits per call

Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.

Read04
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

Recipe

Price a township plow truck before you bid

Find what is closing, read the lot in full, then check what the same truck sold for.

01search?query=plow%20truck&state=PA&sort=ending_soonest
POSTsearch?query=plow%20truck&state=PA&sort=ending_soonest

Keep a listing_id; ends_at is already UTC.

02detail?listing_id=86276004
POSTdetail?listing_id=86276004

Opening bid, increment, minimum next bid, buyer's fee, pickup address, photos, payment terms.

03sold_comps?query=dump%20truck&state=PA&date_from=2026-01-01
POSTsold_comps?query=dump%20truck&state=PA&date_from=2026-01-01

Only lots that sold, with the sold price and close date.

04market_value?query=dump%20truck&state=PA
POSTmarket_value?query=dump%20truck&state=PA

Low / median / high from Municibid's own sales.

A live lot, the second it closes, what the next bid has to be, and a sold-price range for the same thing.

request
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}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "municibid",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}
Fields

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.

FieldWhat it holds
current_price + price_basiscurrent_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_soldOnly 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_localends_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_bidThe step and the next acceptable bid, from Municibid's live bid box. min_next_bid is null once a lot has closed.
buyer_premium_tiersThe 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[].bidderBidder handles exactly as Municibid publishes them, already masked (h****p).
seller_username + agency_nameThe agency's Municibid username — the value every agency filter takes — and its public name (Lampeter-Strasburg School District Building Services → LSSD).
relaxedtrue 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.

Coverage

Measured coverage

Live calls on 2026-11-17 (see the engine log); field-by-field check against 8 Municibid lot pages: 120 of 120 values identical.

Live lots

519: Pennsylvania 352, Massachusetts 61, New Jersey 56, Illinois 12, Indiana 9, New Hampshire 8, Michigan 6, Connecticut 4, New York 3 and six more states. Automotive 161, General Equipment 44, Heavy Equipment 28, Kitchen Equipment 27, Computers & IT 26, Landscaping 24, Police & Fire 21, Snow Removal 20.

Closed lots

118,726 reachable, back to 2019, each with is_sold and the final price. "dump truck" in Pennsylvania 1,639; Automotive 32,961; within 20 miles of Boston 4,315.

Sold comparables

Sold-only, by make, model, year, state and close date: Ford F-350 174 sales; dump trucks in Pennsylvania 435. Value range for a Ford F-350: $3,525 / $6,400 / $12,275 (50 sales, confidence high).

Agencies

5,031 agencies that have ever sold, in 47 states, Washington DC and Ontario, with closed-lot counts; 216 with lots live right now.

Bid logs

Complete: 89 of 89 bids on a live lot, 60 of 60 on a 2024 lot. Handles masked by Municibid.

Categories

46 top-level categories and 145 nodes in all, with live counts; sub-categories by name (Automotive: Buses, Cars, Heavy Duty Trucks, Motorcycles, Parts, SUV, Trailers, Trucks, UTVs/Carts, Vans).

Page shape

1 to 100 rows per page (Municibid's ceiling). Past the last page Municibid returns zero rows and the response says page_beyond_last.

Not published

No sold-only filter on Municibid's own closed search (use sold_comps), no lot condition grade, no shipping prices — most lots are pickup only.

Account-only

Bidding, buy-now, watchlist, followed agencies, whether you are winning, invoices, payment and asking questions.

Use cases

What people build with Municibid

The jobs this data is most often used for.

01

Alerts on municipal plow trucks, dump trucks, mowers and police vehicles by state, agency and price before they close.

02

Sold-price comparables for public-sector fleet: final prices, bid counts and close dates by make, model and year.

03

Pricing a lot before bidding with a low / median / high range from Municibid's own sales.

04

Dealer sourcing across Pennsylvania, New Jersey and Massachusetts townships and school districts by ZIP and radius.

19

endpoints

3

credits per call

Pricing

What Municibid data costs

The cheapest call here is 3 credits, so $15/mo (Pro) buys 3,333 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.

$0.67–$1.50 / 1,000 credits
Full pricing →
  • 1,000 free credits on signup, no card
  • One key, all 694 APIs, one credit pool
  • Failed and blocked calls are never charged
  • Credits roll over and never expire
no credit card1,000 free credits · instant API key · pay by card or crypto
Quickstart

Call it in two lines

Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.

curl
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}'
python
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"])
FAQ

Have a question? We got answers.

The questions people actually ask before wiring up Municibid.

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.

Contact

Need something this API does not do?

Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.

0/4000

No account needed · we reply from [email protected]

Try it on your own data before you pay anything

The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 693 APIs, and the same envelope everywhere.

Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-11-17.