🏛️ SurplusLead AI — GovDeals, GSA & Public Surplus Auction Tracker

The ultimate multi-platform government liquidation auction tracker & deal sniper. Monitor live municipal, state, and federal auctions across GSA Auctions, GovDeals, and Public Surplus in real-time — with instant Discord & Telegram deal alert cards.

---

⚡ What Does SurplusLead AI Do?

SurplusLead AI is an automated intelligence engine built specifically for automotive flippers, heavy machinery brokers, IT refurbishers, and liquidation resellers.

Instead of spending hours manually refreshing clunky government portals across dozens of counties, SurplusLead AI queries live government auction systems in seconds:

1. Unified Multi-Platform Coverage: Aggregates active lots across GSA Auctions (Federal), GovDeals (Municipal), and Public Surplus (County & School Districts).
2. Instant Snipe Webhooks: Sends rich visual deal alert cards directly to your private Discord server or Telegram with lot photos, current bid, time left, and direct bid links.
3. Arbitrage Deal Scoring: Automatically classifies deals as HIGH_MARGIN_FLIP, SNIPE_ALERT, or GOOD_VALUE based on reserve status, bid counts, and closing deadlines.
4. Snipe Timing Triggers: Filter by Ending Soon (< 24 Hours) or Closing Window (< 6 Hours) to catch underpriced lots other bidders missed.
5. Reserve Transparency: Filter for Reserve Met Only lots so you know with 100% certainty the item will sell.
6. Location & State Filtering: Restrict searches to your home state (e.g. CA, TX, FL, NY) or radius for easy local trailer pickup.

---

💰 The Arbitrage Opportunity (Real Government Surplus Numbers)

Category	Typical Gov Surplus Winning Bid	Resale Market Value (Craigslist / eBay / FB)	Net Flip Profit
Police Cruisers (Ford Explorer / Dodge Charger)	$1,800 – $3,200	$6,000 – $9,500	+$4,200 – $6,300 🚀
City Work Trucks (Ford F-250 / Chevy 2500)	$2,500 – $5,000	$8,500 – $14,000	+$6,000 – $9,000 🚀
Heavy Equipment (Caterpillar Skid Steer / Forklift)	$4,500 – $8,000	$12,000 – $22,000	+$7,500 – $14,000 🚀
School District Tech (Pallet of 25x Apple MacBooks)	$2,500 – $4,000	$7,500 – $11,000	+$5,000 – $7,000 🚀
Police Seizures (Tools / Jewelry / Confiscations)	$400 – $900	$1,800 – $3,500	+$1,400 – $2,600 🚀

---

🚀 How It Works

graph TD
    A[Search Keyword / Category / State] --> B[SurplusLead Intelligence Engine]
    B --> C[GSA Auctions Federal API]
    B --> D[GovDeals Municipal Systems]
    B --> E[Public Surplus County Systems]
    C --> F[Deal Scoring & Arbitrage Classifier]
    D --> F
    E --> F
    F --> G{Alert Criteria Met?}
    G -->|Yes| H[Instant Discord Webhook / Telegram Ping]
    G -->|No| I[Clean Structured Dataset]
    H --> I
    I --> J[Apify Dataset: JSON / CSV / Excel]

---

📥 Input Configuration

Parameter	Type	Default	Description
searchKeyword	string	"truck"	Search term across item names, descriptions, and agencies.
auctionPlatform	select	"all"	All Government Auctions, GSA Federal, or Municipal / County Surplus.
category	select	"all"	Filter by Vehicles & Fleet, Heavy Machinery, Computers & Electronics, or Police Seizures & Jewelry.
stateFilter	string	""	Optional 2-letter state code (e.g. 'CA', 'TX', 'FL'). Blank for nationwide.
maxCurrentBid	integer	0	Max current bid ceiling in USD (e.g. 5000). 0 = no ceiling.
onlyEndingSoon	boolean	false	Only return auctions ending in < 24 hours (snipe opportunities).
onlyReserveMet	boolean	false	Only return lots where reserve is met (guaranteed to sell).
maxLots	integer	50	Maximum matching lots to extract (5 to 500).
discordWebhookUrl	string	""	Optional Discord Webhook URL for instant mobile/desktop deal alerts.
telegramBotToken	string	""	Optional Telegram Bot token for mobile alerts.
telegramChatId	string	""	Optional Telegram chat or channel ID.
proxyConfiguration	proxy	{"useApifyProxy": true}	Pre-configured Apify Proxy for fast, unblocked extraction.

---

📤 Output Dataset Example

{
  "lotId": "GSA-4-1-QSC-I-26-463-001",
  "title": "Hyster Commercial Forklift 5000lb Capacity",
  "platform": "GSA Auctions (Federal)",
  "category": "heavy_equipment",
  "currentBid": 2510.0,
  "bidIncrement": 10.0,
  "reserveMet": true,
  "biddersCount": 8,
  "closingDate": "2026-09-09",
  "timeRemainingHours": 4.5,
  "locationCity": "Davis",
  "locationState": "CA",
  "locationZip": "95616",
  "agencyName": "National Institute of Food and Agriculture",
  "auctionUrl": "https://www.gsaauctions.gov/auctions/preview/374892",
  "imageUrl": "https://www.ppms.gov/gw/auction/ppms/api/v1/auction/image/41QSCI26463001.jpg",
  "dealScore": "HIGH_MARGIN_FLIP",
  "arbitrageTags": [
    "Reserve Met (Will Sell)",
    "Ending Soon (< 24h)",
    "🚨 Snipe Window (< 6h)",
    "🔥 Active Bidding (8 Bidders)",
    "Budget Fleet Pick"
  ],
  "contactOfficer": "SINGCHENG (4155223022)",
  "scrapedAt": "2026-09-09T10:55:00Z"
}

---

🔔 Discord Webhook Card Preview

When an underpriced deal matches your criteria, you instantly receive a formatted embed in your Discord channel:

┌───────────────────────────────────────────────────────────────┐
│ 🏛️ SurplusLead AI • NEW LIQUIDATION DEAL FOUND                 │
│                                                               │
│ [ 2019 Dodge Charger Police Pursuit AWD (Low Mileage) ]       │
│                                                               │
│ 💰 Current Bid: $1,850.00     ⏳ Time Left: 3h 15m            │
│ 🏷️ Reserve: MET (Will Sell!)   🔨 Bids: 14 bidders             │
│ 📍 Location: Austin, TX        🏛️ Source: GSA Federal Surplus │
│ 🎯 Deal Score: HIGH_MARGIN_FLIP                               │
│                                                               │
│ [ 🖼️ High-Res Vehicle / Lot Photo Embedded Here ]              │
│                                                               │
│ 👉 [Click Here to View & Place Bid on Auction]               │
│                                                               │
│ SurplusLead AI • Government Liquidation & Auction Sniper      │
└───────────────────────────────────────────────────────────────┘

---

💰 Pricing & Economics

• Pricing Model: Pay-Per-Event (PPE)
• Platform Usage: Paid by user (isPPEPlatformUsagePaidByUser: true)
  • apify-actor-start: $0.002 (One-time run fee)
  • apify-default-dataset-item: $0.003 ($3.00 per 1,000 verified auction lots)
• Scheduled Monitoring:
  • Run this Actor on an Apify Schedule (every 1 hour or every 30 minutes) to receive automated 24/7 deal alerts whenever hot government surplus lots appear!