# How to export Steam wishlist data and analyze it

> Three ways to get Steam wishlist data out of Steamworks: the CSV download, the GetAppWishlistReporting Web API and a daily sync tool, and how to analyze each.

By Yos Riady. Updated 2026-11-19. Published 2026-11-18. Canonical URL: https://manalens.dev/blog/export-steam-wishlist-data

Export Steam wishlist data in 3 ways: download the CSV from the Steamworks wishlist report, call GetAppWishlistReporting in Valve's Financial Web API, or sync it daily with a tool. The API returns adds, deletes, purchases and gifts for one app and one GMT day (Steamworks documentation). Data is complete up to the day before.

## Key points

- Steam wishlist data can be exported as a CSV from the wishlist report, through the GetAppWishlistReporting Web API, or with a daily sync tool.
- GetAppWishlistReporting needs a Financial API Group key, an app ID and a GMT date, and returns adds, deletes, purchases and gifts.
- The Steam wishlist report and API have no source column, so only the UTM Analytics report splits wishlists by source.

## Where is my wishlist data in Steamworks?

It is in the Sales & Activation Reports portal. Open your app's details page and find the Wishlists section. Valve says the report tracks additions, purchases and deletions by users that have your game on their wishlist.

The data is updated daily for the previous date. On March 2, you see all the data up to March 1. Never compare today with yesterday, because today is not in the report yet.

Two more views sit next to the main report. The Regional sales report shows wishlists by region or country. The platform-specific wishlisting section shows the platform that players set in their Steam preferences. Valve notes that this is almost always a subset of total wishlists, because not every player sets a platform.

Sources: Steamworks Wishlists documentation; Steamworks Wishlist Reporting documentation.

## Which export method should I use?

Use the CSV for a one-time look, the API for automation, and a sync tool when you want the numbers next to your other marketing data without code. All three read the same Valve data, so the totals should agree when the days line up.

| Method | What you get | Good for | Limits |
| --- | --- | --- | --- |
| CSV download from the wishlist report | Wishlist actions per day, plus cohort columns such as DateLocal and MonthCohort | A one-time analysis in a spreadsheet | Manual, one file at a time |
| GetAppWishlistReporting (Web API) | Adds, deletes, purchases and gifts for one app and one day, with country and language totals | Scripts, a data warehouse, daily jobs | Needs a Financial API key and one call per app per day |
| Daily sync in Manalens (Early access) | All wishlist adds, deletes, purchases and gifts per day and country, plus sales | A chart next to UTM, website and game data | The first sync reads the last 90 days. Check the first totals against Steamworks |

Sources: Steamworks Wishlist Reporting documentation; Steamworks IPartnerFinancialsService documentation; Manalens Steam documentation.

## What do the CSV columns mean?

Valve defines two columns in its documentation. DateLocal is the date, in Pacific time, that the game was purchased from the wishlist. MonthCohort is the month in which the user added the game to their wishlist. For example, 2021-08-01 means the users who wishlisted the game in August 2021.

MonthCohort is the key to a cohort analysis. It lets you ask how many people who wishlisted in a given month bought the game later. That answers questions such as whether old wishlists still convert. Our guide on wishlist age shows how to read it.

Valve does not publish a full list of every column. Open the file and check the header row before you build formulas on it.

Sources: Steamworks Wishlist Reporting documentation.

## How do I export wishlist data with the Steam Web API?

Call GetAppWishlistReporting on the partner host with a publisher key that has Financial permissions. The call takes three parameters: key, appid and date. The date is GMT bounded and can be written as YYYY-MM-DD, YYYY/MM/DD or YYYYMMDD.

The response holds wishlist_adds, wishlist_deletes, wishlist_purchases and wishlist_gifts for the day. It also has a country_summary and a language_summary with totals per country and per language, and adds per platform in wishlist_adds_windows, wishlist_adds_mac and wishlist_adds_linux. If you ask for a date outside the range of the app, only app_min_date comes back. Use it to find the first day with data.

1. In Steamworks, open Users & Permissions, then Manage Groups, and create a Financial API Group. Copy the Web API key from the group page.
2. Allow only trusted IP addresses for the key, as Valve recommends. The key can read every app on your partner account.
3. Send a GET request to partner.steam-api.com/IPartnerFinancialsService/GetAppWishlistReporting/v001/ with key, appid and date.
4. Store one row per app and day. Save the country and language totals in a second table.
5. Run the job once a day for the day before. Run it again for older days if you need history, starting at app_min_date.

Sources: Steamworks IPartnerFinancialsService documentation.

## How do I analyze the exported data?

Start with four numbers per day: adds, deletes, net adds (adds minus deletes) and purchases from the wishlist. Then sum them by week. Weekly sums hide the noise of single days.

Next, mark your marketing beats on the same timeline. A trailer, a festival, a creator video or a sale on a similar game often explains a spike. Write the date of each beat in a log so you can match it later.

Then compare deletes with adds over the same period, and look at the country totals. A new country in the top five after a creator video often tells you whose audience it was.

- Velocity: net adds per week, the input for the wishlist velocity calculator.
- Delete share: deletes divided by adds in the same period.
- Wishlist balance: the running sum of adds minus deletes, purchases and gifts.
- Country mix: the share of adds from each country, week by week.
- Beat lift: net adds in the 7 days after a beat minus a normal week.

Sources: Steamworks IPartnerFinancialsService documentation; Steamworks Wishlist Reporting documentation.

## Why do my exported numbers not match other reports?

Usually because of time zones and timing. API wishlist days are GMT bounded. DateLocal in the CSV is Pacific time. Steam sales data is also in Pacific time. A purchase late in the evening in California can land on different days in two reports.

The UTM Analytics report is a different count again. It shows only wishlists that came within 72 hours of a tracked visit on a tagged link, and its conversions are final 4 days after the visit. So UTM wishlists are always a part of all wishlist adds, often a small part.

Sources: Steamworks IPartnerFinancialsService documentation; Steamworks Wishlist Reporting documentation; Steamworks UTM Analytics documentation.

## Can I export wishlist data by traffic source?

Only for tagged links. The wishlist report and the API have no source column. The UTM Analytics report shows wishlists per UTM combination, and you can download it as a CSV from the report. Steam hides rows with few visits, so the export never covers all sources.

Sources: Steamworks UTM Analytics documentation.

## How do I skip the spreadsheet work?

Manalens is the analytics and growth engine built for games. Connect a Steamworks Financial API key (the automatic Steam sync is in early access) and Manalens syncs all wishlist adds, deletes, purchases and gifts per day and country, plus units sold and net sales. The Steam page charts adds, deletes, net and wishlist purchases by day, and shows UTM wishlists as a share of all adds.

- [Wishlist velocity calculator](https://manalens.dev/tools/wishlist-velocity-calculator)

Sources: Manalens product documentation.

## Frequently asked questions

### Can I download Steam wishlist data as a CSV?

Yes. The Wishlists section of your app in the Sales & Activation Reports portal has a CSV download. Valve documents the DateLocal column, in Pacific time, and the MonthCohort column, the month in which players added the game. Check the header row, because Valve does not list every column.

### Which Steam API returns wishlist data?

GetAppWishlistReporting in IPartnerFinancialsService. It needs a publisher key from a Financial API Group, an app ID and a date. It returns adds, deletes, purchases and gifts for that GMT day, with totals per country and per language, and adds per platform for Windows, Mac and Linux.

### How far back can I export wishlist data?

The API returns app_min_date when you ask for a date outside the range of your app, so you can find the first day with data. The automatic Steam sync is in early access: Manalens reads the last 90 days on the first sync, then syncs once a day when the daily sync is on.

### Does the wishlist export show where wishlists came from?

No. The wishlist report and the API have no source column. Only the UTM Analytics report splits wishlists by source, and only for visits on tagged links by players signed in to Steam. Steam also hides UTM combinations with few visits, so that export is never complete.

## Sources

- [Steamworks documentation: Wishlist Reporting (Valve, read 18 November 2026)](https://partner.steamgames.com/doc/marketing/wishlist/reporting)
- [Steamworks documentation: IPartnerFinancialsService (Valve, read 18 November 2026)](https://partner.steamgames.com/doc/webapi/IPartnerFinancialsService)
- [Steamworks documentation: Wishlists (Valve, read 18 November 2026)](https://partner.steamgames.com/doc/marketing/wishlist)
- [Steamworks documentation: UTM Analytics (Valve, read 18 November 2026)](https://partner.steamgames.com/doc/marketing/utm_analytics)

## Related guides

- [Game marketing measurement guide](https://manalens.dev/blog/game-marketing-measurement-guide)
- [How to read Steamworks wishlist and traffic reports](https://manalens.dev/blog/read-steamworks-wishlist-traffic-reports)
- [Do Steam wishlists get old?](https://manalens.dev/blog/do-steam-wishlists-get-old)
- [Steam traffic sources explained](https://manalens.dev/blog/steam-traffic-sources)
- [Wishlist velocity calculator](https://manalens.dev/tools/wishlist-velocity-calculator)
- [Steam wishlist guides](https://manalens.dev/blog/topic/steam-wishlists)
- [Road to 10,000 Steam wishlists: a step by step plan with checkpoints](https://manalens.dev/blog/road-to-10000-steam-wishlists)
- [How many wishlists a day is good? Wishlist velocity benchmarks](https://manalens.dev/blog/steam-wishlists-per-day)
- [How many Steam wishlists do you need before launch? Benchmarks by price and genre](https://manalens.dev/blog/how-many-steam-wishlists-before-launch)
- [Why did my Steam traffic drop? How to find the cause](https://manalens.dev/blog/why-did-my-steam-traffic-drop)
