Difference between revisions of "User:RJackson/StorefrontAPI"

From Team Fortress Wiki
Jump to: navigation, search
(appdetails "filter" parameter. appdetails return data.)
m (Put a warning noting this api is not intended for public use, and more info about filters.)
Line 1: Line 1:
 +
{{ambox
 +
| image = Pictogram info.png
 +
| contents = This API is not actively documented, under development, and not meant for public consumption.  It may change at any time without notice.
 +
}}
 +
 
Rough documentation for the storefront API - exposed via Big Picture mode.  Data is returned in JSON format.
 
Rough documentation for the storefront API - exposed via Big Picture mode.  Data is returned in JSON format.
  
Line 89: Line 94:
 
:;{{API optional|l}}: Language code for localized strings.
 
:;{{API optional|l}}: Language code for localized strings.
 
:;{{API optional|v}}: Unknown.
 
:;{{API optional|v}}: Unknown.
−
:;{{API optional|filters}}: CSV list of keys to return, e.g. <code>filters=screenshots</code> only returns an appid's screenshots.
+
:;{{API optional|filters}}: CSV list of keys to return.
 +
::The filter <code>basic</code> 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 <code>basic</code> are acceptable as filter values.
  
 
==== Result data ====
 
==== Result data ====

Revision as of 22:03, 24 April 2013

Pictogram info.pngThis API is not actively documented, under development, and not meant for public consumption. It may change at any time without notice.

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
d MMM yyyy; check if localized. Blank if unannounced.


appuserdetails

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.
Retrieved from "https://wiki.teamfortress.com/w/index.php?title=User:RJackson/StorefrontAPI&oldid=1338436"