User:RJackson/StorefrontAPI

Rough documentation for the storefront API - exposed via Big Picture mode. Data is returned in JSON format.

Shared data structures

App info

id

type

name

discounted

discounted_percent

original_price

Pre-discount application price.

final_price

Post-discount application price.

currency

What currency prices are denoted in.

large_capsule_image

URL of large-capsule image.

small_capsule_image

URL of small-capsule image.

discount_expiration (Optional)

Unix timestamp of when the discount noted above :expires. Is not provided if the app is not discounted.

headline (Optional)

Headline to atop large-capsule widget.

controller_support (Optional)

Whether the app has controller support. Known values:

• partial
• full

purchase_package (Optional)

Subscription ID for purchasing the app.

Known methods

featured

Data about apps featured on storefront.

GET http://store.steampowered.com/api/featured/

Parameters

cc (Optional)

Country code for method to return appropriate currency values.

l (Optional)

Language code for localized strings.

v (Optional)

Unknown.

Result data

large_capsules

An array of objects denoting app information; see #App info.

featured_win

An array of objects denoting app information; see #App info.

featured_mac

An array of objects denoting app information; see #App info.

layout

status

featuredcategories

Even more data about featured apps.

GET http://store.steampowered.com/api/featuredcategories/

Parameters

cc (Optional)

Country code for method to return appropriate currency values.

l (Optional)

Language code for localized strings.

v (Optional)

Unknown.

trailer (Optional)

Unknown.

Result data

N

id

name

items

An array of objects, with differing app structures dependant upon N.id:

cat_spotlight

name

header_image

body

url

cat_dailydeal

See #App info

specials

id

name

items

An array of objects denoting app information; see #App info.

coming_soon

id

name

items

An array of objects denoting app information; see #App info.

top_sellers

id

name

items

An array of objects denoting app information; see #App info.

new_releases

id

name

items

An array of objects denoting app information; see #App info.

genres

id

name

trailerslideshow

id

name

status

appdetails

GET http://store.steampowered.com/api/appdetails/

Parameters

appids

CSV of app IDs to return details of.

cc (Optional)

Country code for method to return appropriate currency values.

l (Optional)

Language code for localized strings.

v (Optional)

Unknown.

filters (Optional)

CSV list of keys to return.

The filter basic returns the following keys:

type

name

steam_appid

required_age

dlc

detailed_description

about_the_game

supported_languages

detailed_description

supported_languages

header_image

website

pc_requirements

mac_requirements

Any key names except those listed under basic are acceptable as filter values.

Result data

App ID

success

data

type

Returns "game" even if software.

name

steam_appid

required_age

dlc (Optional)

Array of app ids.

detailed_description

String (html).

about_the_game

String (html).

supported_languages

String (html).

header_image

URL to image.

website

pc_requirements

Array

minimum

String (html).

recommended

String (html).

mac_requirements

Array

minimum

String (html).

recommended

String (html).

developers

Array of strings

publishers

Array of strings.

packages

Array of package IDs.

price_overview (Optional)

Omitted if free-to-play.

currency

Currency prices are denoted in.

initial

Pre-discount price.

final

Post-discount price.

discount_percent

platforms

Booleans. Does not list Linux.

windows

mac

metacritic (Optional)

score

url

categories

Array.

id

description

genres

Array.

id

description

screenshots

Array.

id

path_thumbnail

URL to image.

path_full

URL to image.

movies

Array.

id

name

thumbnail

webm

480

URL of 480p video.

max

URL of max-quality video.

highlight

Boolean; not sure it's purpose.

recommendations

total

Int

achievements (Optional)

total

Int

highlighted

Array

name

path

URL to achievement icon.

release_date

coming_soon

Boolean, true if unreleased; false if released.

date

Format is localized, according to the cc parameter passed. Is an empty string when date is unannounced.

appuserdetails

Information about apps & users in the context of the Steam account logged in to storefront.

GET http://store.steampowered.com/api/appuserdetails/

Parameters

appids

CSV of app IDs to return details of.

cc (Optional)

Country code for method to return appropriate currency values.

l (Optional)

Language code for localized strings.

v (Optional)

Unknown.

Result data

App ID

success

data

friendswant (Optional)

steamid

playtime_twoweeks

playtime_total

friendsown (Optional)

steamid

playtime_twoweeks

playtime_total

recommendations

totalfriends

friends (Optional)

steamid

timestamp

recommendation

commentcount;

added_to_wishlist