新功能：Steamworks 願望清單資料 API

1660121

以程式存取遊戲願望清單資料

2025 年夏季，我們推出了以程式存取銷售資料的功能。 今天，我們透過新的願望清單資料 API 拓展這項功能，供各位存取自己在 Steam 上的所有遊戲的願望清單指標。 更多資訊請見下文，或前往 GetAppWishlistReporting 文獻深入了解。

API 說明

願望清單資料 API 使用與銷售資料 API 相同的財務權限系統，因此可以輕鬆整合到既有的分析流程中。

除了提供整體願望清單總數和國家 / 地區層級的細分資料外，此 API 還首次引入了依語言劃分的願望清單總數，從而可以對在地化和地區表現進行更細緻的分析。

權限

IPartnerFinancials API 需要使用財務 API 群組。有關設定財務 API 群組 Web API 金鑰的說明，請見此處。 財務 API 群組可以存取合作夥伴帳戶中所有的應用程式，並且不能像一般合作夥伴群組那樣限定至單一應用程式。

請求與回應

GetAppWishListReporting 會以單一日期中單一 AppID 的方式呼叫，並傳回該日期所有的願望清單資料。 詳細文獻，包括資料型別、錯誤回應和預期結果形式，可以在此處找到。

範例呼叫：

GET https://partner.steam-api.com/IP ... -03-01&appid=123456

更新頻率

資料會定期更新，通常在使用者將項目加入願望清單後的幾小時內更新。 在商店活動繁忙期間（例如大型季節性特賣），更新頻率可能會較慢。

歷史資料在發佈後罕有調整。 大多數情況下，在當天結束後幾個小時查詢該日期，將傳回最終值。 重複查詢已完成的日期是不必要的，並且可能觸發速率限制。 重複請求過多可能會導致 Web API 金鑰受到限制。

若希望對此 API 或 Steamworks 中其它分析功能分享任何意見回饋，請告訴我們！

- Steam 團隊