Plat Prices
HomeForums

PlayStation Store and Trophy API

As a free resource to other developers, PlatPrices offers an API for PlayStation game information, including pricing and trophy information. The API provides data in an easy-to-use JSON format. The data provided by this API is exactly the same as the data displayed throughout the PlatPrices website, and is thus constantly being updated.

How do I get access to the API?

Simply send us an e-mail at contact@platprices.com, briefly letting us know what you would like to use the API for. The API is free to use. We do, however, have three restrictions:

  • We do not allow competing websites to use it (e.g., websites that offer PSN wishlist e-mail sale notifications). If you are not sure whether or not your project or website qualifies, just ask.
  • You can make 500 calls to the API per hour. If you believe you need more than this, we ask that you consider storing the results of your calls to the API in your local database, rather than looking it up via the API every time it is needed. If you still believe you need more calls to the API than this, let us know why and we may increase your limit.
  • We ask that you link back to PlatPrices anywhere that you use data from this API.
After you contact us, we will give you an API key that you can use to access the API.

How do I get Information About a Single Game or Product?

The API is accessed simply via a GET request (i.e., a standard web request), and the data is returned in JSON format. For example, accessing the URL https://platprices.com/api.php?key=<API key>&ppid=7704, where <API key> is your API key, gives information like the following:

{
   "PPID":"7704",
   "PSNID":"UP0700-CUSA03388_00-DARKSOULS3DELUXE",
   "GameID":"CUSA03388",
   "PlatPricesURL":"https://platprices.com/en-us/game/7704-dark-souls-iii-deluxe-edition",
   "PSStoreURL":"https://store.playstation.com/en-us/product/UP0700-CUSA03388_00-DARKSOULS3DELUXE",
   "ProductName":"Dark Souls III - Deluxe Edition",
   "GameName":"Dark Souls III",
   "Publisher":"BANDAI NAMCO Entertainment America Inc.",
   "Developer":"FromSoftware",
   "ReleaseDate":"2016-04-12",
   "Desc":"The DARK SOULS III Deluxe Edition includes the full game & the Season Pass. First DLC coming Fall 2016. DARK SOULS III pushes the boundaries with the latest chapter in the series. Journey once more into a world filled with daunting, colossal enemies and environments. Players will be immersed into a world of epic atmosphere and darkness through faster gameplay and amplified combat intensity. With the new skills attacks, deliver powerful attacks to break through enemy defense weapons equipped with unique skills. Expand your experience with the Season Pass content featuring new maps, bosses, enemies and additional weapon and armor sets. Embrace The Darkness!",

   "IsPS4":"1",
   "IsPS5":"0",
   "IsDLC":"0",
   "IsDemoOrSoundtrack":"0",
   "IsVR":"0",
   "IsMove":"0",
   "VitaCB":"0",
   "PS4Size":"18244304896",
   "PS5Size":"0",
   "OnlinePlay":"1",
   "OfflinePlayers":"1",
   "OnlinePlayers":"6",
   "PSPlusNeeded":"0",
   "VoiceLang":"",
   "SubtitleLang":"",
   "Rating":"ESRB Mature",
   "RatingDesc":"[\"Violence\",\"Blood\",\"Online Interactions Not Rated by the ESRB\"]",
   "OpenCriticID":"1520",
   "MetacriticURL":"",

   "Img":"https://image.api.playstation.com/cdn/UP0700/CUSA03388_00/Fg2otuFMeKjhnXG2QLUrwKqrMNvsC0n9.png",
   "CoverArt":"https://image.api.playstation.com/vulcan/img/rnd/202010/0823/nwAKSQRMXqURmgOYHaxickuk.png",
   "LogoImg":"https://image.api.playstation.com/vulcan/img/rnd/202010/0822/0p6wO8PkVsDjPntPBcsHSkOA.png",
   "Screenshot1":"https://image.api.playstation.com/vulcan/img/rnd/202010/0823/VrGmJUyUWqMBVhhvGowb6hXq.jpg",
   "Screenshot2":"https://image.api.playstation.com/vulcan/img/rnd/202010/0823/7hosVKSR2b7VPVOtfp7rDTZ3.jpg",
   "Screenshot3":"https://image.api.playstation.com/vulcan/img/rnd/202010/0823/RHgdm97GVu1FBiBL9Lsxxe6v.jpg",
   "Screenshot4":"https://image.api.playstation.com/vulcan/img/rnd/202010/0823/P2zlJtnaG1wfRmg6fTiSAusG.jpg",
   "Screenshot5":"https://image.api.playstation.com/vulcan/img/rnd/202010/0823/VTGFPgDF4Z1FvHAp5LFTxTm6.jpg",
   "Screenshot6":"https://image.api.playstation.com/vulcan/img/rnd/202010/0823/MjSef2xM8l36gPG0yZ9G5F7J.jpg",
   "Screenshot7":"https://image.api.playstation.com/vulcan/img/rnd/202010/0823/BQNnUfmvk097R1qdHzwjSBhf.jpg",
   "Screenshot8":"https://image.api.playstation.com/vulcan/img/rnd/202010/0823/0nUcgegErR7Du10mDUZ798bR.jpg",
   "Screenshot9":"https://image.api.playstation.com/vulcan/img/rnd/202010/0823/FYUOrf3v8hMW1l4gWZy2Llba.jpg",
   "PreviewVideo":"",

   "GenreAction":"1",
   "GenreAdventure":"1",
   "GenreArcade":"0",
   "GenreFighting":"0",
   "GenreFPS":"0",
   "GenreHorror":"0",
   "GenreIntStory":"0",
   "GenreMMO":"0",
   "GenreMusic":"0",
   "GenrePlatformer":"0",
   "GenrePuzzle":"0",
   "GenreRacing":"0",
   "GenreRPG":"1",
   "GenreSimulation":"0",
   "GenreSports":"0",
   "GenreStrategy":"0",
   "GenreTPS":"0",

   "Bronze":"26",
   "Silver":"13",
   "Gold":"3",
   "Platinum":"1",
   "Difficulty":"6",
   "HoursLow":"75",
   "HoursHigh":"100",
   "TrophyListURL":"https://psnprofiles.com/trophies/4477-dark-souls-iii",
   "GuidePSNP":"4281-dark-souls-iii-trophy-guide",
   "GuidePS3T":"https://www.playstationtrophies.org/game/dark-souls-3/guide/",
   "GuidePS3I":"",
   "GuidePyx":"https://www.powerpyx.com/guides/dark-souls-3-trophy-guide.html",
   "GuideKnoef":"",
   "GuideYoutube":"00000000000",
   "GuideDex":"",
   "GuideCust":"",
   "GuideCustLabel":"",

   "Region":"US",
   "BasePrice":"8499",
   "PlusPrice":"2124",
   "SalePrice":"2124",
   "formattedBasePrice":"$84.99",
   "formattedSalePrice":"$21.24",
   "formattedPlusPrice":"$21.24",
   "DiscPerc":"75",
   "LastDiscounted":"2021-02-10 09:11:04",
   "DiscountedUntil":"2021-02-25 07:59:00",

   "apiLimit":"500",
   "apiUsage":"15",
   "error":0,
   "errorDesc":""
}

How do I specify which product or game I want information for?

To tell the API which game or product you would like information about, specify exactly one of the following three parameters in the URL querystring:

  • ppid: The "PlatPrices ID" of the product. This ID number can be found in the URL of every product page on PlatPrices. For example, since the PlatPrices page for Dark Souls III - Digital Deluxe Edition is https://platprices.com/en-us/game/7704-dark-souls-iii-deluxe-edition, we see that its ppid is 7704, which is why we specified ppid=7704 in our first example above.
  • psnid: The "PSN ID" of the product. This ID string can be found in the URL of every product page on the official PSN web store. For example, since the official PSN web store URL for Dark Souls III - Digital Deluxe Edition is https://store.playstation.com/en-us/product/UP0700-CUSA03388_00-DARKSOULS3DELUXE, accessing the API url https://platprices.com/api.php?key=<API key>&psnid=UP0700-CUSA03388_00-DARKSOULS3DELUXE returns the exact same information as our first example above.
  • name: The name of the game or product. If this is provided, the API will return information about the most relevant product that it finds in the database. For example, the API URL https://platprices.com/api.php?key=<API key>&name=Dark Souls 3 will return information about the base version of Dark Souls III, whereas the API URL https://platprices.com/api.php?key=<API key>&name=Dark Souls 3 Deluxe will return information about the deluxe edition of Dark Souls III. The game/product name does not need to be an exact match, but the lookup algorithm is also not perfect, so better-formatted names are more likely to return the product you are actually interested in. An error will be returned if no product with a similar name can be found.
Optionally, you may also specify a region parameter, which takes a 2-letter country code. By default the region is "US", but if you specify another region then pricing information and the release date will be returned for that region. For example, the url https://platprices.com/api.php?key=<API key>&name=Dark Souls 3 Deluxe&region=GB returns the same data as in our first example above, but with the release date and pricing information corresponding to the United Kingdom instead of the United States.

What do the values returned by the API mean?

For the most part, the values returned by the API should be self-explanatory. However, we clarify some of them here:

  • IsVR: "0" means VR not supported, "1" means VR is optional, "2" means VR is required
  • IsMove: "0" means Move controllers are not supported, "1" means Move controllers are optional, "2" means Move controllers are required
  • VitaCB: "0" or "1", indicating whether or not this game offers a Vita version via cross-buy
  • PS4Size and PS5Size: the download size, in bytes, of the product
  • OnlinePlay: "0" means the game is offline-only, "1" means online and offline modes are supported, "2" means the game is online-only
  • VoiceLang: a JSON array like ["en","es"] of language codes specifying the supported voice languages in the game
  • SubtitleLang: a JSON array like ["en","es"] of language codes specifying the supported subtitle languages in the game
  • OpenCriticID: the numeric ID of this game on OpenCritic, which can be used to look up game and review information from the (also free) OpenCritic API via URLs like https://api.opencritic.com/api/game/1520
  • MetacriticURL: the Metacritic URL of this game, which is only provided if the game does not have an OpenCritic entry
  • DiscPerc: the current discount percentage
  • LastDiscounted: the last time (in UTC) that we noticed this product go on sale – this might not be the exact time that it actually went on sale
  • error: 0 if successfully returned product information, a bigger-than-zero number if an error was encountered

How Can I Get a List of Games That Recently Went on Sale?

There are a couple of different ways to do this. The simplest is to specify discount=1 in the URL querystring (instead of the other parameters discussed above), which returns a list of all games that had new discounts applied within the past 48 hours. For example, accessing the URL https://platprices.com/api.php?key=<API key>&discount=1, where <API key> is your API key, gives a list of products in the following format:

{
   "discounts":[
      {
         "PPID":"35552",
         "Name":"Godfall - Digital Deluxe",
         "PlatPricesURL":"https://platprices.com/en-us/game/35552-godfall-digital-deluxe",
         "LastDiscounted":"2021-02-15 08:10:05",
         "DiscountedUntil":"2021-02-24 07:59:00",
         "BasePrice":"8999",
         "SalePrice":"6029",
         "PlusPrice":"6029",
         "formattedBasePrice":"$89.99",
         "formattedSalePrice":"$60.29",
         "formattedPlusPrice":"$60.29",
         "Difficulty":"6",
         "HoursLow":"40",
         "HoursHigh":"60",
         "IsPS4":"0",
         "IsPS5":"1"
      },
      {
         "PPID":"35551",
         "Name":"Godfall",
         "PlatPricesURL":"https://platprices.com/en-us/game/35551-godfall",
         "LastDiscounted":"2021-02-15 08:10:05",
         "DiscountedUntil":"2021-02-24 07:59:00",
         "BasePrice":"6999",
         "SalePrice":"3989",
         "PlusPrice":"3989",
         "formattedBasePrice":"$69.99",
         "formattedSalePrice":"$39.89",
         "formattedPlusPrice":"$39.89",
         "Difficulty":"6",
         "HoursLow":"40",
         "HoursHigh":"60",
         "IsPS4":"0",
         "IsPS5":"1"
      },
      {
         "PPID":"35550",
         "Name":"Godfall - Ascended Edition",
         "PlatPricesURL":"https://platprices.com/en-us/game/35550-godfall-ascended-edition",
         "LastDiscounted":"2021-02-15 08:10:04",
         "DiscountedUntil":"2021-02-24 07:59:00",
         "BasePrice":"9999",
         "SalePrice":"6999",
         "PlusPrice":"6999",
         "formattedBasePrice":"$99.99",
         "formattedSalePrice":"$69.99",
         "formattedPlusPrice":"$69.99",
         "Difficulty":"6",
         "HoursLow":"40",
         "HoursHigh":"60",
         "IsPS4":"0",
         "IsPS5":"1"
      }
   ],
   "error":0,
   "errorDesc":"",
   "apiLimit":"500",
   "apiUsage":"13"
}

Each game's PPID is provided so that additional information about it can be obtained via another API query, if desired.

Optionally, you may also specify a region parameter, which takes a 2-letter country code. By default the region is "US", but if you specify another region then pricing and discount information will be returned for that region. For example, the url https://platprices.com/api.php?key=<API key>&discount=1&region=GB returns the discounts that went live in the United Kingdom region of the PlayStatation store in the last 48 hours.

How Can I Get Information About All Active Sales?

You can get a list of all active sales (i.e., the sales marked "Active" on this page) by specifying sales=1 in the URL querystring (instead of the other parameters discussed above). This will return information like the following:

{
   "sales":[
      {
         "ID":"441",
         "SaleTime":"2021-02-17 08:11:44",
         "SaleEnd":"2021-03-04 07:59:00",
         "NumGames":"437",
         "ImgURL":"https://image.api.playstation.com/pr/bam-art/115/768/0aa46a23-85a4-4c9d-ad09-36d225975703.png",
         "SaleName":"Double Discounts sale"
      },
      {
         "ID":"398",
         "SaleTime":"2021-02-10 02:29:07",
         "SaleEnd":"2021-02-25 07:59:00",
         "NumGames":"212",
         "ImgURL":"https://image.api.playstation.com/pr/bam-art/115/690/02d28f2d-f493-4c1d-b2a7-e47d24e466d0.jpg",
         "SaleName":"Big in Japan Sale"
      }
   ],
   "error":0,
   "errorDesc":"",
   "apiLimit":"500",
   "apiUsage":"1"
}

As with all of the API calls, the times returned here are in UTC. Also, the region parameter can be specified here as well to learn about sales in countries other than the US. The sales are always returned in order from newest to oldest. The sale IDs that are returned here can be used to look up all games that were discounted as part of that sale (see below).

How Can I Get A List of Games That Were Part of a Particular Sale?

After getting a sale's ID (either from the API call above with sales=1, or by looking at the URL of its sale table page, you can get a list of games and DLC packages that were part of that sale by specifying sale=<sale_id>. For example, the API URL https://platprices.com/api.php?key=<API key>&sale=441 will return information like the following:

{
   "SaleName":"Double Discounts sale",
   "SaleTime":"2021-02-17 08:11:44",
   "SaleEnd":"2021-03-04 07:59:00",
   "ImgURL":"https://image.api.playstation.com/pr/bam-art/115/768/0aa46a23-85a4-4c9d-ad09-36d225975703.png",
   "Region":"US",
   "game_discounts":[
      {
         "PPID":"4081",
         "Name":"2064: Read Only Memories",
         "Difficulty":"3",
         "HoursLow":10,
         "HoursHigh":15,
         "IsPS4":"1",
         "IsPS5":"0",
         "LastDiscounted":"2021-02-17 08:11:05",
         "DiscountedUntil":"2021-03-04 07:59:00",
         "BasePrice":"1999",
         "SalePrice":"399",
         "PlusPrice":"299",
         "formattedBasePrice":"$19.99",
         "formattedSalePrice":"$3.99",
         "formattedPlusPrice":"$2.99",
         "PlatPricesURL":"https://platprices.com/en-us/game/4081-2064-read-only-memories"
      },
      {
         "PPID":"6326",
         "Name":"A Fisherman's Tale",
         "Difficulty":"2",
         "HoursLow":2,
         "HoursHigh":3,
         "IsPS4":"1",
         "IsPS5":"0",
         "LastDiscounted":"2021-02-17 08:10:40",
         "DiscountedUntil":"2021-03-04 07:59:00",
         "BasePrice":"1499",
         "SalePrice":"749",
         "PlusPrice":"749",
         "formattedBasePrice":"$14.99",
         "formattedSalePrice":"$7.49",
         "formattedPlusPrice":"$7.49",
         "PlatPricesURL":"https://platprices.com/en-us/game/6326-a-fishermans-tale"
      },
      {
         "PPID":"33870",
         "Name":"A Fisherman's Tale - Deluxe Edition",
         "Difficulty":"2",
         "HoursLow":2,
         "HoursHigh":3,
         "IsPS4":"1",
         "IsPS5":"0",
         "LastDiscounted":"2021-02-17 08:10:09",
         "DiscountedUntil":"2021-03-04 07:59:00",
         "BasePrice":"1999",
         "SalePrice":"999",
         "PlusPrice":"999",
         "formattedBasePrice":"$19.99",
         "formattedSalePrice":"$9.99",
         "formattedPlusPrice":"$9.99",
         "PlatPricesURL":"https://platprices.com/en-us/game/33870-a-fishermans-tale-deluxe-edition"
      },
      {
         "PPID":"4690",
         "Name":"Aces of the Luftwaffe - Squadron",
         "Difficulty":"-1",
         "HoursLow":"-1",
         "HoursHigh":"-1",
         "IsPS4":"1",
         "IsPS5":"0",
         "LastDiscounted":"2021-02-17 08:10:49",
         "DiscountedUntil":"2021-03-04 07:59:00",
         "BasePrice":"1499",
         "SalePrice":"749",
         "PlusPrice":"449",
         "formattedBasePrice":"$14.99",
         "formattedSalePrice":"$7.49",
         "formattedPlusPrice":"$4.49",
         "PlatPricesURL":"https://platprices.com/en-us/game/4690-aces-of-the-luftwaffe-squadron"
      },
      ...
   ],
   "dlc_discounts":[
      {
         "PPID":"27379",
         "Name":"3on3 FreeStyle - 270 Fs Points",
         "BasePrice":"2499",
         "SalePrice":"2374",
         "PlusPrice":"2249",
         "ParentGame":"3on3 Freestyle",
         "formattedBasePrice":"$24.99",
         "formattedSalePrice":"$23.74",
         "formattedPlusPrice":"$22.49",
         "PlatPricesURL":"https://platprices.com/en-us/game/27379-3on3-freestyle-270-fs-points"
      },
      {
         "PPID":"27374",
         "Name":"3on3 FreeStyle - 550 Fs Points",
         "BasePrice":"4999",
         "SalePrice":"4499",
         "PlusPrice":"3999",
         "ParentGame":"3on3 Freestyle",
         "formattedBasePrice":"$49.99",
         "formattedSalePrice":"$44.99",
         "formattedPlusPrice":"$39.99",
         "PlatPricesURL":"https://platprices.com/en-us/game/27374-3on3-freestyle-550-fs-points"
      },
      ...
   "error":0,
   "errorDesc":"",
   "apiLimit":"500",
   "apiUsage":"10"
}

Note that the region parameter is not needed here (even for regions other than the US), since sales in different regions have different sale IDs. Also note that a value of "-1" for the Difficulty, HoursLow, or HoursHigh values means "we don't know".