Skip to main content

An interface for the undocumented Sony PlayStation Store PSN Api

Project description

Build Status

Command line tool for alerting price drops in the Sony Entertainment Network aka PlayStation Network


The Sony Entertainment Network (SEN) uses CIDs to identify items in it’s catalogue. In order to alert you on the desired price of an SEN you need the CID. Use your Browser (cid GET parameter in URL) or this script (–search) to retrieve the CID.

In order to check the price of an item. You need a store identifier. These store identifiers are known to work:

  • DE/de (Germany)

  • GB/en (Great Britain)

  • US/en (United States)

  • SE/en (Sweden)

  • JP/jp (Japan)

Prices are always in the local currency. Therefore it is € for DE/de and £ for GB/en. Additionaly, prices are that for PlayStation Plus users.


Use PyPI to install psnprices

pip install psnprices

This will install the Python modules and also the following command line tools



Mail alerting for single alerts you define yourself

Just run psnmailalert for mail alerting. See example below. Alerts are set in the alerts.csv file. If no store is set. The german / european store is used as a default.

Command line interface

usage: psncli [-h] [--id ID] [--container CONTAINER] [--store STORE]
                 [--price PRICE] [--query QUERY]

optional arguments:
  -h, --help            show this help message and exit
  --id ID, -i ID        CID of game to check
  --container CONTAINER, -c CONTAINER
                        Container to list
  --store STORE, -s STORE
                        regional PSN store to check. Default: 'DE/de'
  --price PRICE, -p PRICE
                        desired price of game
  --query QUERY, -q QUERY
                        Name of item to search for

Retrieving UTF-8 encoded output on terminals

You may have to tell Python that your terminal is capable of dealing with UTF-8 outputs. Some PSN items are annotated with trademark, copyright or foreign language specific symbols. To do so set export PYTHONIOENCODING=utf-8 in your terminal window.

Mail alerting for collections of price reductions

The PlayStation Network creates collections for price reductions. Run python for watching those collections and be alerted if there are new reductions. Alerts for collections are set in the alert_deal_containers.csv file.


You may run this script with the following command line variants:

Mail alerting - Get a mail when alerts have been met

With psnmailalert you may set alerts for price drops in the alerts.csv file. The first value is the CID for the item, the second is the price to be matched in order to alert you by mail, and the second value is the store to search in. You may mix stores in the alerts.csv. After a price has been matched, the alert is removed from alerts.csv. You will not get any further alerts for that item.


If the store value is left blank, the script tries to extract the store from the beginning character of the CID.

In order to receive mails you have to set your account settings in the file mailconfig.json. See mailconfig.json_example for an example config.

To run psnmailalert, just type:


Example mail

Mail with alerts <figcaption>

Mail with alerts


Searching for the CID of an item

Define the name of a game and the store.

psncli --query "metal gear solid peace walker psp" --store DE/de

You will get a result containing one to many search results with the CID. The first output of each search line is the CID, the second the name, the third the supported systems and the last is a description of the item type in the local store language. It is “Vollversion” here which means “full version” in German.

EP0101-ULES01372_00-GPCMETALGE000001    Metal Gear Solid: Peace Walker [PSP]    PS Vita, PSP®   19.99   Vollversion

Check if desired price has been met

The price is in local currency. As exit statuses render the outcome of the alert, you may send you e-mails or desktop notifications with && or ||. In this example, there is a string printed to the console.

psncli --id EP0101-ULES01372_00-GPCMETALGE000001 --store DE/de --price 15.00 &&
echo "Price matched, let's buy Metal Gear Solid PW"


This script is not associated with Sony, Sony PlayStation, the PlayStation Network in any kind. It consumes an public interface that is publicly advertised to the browser to list store contents.

Project details

Release history Release notifications | RSS feed

This version


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

psnprices-1.0.tar.gz (12.2 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page