OfferUp Listing Age Badge

WHAT IT DOES

This userscript transforms your OfferUp search results into a visual freshness dashboard. It reads each listing's posted date, calculates how many days have passed, and applies color-coded highlighting to every listing card. The color system uses a four-tier gradient: green for just posted (0-1 days), yellow for recent (2-3 days), orange for aging (4-7 days), and red for old (8+ days). Each listing displays a compact badge showing the exact age in days and a category label. Hovering over the badge shows the exact posting date. A summary panel shows total listings, average listing age, and counts by age category with percentages. A filter bar lets you show only listings in a specific age range. Each listing includes a one-click ↗ button to open the details page. This is invaluable for bargain hunters, resellers, and anyone looking for the freshest deals who wants to prioritize recent listings, avoid stale items, and make smarter purchasing decisions.

WHERE IT RUNS

The script runs on all OfferUp web application pages at *.offerup.com/*, with automatic detection of search results pages, category pages, and any page displaying listing cards. It works across all OfferUp interfaces by using multiple selector strategies to find listing rows, posted dates, titles, prices, and links. The script detects dynamic content loading and re-applies age highlighting when the listing list updates, including after filtering, sorting, or pagination. It runs across the entire OfferUp domain, ensuring coverage whether you're viewing the main feed, a specific category, or search results.

HOW TO USE

Install the script via the BotGentz extension and navigate to any OfferUp search results or category page. Age highlighting will apply automatically to every listing card. Each listing gets a subtle background tint and a colored left border matching its age category, along with a badge on the listing title showing the exact age and label. Hover over the badge to see the exact posting date. The summary panel appears above your listing list showing total listings, average listing age, and a breakdown by age category with counts and percentages. The filter bar appears as a sticky row with buttons for each category—click any button to show only listings in that category. Click the ↗ button next to any listing to open its details page in a new tab. Use the panel controls to toggle highlighting on or off, show or hide the summary panel, enable or disable the filter bar, or toggle the exact date on hover. You can customize the day thresholds for each color category. The "Refresh" button manually reapplies all highlighting if the page updates.

THE MECHANISM - DATE PARSING, AGE CALCULATION, AND VISUAL PRIORITIZATION

This script identifies listing age by scanning each listing card for posted dates. It uses a cascading selector strategy that looks for OfferUp's date elements including .posted-date, .listing-date, .date-posted, .post-date, and data attributes. When relative time strings are found ("2 days ago," "3 hours ago," "1 week ago"), the script parses them into absolute timestamps by subtracting the time from the current moment. For absolute timestamps, it converts them to Date objects directly. The age is calculated as the difference between the current time and the listing date, expressed in days. This age is then mapped to a color category using the user-defined thresholds. The highlighting is applied via inline styles on each listing card (background and border-left) that override OfferUp's default styling. The badge is inserted into the listing title element using DOM manipulation. For the summary, the script counts listings in each category and calculates percentage distributions. The filter bar uses display toggling to show or hide listings based on their age category.

THE PANEL

The control panel appears as a floating, draggable element that you can position anywhere on the OfferUp page. Drag by the header to reposition it, and the position is saved per site using GM_setValue so it stays where you left it across sessions. Release the panel near any edge and it snaps into place, keeping your workspace organized. Click the panel header to collapse it into a small bubble showing only the chart emoji (📊), minimizing distraction while keeping controls accessible. Drag from the bubble to restore the full panel. The panel automatically resizes to fit its content and includes all setting toggles, threshold controls, action buttons, and a color legend. Press the Escape key to quickly collapse the panel to its minimized state. The panel remains visible across page navigation within OfferUp, with age highlighting updating automatically as you move between categories and search results.

PLEASE NOTE

This script requires the free BotGentz extension to function. It is designed for OfferUp users who need to prioritize fresh listings and find the best deals. The script reads only visible listing data from the DOM—it does not access OfferUp's API, your account credentials, or any sensitive information. All settings (threshold values, toggle states, and panel position) are stored locally using GM_setValue and never leave your browser. The script does not modify your OfferUp data—it only enhances the visual presentation of the listing list. Age calculations are based on your system's current time and the dates visible on the page; if OfferUp updates its website structure, the script may need to be updated to match new selectors. The filter bar works on all listings currently visible in the list; if the list is paginated, the filter applies only to the current page. Listings without a visible posted date are not highlighted.