Reverb Gear Price Alert Bot

Monitor Reverb.com for new music gear listings matching your criteria. Get instant Discord or email alerts when guitars, amps, pedals, synths, and more match your price and condition preferences.

What does it do?

This Actor watches Reverb.com for deals on music equipment. You define a watchlist of items you're looking for (e.g., "Fender Jazzmaster under $800"), and the bot:

1. Queries the Reverb API for each watchlist item
2. Compares results against previously seen listings (stored between runs)
3. Sends alerts for new listings and price drops via Discord webhook and/or email
4. Saves all alerts to the Apify dataset for review

Set it up on a schedule (e.g., every hour) and never miss a deal again.

How to use

1. Basic setup

Configure your watchlist with search queries and optional filters:

{
    "watchlist": [
        {
            "query": "Fender Jazzmaster",
            "maxPrice": 800,
            "condition": "all"
        },
        {
            "query": "Boss DD-500",
            "maxPrice": 200,
            "condition": "excellent"
        },
        {
            "query": "Fender Twin Reverb",
            "maxPrice": 900,
            "category": "amps"
        }
    ]
}

2. Discord alerts (recommended)

Get rich embeds in your Discord channel with listing details, photos, and direct links.

Setting up a Discord webhook:

1. Open your Discord server
2. Go to Server Settings > Integrations > Webhooks
3. Click New Webhook, name it (e.g., "Reverb Deals"), pick a channel
4. Copy the webhook URL
5. Paste it in the discordWebhookUrl input field

3. Email alerts

Enter your email address in the emailTo field to receive a summary email with all new matches. Requires the Actor to run on the Apify platform with a valid token.

4. Schedule it

For best results, schedule this Actor to run periodically:

• Every hour: Good for popular items with lots of new listings
• Every 4 hours: Balanced coverage for most gear
• Daily: Sufficient for niche or expensive items

In Apify Console: Actor page > Schedules tab > Create schedule

Watchlist item options

Each item in the watchlist supports these fields:

Field	Type	Required	Description
query	string	Yes	Search term (e.g., "Gibson Les Paul", "MXR Phase 90")
maxPrice	number	No	Maximum price in USD. Only alert for listings at or below this price.
minPrice	number	No	Minimum price in USD. Filter out listings below this price.
condition	string	No	Filter by condition: all, mint, excellent, very_good, good, fair, poor
category	string	No	Reverb category slug: electric-guitars, acoustic-guitars, bass, drums, keyboards-synths, amps, effects-pedals, etc.

Alert types

New Listing

Triggered when a listing appears that hasn't been seen in any previous run. The bot tracks seen listing IDs in a persistent Key-Value Store.

Price Drop

Triggered when a previously seen listing has a lower price than the last time it was checked. Shows both the current and previous price.

Input reference

Field	Type	Default	Description
watchlist	array	Required	List of watch items (see above)
discordWebhookUrl	string	-	Discord webhook URL for real-time alerts
emailTo	string	-	Email address for alert summaries
alertOnPriceDrop	boolean	true	Send alerts when existing listings drop in price
maxAlerts	integer	20	Max alerts per run (0 = unlimited)
maxListingsPerQuery	integer	50	Listings to check per query (1-100)
stateRetentionDays	integer	30	Days to remember seen listings before cleanup
proxyConfiguration	object	Apify Proxy	Proxy settings

Output

Each alert saved to the dataset contains:

{
    "alertType": "new_listing",
    "matchedQuery": "Fender Jazzmaster",
    "listingId": "12345678",
    "title": "2019 Fender Player Jazzmaster - Sunburst",
    "price": 649.99,
    "previousPrice": null,
    "priceDrop": null,
    "condition": "Excellent",
    "shopName": "Guitar Center Pro",
    "url": "https://reverb.com/item/12345678",
    "photo": "https://images.reverb.com/...",
    "publishedAt": "2026-03-20T10:00:00Z",
    "alertSentAt": "2026-03-20T10:15:00Z"
}

State persistence

The bot uses an Apify Key-Value Store (reverb-alert-state) to track which listings it has already seen. This persists between runs so you only get alerted once per new listing. Listings older than the stateRetentionDays setting (default: 30 days) are automatically cleaned up.

Tips

• Start broad, then refine: Begin with just a query and no price filter to see what's available, then add thresholds.
• Use categories: Adding a category filter reduces false positives (e.g., "Fender" without a category might match strings, picks, etc.).
• Multiple webhooks: Run separate Actor instances with different Discord webhooks to route alerts to different channels.
• Cost optimization: This Actor uses the Reverb public API (no browser needed), so it runs fast and cheap. A typical run with 5 watchlist items uses minimal compute.

Limitations

• The Reverb public API returns up to 100 listings per query. If you need deeper historical coverage, increase maxListingsPerQuery.
• Discord webhooks have a rate limit of ~30 messages per minute. The bot adds delays between messages to respect this.
• Email alerts require the Actor to run on the Apify platform with a valid APIFY_TOKEN.