eBay Sold Listing Price Overlay

WHAT IT DOES

This script adds sold price overlays to eBay search results, making it easy to see what items actually sold for. When you search on eBay, the script scans each listing for "Sold" indicators, extracts the sold price, and displays a prominent green badge on each sold listing showing the price. If both the sold price and the original listing price are available, the overlay shows both for easy comparison (e.g., "Sold: $45.00 (was $59.99)"). Non-sold listings that have ended show a red "ENDED" badge. A filter option lets you show only sold listings, hiding all unsold results. The overlays update dynamically as you scroll or load more listings.

WHERE IT RUNS

The script runs on eBay pages (*.ebay.com). It works on search results pages, category pages, and listing grids. It supports both desktop and mobile views.

HOW TO USE

After installation, the settings panel appears on the left side of the screen with the gear emoji (⚙️). Open the panel to configure the script:

- The "Show sold overlays" toggle enables or disables the overlays.

- Toggle "Show only sold listings" to filter the search results to show only sold items.

- Click "Refresh listings" to manually re-scan the current page.

The overlays appear automatically on search results. Sold listings show a green "SOLD" badge and a price overlay in the top-right corner of the listing.

TECHNICAL SECTION — REAL MECHANISM

The script detects eBay search pages by checking the URL for /sch/, /b/, _nkw=, or _sop=. It finds listing containers using selectors like .s-item, .srp-item, .list-item, .result-item, and .gallery-item. For each listing, it checks for sold indicators using selectors like .s-item__status, .sold, .sold-badge, and [aria-label*="Sold"]. The sold price is extracted from .s-item__price, .price, or .listing-price elements using regex. If multiple prices are found, the script attempts to distinguish between the sold price and the original price. A green overlay badge is created using style properties and textContent (never innerHTML), positioned absolutely in the top-right corner of the listing. The "Show only sold" filter hides non-sold listings using display:none and removes their space from the layout. A WeakSet tracks processed listings to avoid duplicate work. A MutationObserver watches for DOM changes and processes new listings as they load via infinite scroll.

THE PANEL

The settings panel is built with BotGentz's BGPanel component. It is draggable via its header, allowing you to reposition it anywhere on the screen. The panel snaps to the left edge by default but can be moved freely. Click the gear emoji to collapse the panel into a small bubble, and click the bubble to expand it again. The panel remembers its position per page session. Press the Escape key to quickly close or minimize the panel. The panel includes a status flash bar that provides visual feedback when settings are changed or actions are performed. All settings save automatically via GM_setValue.

PLEASE NOTE

This script requires the free BotGentz browser extension to run. It does not function as a standalone Chrome extension and does not use chrome.* APIs. eBay frequently updates its search results page structure, which may affect the selectors used to find listings and prices. If the overlays stop appearing, please check for script updates. The script works best on eBay's search results pages—it may not work on other eBay pages like watch lists or feedback pages. The script stores only your preferences via GM_setValue. No data is sent externally—all data is stored locally in your browser. The script never reads or writes password fields, hidden inputs, or file inputs. All DOM operations use safe methods (style properties, textContent, appendChild) and never use innerHTML.