Skip to main content
Warning: You are using the test version of PyPI. This is a pre-production deployment of Warehouse. Changes made here affect the production instance of TestPyPI (
Help us improve Python packaging - Donate today!

An interface for the undocumented Sony PlayStation Store PSN Api

Project Description

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.


Mail alerting for single alerts you define yourself

Just run python 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: [-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 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, just type:


Example mail

Mail with alerts

Searching for the CID of an item

Define the name of a game and the store.

./ --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.

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

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


Download Files

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

File Name & Hash SHA256 Hash Help Version File Type Upload Date
(12.2 kB) Copy SHA256 Hash SHA256
Source Feb 19, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting