Telling Readers When a Favorite Is Back in Stock
When a product readers wanted comes back in stock, that is worth telling them. This guide shows where restock news helps, three ways to deliver it, how to read stock status in price history, and a demo that finds real restocks.
Some products readers want are hard to keep. They sell out, readers move on, and a few weeks later the product is quietly available again, with nobody telling the people who looked for it. This guide is about telling readers when a favorite is back in stock: where it helps, three ways to deliver the news, how to read stock status in the price history, and how to decide what counts as a restock. The demo below finds real restocks in 90 days of history, pulled November 17, 2026.
Where restock news helps
A restock is useful whenever a reader had to give up on a product the first time. It is a small piece of news, but it is specific, and it is usually welcome.
Notice that none of these needs a sale or a price drop. Availability by itself is the news.
Three ways to tell readers
How you deliver a restock depends on the page and the reader. Each of these is something you build on top of the data, and each suits a different kind of site.
Whichever you choose, say which store the product came back at. A restock at one store is not a restock everywhere.
Try it on real products
The demo shows ten real products, each with 90 days of stock status at a few of its stores. Choose how many days a product must have been out to count as a restock, switch on the recent-restocks filter, and open any product to see its timeline and a draft note. The code tab shows the request and the short function that finds the days a listing was out and the day it came back. The page holds a set of products that is rebuilt every night.
Notice how much the setting matters. At one day out, eight of the ten products have a return to report. At three days it is eight, and at seven days it is five. The longer the wait you require, the fewer restocks you report, and the more likely each one is to be news.
Reading stock status in the history
Each day in a product’s price history carries an availability status for each store listing. Three values appear, and they do not all mean what they first seem to.
The third one is easy to get wrong. A listing can show a stretch of days with no status, and treating those as sold out would invent restocks that never happened. In this demo’s ten products, 450 of the listing days had no status, and none of them is counted as out of stock.
Deciding what counts as a restock
A product that is out for a single day and back the next is more likely a data blip or a short pause than news. A few simple rules keep the note worth reading.
Our guide to wishlist APIs covers the sites where this matters most, and how price history helps a reader trust a deal covers the reader side of the same data.
What the November 17, 2026 pull shows
We looked at the demo’s ten products on November 17, 2026, across 36 store listings, counting a restock when a listing had been out for at least three days. Four came back in stock in the last three weeks, and eight came back at some point in the 90 days. The longest absence was Canon EOS R10 mirrorless camera at Best Buy, out for 21 days before it returned. Two never went out of stock at any of the listings checked.
This table is fixed to November 17, 2026. The demo above is rebuilt every night with a different set of products, so its figures will change. A handful of products is a small sample, and it says nothing about how often products in general go out of stock.
What 90 days can and cannot tell you
The history covers the last 90 days of daily statuses. That is enough to see when a listing went out and came back this quarter, and not enough to say how often a product sells out over a year. Stock status also comes from the store’s own listing, so a store can show a product as available that it cannot ship quickly. A product can also appear more than once at the same store, as separate listings, so the demo reports the store and not a single status for the product.
What the API provides, and what you build
The data shows what happened. Choosing which products to follow and when a restock is worth mentioning stays with you.
Getting started in three steps
Related ideas: tracking gift prices through the holiday season covers watching a short list over time, and showing readers a product’s lowest recent price covers the history request itself.
Planning something like this?
If you would like a second opinion on how to follow restocks for your own readers, our team is glad to talk it through. Schedule a call with our team.