# Postedlist

Postedlist hosts wholesale price lists at https://postedlist.com
so purchasing agents and humans can read the same catalog.

Postedlist is not the seller. Prices, stock, and lead times are
indicative until the seller accepts a request.

## For agents

- Directory: GET https://postedlist.com/api/catalogs
- Search: GET https://postedlist.com/api/search?q=&trade=&area=
- One catalog: GET https://postedlist.com/c/{slug}/offer.json
- Human index: https://postedlist.com/find
- Example slice: https://postedlist.com/find/electrical/san-diego-county
- This file: https://postedlist.com/llms.txt

Trade values to prefer: Electrical, Plumbing, HVAC, Building materials, Roofing.
Area is a metro or county (example: San Diego County), not a street address.

Each offer.json lists seller, trade, area, leadTimeDays, currency USD,
updatedAt, and items[] with sku, name, unit, price, minQty, notes.
Quote inboxes are not public.

## Request a quote

POST https://postedlist.com/api/quotes
Content-Type: application/json

{
  "slug": "mesa-electric",
  "seller": "Mesa Electric",
  "name": "Buyer name",
  "email": "buyer@example.com",
  "sku": "EL-220",
  "qty": 10,
  "notes": "Jobsite notes"
}

qty must be an integer and at least the item minQty.
SKU must exist on that seller catalog.
No API key. Do not flood; one request per needed SKU is enough.

## For sellers

Post a CSV or text PDF at https://postedlist.com/post
No account. First 14 days free, then $49/mo keeps the public URL live.
The seller receives a manage link by email. Do not publish that link.

## Demos

Mesa Electric, Harbor Plumbing, Lakeside Electric, and Pacific Air Supply
are practice catalogs. Treat them as examples, not live yards.