Display item catalog in your application
To display items in the in-game store, use the following SDK methods:
Notice
Methods that return a paginated list of items are limited to a maximum of 50 items per response. To get more items, use the
limit and offset parameters and fetch more pages. For example, when calling a method with limit: 25 and offset: 100, the response returns 25 items starting from the 101st item in the overall list.
| SDK method name | Description |
|---|---|
GetPaginatedItems | Returns a list of virtual items according to pagination settings. The list includes items for which display in the store is enabled in settings. For each virtual item, complete data is returned. |
GetItems | Returns a full list of virtual items. The list includes items for which display in the store is enabled in settings. For each virtual item, complete data is returned. |
GetItemGroups | Returns a full list of virtual item groups. The list includes groups for which display in the store is enabled in settings. |
GetPaginatedGroupItems | Returns a list of items for the specified group according to pagination settings. The list includes items for which display in the store is enabled in settings. Display in the store must be enabled in the settings for the group. |
GetGroupItems | Returns a full list of items for the specified group. The list includes items for which display in the store is enabled in settings. Display in the store must be enabled in the settings for the group. |
GetPaginatedVirtualCurrencyList | Returns a list of virtual currencies according to pagination settings. |
GetVirtualCurrencyList | Returns a full list of virtual currencies. The list includes currencies for which display in the store is enabled in settings. |
GetPaginatedVirtualCurrencyPackagesList | Returns a list of virtual currency packages according to pagination settings. The list includes packages for which display in the store is enabled in settings. |
GetVirtualCurrencyPackagesList | Returns a full list of virtual currency packages. The list includes packages for which display in the store is enabled in settings. |
GetPaginatedBundles | Returns a list of bundles according to pagination settings. The list includes bundles for which display in the store is enabled in settings. |
GetBundles | Returns a full list of bundles. The list includes bundles for which display in the store is enabled in settings. |
GetBundle | Returns information about the contents of the specified bundle. In the bundle settings, display in the store must be enabled. |
GetCatalog | Returns a full list of virtual items. The list includes items for which display in the store is enabled in settings. For each virtual item, the SKU, name, description, and data about the groups it belongs to are returned. |
How-tos
Learn about advanced setups from our how-tos.
To get new users to your application and increase sales, you can sell sets of items as bundles for less than the cost of their content.
A bundle may include:
- virtual currency (including the platform-dependent currency)
- package of virtual currency
- game keys for preselected platforms
- virtual items including time-limited items
- bundles
For details on the features and limitations of bundles, see the Shop Builder guide.
To work with bundles:
- Complete the settings in Publisher Account by following the instructions for setting up a bundle.
- Implement in-game logic using the following SDK methods:
GetBundles— gets a list of bundles for building a catalog.GetBundle— gets a bundle for the specified SKU.
Note
For bundles that contain items sold for real currency, the total cost of these items is passed in the
total_content_price parameter. You can use this value to display the benefits of buying a bundle in your application.Was this article helpful?
Thank you for your feedback!
We’ll review your message and use it to help us improve your experience.Useful links
Last updated: April 23, 2025Found a typo or other text error? Select the text and press Ctrl+Enter.
