Data & Methodology
Exactly where every number comes from — what is real, unmodified Etsy data, and what we compute as an estimate.
Rankkw uses only the official Etsy Open API v3. No scraping, no unofficial endpoints, no third-party data proxies. Some fields are shown exactly as Etsy returns them; other figures are estimates we derive from that data — and we always label them as such.
Straight from the Etsy API
These fields are returned by the official API and shown unmodified.
Metrics we compute
Everything below is calculated from the real Etsy fields above — no invented coefficients, no modelled curves. Where a figure is an estimate rather than a measurement, it says so in the app itself.
A 0–100 estimate combining two real measurements: the true total of competing live listings, and how strongly the incumbents convert views into favorites. Labelled an estimate everywhere it appears.
A plain ratio of two real Etsy fields — num_favorers ÷ views — across the listings ranking for a keyword. It is a save rate, not a click-through rate; Etsy exposes no click data.
A calendar-month histogram built from each listing’s real creation timestamp. It shows when sellers list, which is not the same as when buyers search — and we say so wherever it appears.
A 0–100 relative index over real inputs: how many sampled live listings carry a tag, weighted by those listings’ engagement. An index, never a search volume.
A band over the real count of active listings for that exact keyword, from its own live Etsy search.
Etsy publishes only a lifetime sales total. We snapshot it daily and difference consecutive days. Before two days of history exist we show “tracking started” — never a zero.
What we deliberately don’t show
Etsy publishes no search volume, no click data and no history. Rather than estimate those into existence, Rankkw leaves them out and tells you why. A missing number is honest; a plausible one that happens to be wrong is the thing that costs you money.
The Etsy Open API exposes no search-volume data of any kind. We previously derived a figure from listing views; it is gone. Real Google search volume appears instead when Google Ads is connected.
Etsy publishes no click data for listings you don’t own. Any CTR figure would be a guess.
No search history exists in the API. We show real Google monthly volume when available, and otherwise when competing listings were created — labelled as seller behaviour, not buyer demand.
Listings expose quantity (stock on hand), never units sold. Sales are published per shop only, so they cannot be attributed to a keyword or a single listing.
Buyer country appears only on your own order receipts, under your own OAuth consent. There is no public equivalent for a competitor.
No public endpoint exists for page visits or traffic sources.
The fields exist in the API but return null on every public search result we have tested. The panel stays hidden rather than showing an empty chart.
Google data (optional)
When a Google Ads account is connected, real Google monthly search volume and country breakdowns come from Google's official Keyword Planner API — attributed to Google, never presented as Etsy data. If Google isn't connected, these fields simply don't appear.
Freshness & caching
To respect Etsy's API Terms, cached Etsy content is always refreshed well inside Etsy's limits: everything we show from Etsy is less than 6 hours old (Etsy allows 6 hours for listings and 24 hours for other content). Every figure you see as a current number is fetched live from Etsy, never served from an expired cache.
We also send no more than 8 requests per second to Etsy, under their published ceiling, and back off automatically if Etsy ever asks us to slow down. All calls go to the officialopenapi.etsy.comendpoints. We do not scrape Etsy, and we use no third-party Etsy data resellers.
Historical tracking, and why it's different from caching
Etsy's API returns state, not history: a shop's lifetime sales total, today's price, today's tags. There is no historical endpoint. So the only honest way to answer “how many did they sell last week?” is to record the number once a day, going forward, and subtract.
That is not caching, and we're careful about the difference. A cache re-serves Etsy's content as though it were current; we never do that. A snapshot is a dated measurement, always presented as history and always labelled with the date it was taken. Until two days of history exist for a shop, we show “tracking started” rather than a misleading zero.
Snapshots hold only shop-level numbers (lifetime sales, favorites, reviews, active listings), never listing titles, tags or prices. They are kept for 90 days, the longest range our sales history shows, and are deleted automatically by the database after that. Sellers can stop tracking a shop at any time.
Attribution
The term “Etsy” is a trademark of Etsy, Inc. This application uses the Etsy API but is not endorsed or certified by Etsy, Inc.