Back to top

We offer a fully documented public API for developers to use CheapShark pricing data on their own app or website. The only condition is that you use CheapShark links for deals (this is how we pay for hosting and development).

If you need help with your implementation, or just want to share what you’ll be using the API for, feel free to get in touch with us anytime. We’re always happy to help - admin@cheapshark.com.

Deals 

The deal object is what drives most of what you see on the site. They are price data for games, at a specific store. All dealID’s are encoded on the server. Deal rating is normalized on a scale from 0 to 10. You can send users to a deal using the redirect page:

http://www.cheapshark.com/redirect?dealID={id}

Resources 

/deals{?storeID,pageNumber,pageSize,sortBy,desc,lowerPrice,upperPrice,metacritic,steamRating,steamAppID,title,exact,AAA,steamworks,onSale,output}

Get a paged list of deals matching any number of criteria, no parameters are required. Example:

http://www.cheapshark.com/api/1.0/deals?storeID=6&desc=0&title=batman&pageSize=5
  • Parameters
  • storeID
    string (optional) Example: 1,3,4

    Comma separated list of stores to filter on, omit for any

    pageNumber
    integer (optional) Default: 0 Example: 7

    The requested page number, 0 indexed

    pageSize
    integer (optional) Default: 60 Example: 15

    The size of pages returned, up to 60

    sortBy
    string (optional) Default: Deal Rating Example: Metacritic

    Criteria to sort the list by

    Choices: Deal Rating, Title, Savings, Price, Metacritic, Reviews, Release, Store, recent

    desc
    boolean (optional) Default: 0 Example: 1

    Determines sort direction

    lowerPrice
    integer (optional) Default: 0 Example: 6

    Lowest price for a deal

    upperPrice
    integer (optional) Example: 15

    Highest price for a deal (50 acts the same as no limit)

    metacritic
    integer (optional) Example: 75

    Minimum Metacritic rating for a game

    steamRating
    integer (optional) Example: 83

    Minimum Steam reviews rating for a game

    steamAppID
    string (optional) Example: 220,420

    Comma separated list of SteamAppIDs to filter on

    title
    string (optional) Example: civilization

    Looks for the string contained anywhere in the game name

    exact
    boolean (optional) Default: 0 Example: 1

    Flag to allow only exact string match for title parameter

    AAA
    boolean (optional) Default: 0 Example: 1

    Flag to include only deals with retail price > $29

    steamworks
    boolean (optional) Default: 0 Example: 1

    Flag to include only deals that redeem on Steam (best guess)

    onSale
    boolean (optional) Default: 0 Example: 1

    Flag to include only games that are currently on sale

    output
    string (optional) Example: rss

    Option to output deals in RSS format (overrides page number/size to 0/15)

  • Response  200Toggle
  • Body
        [
            {
                internalName: "BATMANARKHAMORIGINS",
                title: "Batman: Arkham Origins",
                metacriticLink: "/game/pc/batman-arkham-origins",
                dealID: "ON4zoI9xmocwL5ZrSSuuN7T1olH%2B%2BwXanNwo0mgYl3U%3D",
                storeID: "6",
                gameID: "97941",
                salePrice: "19.99",
                normalPrice: "19.99",
                isOnSale: "0",
                savings: "0.000000",
                metacriticScore: "74",
                steamRatingText: "Very Positive",
                steamRatingPercent: "85",
                steamRatingCount: "16543",
                releaseDate: 1382659200,
                lastChange: 1449512873,
                dealRating: "0.0",
                thumb: "http://cdn.akamai.steamstatic.com/steam/apps/209000/capsule_sm_120.jpg?t=1447355522"
            },
            {
                internalName: "BATMANARKHAMKNIGHTPREMIUMEDITION",
                title: "Batman: Arkham Knight - Premium Edition",
                metacriticLink: null,
                dealID: "%2BxEJU6YhUOJuzx0SdObrW18FsYnH%2BHnOf8lQRiWKTNc%3D",
                storeID: "6",
                gameID: "143817",
                salePrice: "89.99",
                normalPrice: "89.99",
                isOnSale: "0",
                savings: "0.000000",
                metacriticScore: "0",
                steamRatingText: null,
                steamRatingPercent: "0",
                steamRatingCount: "0",
                releaseDate: 0,
                lastChange: 1446053408,
                dealRating: "0.0",
                thumb: "http://www.gamersgate.com/img/boximgs/small/DD-BMAKPE.jpg"
            },
            {
                internalName: "BATMANARKHAMCITYGAMEOFTHEYEAREDITION",
                title: "Batman Arkham City Game of the Year Edition",
                metacriticLink: null,
                dealID: "jDMoFogJkUglKE%2BHdCLxXtYSMkUChWVyQZql0Fv0k3Q%3D",
                storeID: "6",
                gameID: "89095",
                salePrice: "19.99",
                normalPrice: "19.99",
                isOnSale: "0",
                savings: "0.000000",
                metacriticScore: "0",
                steamRatingText: "Overwhelmingly Positive",
                steamRatingPercent: "96",
                steamRatingCount: "14442",
                releaseDate: 0,
                lastChange: 1449512869,
                dealRating: "0.0",
                thumb: "http://cdn.akamai.steamstatic.com/steam/apps/200260/capsule_sm_120.jpg?t=1449739183"
            },
            {
                internalName: "BATMANARKHAMKNIGHTSEASONPASS",
                title: "Batman: Arkham Knight - Season Pass",
                metacriticLink: null,
                dealID: "oKVz3WtMbo%2BCBcjK4NCRJGhpF5CoIl%2BSudi61AxPwxY%3D",
                storeID: "6",
                gameID: "143771",
                salePrice: "39.99",
                normalPrice: "39.99",
                isOnSale: "0",
                savings: "0.000000",
                metacriticScore: "0",
                steamRatingText: null,
                steamRatingPercent: "0",
                steamRatingCount: "0",
                releaseDate: 0,
                lastChange: 1446053408,
                dealRating: "0.0",
                thumb: "http://www.gamersgate.com/img/boximgs/small/DLC-BAKSP.jpg"
            },
            {
                internalName: "LEGOBATMAN2DCSUPERHEROES",
                title: "LEGO Batman 2: DC Super Heroes",
                metacriticLink: "/game/pc/lego-batman-2-dc-super-heroes",
                dealID: "Zmjzs9K9ISZCa5NDA9hEdSoZITf4QvrZiDirawnlk5M%3D",
                storeID: "6",
                gameID: "88269",
                salePrice: "19.99",
                normalPrice: "19.99",
                isOnSale: "0",
                savings: "0.000000",
                metacriticScore: "81",
                steamRatingText: "Very Positive",
                steamRatingPercent: "88",
                steamRatingCount: "549",
                releaseDate: 1340064000,
                lastChange: 1449252511,
                dealRating: "0.0",
                thumb: "http://cdn.akamai.steamstatic.com/steam/apps/213330/capsule_sm_120.jpg?t=1447355937"
            }
        ]
    

Resources 

/deals{?id}

Get info for a specific deal. Response includes game info, any cheaper current deals, and the cheapest historical price. As elsewhere, dealID is encoded. Example :

http://www.cheapshark.com/api/1.0/deals?id=X8sebHhbc1Ga0dTkgg59WgyM506af9oNZZJLU9uSrX8%3D
  • Response  200Toggle
  • Body
    {
        gameInfo: {
            storeID: "1",
            gameID: "93503",
            name: "BioShock Infinite",
            steamAppID: "8870",
            salePrice: "29.99",
            retailPrice: "29.99",
            steamRatingText: "Overwhelmingly Positive",
            steamRatingPercent: "95",
            steamRatingCount: "51403",
            metacriticScore: "94",
            metacriticLink: "/game/pc/bioshock-infinite",
            releaseDate: 1364256000,
            publisher: "2K Games",
            steamworks: "1",
            thumb: "http://cdn.akamai.steamstatic.com/steam/apps/8870/capsule_sm_120.jpg?t=1447354441"
        },
        cheaperStores: [
            {
                dealID: "veS9SwQTYdiYIvb2sj0fJiEwqBaX3YpGvtNzND2fYnU%3D",
                storeID: "16",
                salePrice: "28.95",
                retailPrice: "36.00"
            }
        ],
        cheapestPrice: {
            price: "1.87",
            date: 1417954459
        }
    }
    

Games 

Games are the parent for deals, they are grouped by their name. They have one or more deals associated with them.

Resources 

/games{?title,steamAppID,limit,exact}

Get a list of games that contain a given title. Response includes the cheapest current deal for each game. Example:

http://www.cheapshark.com/api/1.0/games?title=batman&limit=3
  • Parameters
  • title
    string (optional) Example: batman

    Search for a game by title

    steamAppID
    integer (optional) Example: 35140

    Search for a game by Steam’s AppID - e.g. http://store.steampowered.com/app/35140/

    limit
    integer (optional) Default: 60 Example: 15

    The maximum number of games to return, up to 60

    exact
    boolean (optional) Default: 0 Example: 1

    Flag to allow only exact string match for title parameter

  • Response  200Toggle
  • Body
    [
       {
          "gameID":"14",
          "steamAppID":null,
          "cheapest":"29.94",
          "cheapestDealID":"jGokNhCpCI6y3CrLaPJ74lghhmx1DXT6BXlMeun7yEA%3D",
          "external":"Batman: Arkham City",
          "thumb":"http:\/\/wizzywizzyweb.gmgcdn.com\/media\/products\/batman-arkham-city\/boxart\/batman-arkham-city_boxart_wide.jpg"
       },
       {
          "gameID":"146",
          "steamAppID":"35140",
          "cheapest":"19.95",
          "cheapestDealID":"n96QeQ9FLRDoZToO75BS2Dx22PPtc7hlpcehVxUlW2c%3D",
          "external":"Batman: Arkham Asylum Game of the Year Edition",
          "thumb":"http:\/\/cdn.akamai.steamstatic.com\/steam\/apps\/35140\/capsule_sm_120.jpg?t=1382035811"
       },
       {
          "gameID":"612",
          "steamAppID":"21000",
          "cheapest":"19.99",
          "cheapestDealID":"rQdqaVTgv3hsji3T3BRCoAqk%2FGt%2FsyhLYASsZBQbU4M%3D",
          "external":"LEGO Batman",
          "thumb":"http:\/\/cdn.akamai.steamstatic.com\/steam\/apps\/21000\/capsule_sm_120.jpg?t=1381439357"
       }
    ]
    

Resources 

/games{?id}

Gets info for a specific game. Response includes a list of all deals associated with the game.

http://www.cheapshark.com/api/1.0/games?id=14
  • Response  200Toggle
  • Body
    {
       "info":{
          "title":"Batman: Arkham City",
          "steamAppID":null
       },
        "cheapestPriceEver":{
             price: "5.00",
             date: 1372922175
        },
       "deals":[
          {
             "storeID":"9",
             "dealID":"Rvw%2FIP%2Fivqs%2Fz%2BTxA2NGkLrvByenFMiDljgydVBFkMw%3D",
             "price":"19.99",
             "retailPrice":"19.99"
             "savings":"0.000000"
          },
          {
             "storeID":"3",
             "dealID":"jGokNhCpCI6y3CrLaPJ74lghhmx1DXT6BXlMeun7yEA%3D",
             "price":"29.94",
             "retailPrice":"29.94"
             "savings":"0.000000"
          },
          {
             "storeID":"5",
             "dealID":"se5gAdztkrc9svaLPhaVb1drhQP3tlcztIhqLh7cTA0%3D",
             "price":"29.99",
             "retailPrice":"29.99"
             "savings":"0.000000"
          }
       ]
    }
    

Resources 

/games{?ids}

Allows lookup of a list of games. Includes list of all deals for each game. Maximum of 25 games.

http://www.cheapshark.com/api/1.0/games?ids=128,129,130
  • Response  200Toggle
  • Body
    {
        "128": {
            "info": {
                "title": "BioShock",
                "steamAppID": "7670",
                "thumb": "http:\/\/cdn.akamai.steamstatic.com\/steam\/apps\/7670\/capsule_sm_120.jpg?t=1408380812"
            },
            "cheapestPriceEver": {
                "price": "3.99",
                "date": 1386095711
            },
            "deals": [
                {
                    "storeID": "16",
                    "dealID": "mV6YQQASEnYVjbFbW%2FhZnJd13A70L1NHaSP16JfOW1U%3D",
                    "price": "17.95",
                    "retailPrice": "20.00"
                    "savings": "0.8975"
                },
                {
                    "storeID": "2",
                    "dealID": "TFPJd9D1c339D97aFEi6X7MqepXS2BoIqqPicc73EZI%3D",
                    "price": "19.95",
                    "retailPrice": "19.95"
                    "savings": 0.000000"
                },
                {
                    "storeID": "4",
                    "dealID": "E2SNtj6pS3cj3nPJ%2BfcAU1MfFR%2BencohDVerQFVvR8E%3D",
                    "price": "19.99",
                    "retailPrice": "19.99"
                    "savings": 0.000000"
                },
                {
                    "storeID": "3",
                    "dealID": "1uLj5Gs%2FXD4%2FnwJPZ1tWd0gDaaub9tx3DeciPx%2BTvOU%3D",
                    "price": "19.99",
                    "retailPrice": "19.99"
                    "savings": 0.000000"
                },
                {
                    "storeID": "6",
                    "dealID": "NcQJkoIDlzfdNfYmMjsKj5eZhBQIaXKS3h2quZKVTvc%3D",
                    "price": "19.99",
                    "retailPrice": "19.99"
                    "savings": 0.000000"
                },
                {
                    "storeID": "9",
                    "dealID": "r43Mi9aLipWfIdhepLWvChdcwyCZ2CD6aNcRf5z%2B6hk%3D",
                    "price": "19.99",
                    "retailPrice": "19.99"
                    "savings": 0.000000"
                },
                {
                    "storeID": "5",
                    "dealID": "n9RiuIt%2FbaOHjx47Qnib0qImMEK9Rn3JzE1UiAZPQO8%3D",
                    "price": "19.99",
                    "retailPrice": "19.99"
                    "savings": 0.000000"
                },
                {
                    "storeID": "1",
                    "dealID": "cY1EhiDKVT5VkphdrgAci9xuFaHJQKHNn%2BpjQNJQnVY%3D",
                    "price": "19.99",
                    "retailPrice": "19.99"
                    "savings": 0.000000"
                }
            ]
        },
        "129": {
            "info": {
                "title": "Red Orchestra 2: Heroes of Stalingrad",
                "steamAppID": "35450",
                "thumb": "http:\/\/www.gamersgate.com\/img\/boximgs\/small\/DD-RO2HS.jpg"                    
            },
            "cheapestPriceEver": {
                "price": "2.49",
                "date": 1390296372
            },
            "deals": [
                {
                    "storeID": "2",
                    "dealID": "gQ%2BvhhK8ajVFYxHIo0%2B12qoX3nUJNwWS5LgqSnfS4AI%3D",
                    "price": "2.49",
                    "retailPrice": "9.95"
                },
                {
                    "storeID": "3",
                    "dealID": "uJDIXwUve0nH2n4ToaL%2FLi71X4cT1XqHuqYfxaDDHN0%3D",
                    "price": "19.99",
                    "retailPrice": "19.99"
                }
            ]
        },
        "130": {
            "info": {
                "title": "Renegade Ops",
                "steamAppID": "99300",
                "thumb": "http:\/\/cdn.akamai.steamstatic.com\/steam\/apps\/99300\/capsule_sm_120.jpg?t=1405131452"
            },
            "cheapestPriceEver": {
                "price": "1.88",
                "date": 1357059010
            },
            "deals": [
                {
                    "storeID": "16",
                    "dealID": "ILGbyou9e%2FTV%2FH1Z9BHyNKklN3hw%2Bh1kQaUk6fFpvLQ%3D",
                    "price": "13.95",
                    "retailPrice": "18.00"
                },
                {
                    "storeID": "9",
                    "dealID": "qL0d68NYOKM4C3c3RkKqn8bAzTsLDEjQ6NEbdXYUs4k%3D",
                    "price": "14.99",
                    "retailPrice": "14.99"
                },
                {
                    "storeID": "5",
                    "dealID": "q7svu9d2ZWhH0jlWwc7Y1K87WblTeVSdxAP4%2F4gQ9xk%3D",
                    "price": "14.99",
                    "retailPrice": "14.99"
                },
                {
                    "storeID": "2",
                    "dealID": "19d7c1QFzM5USnjbxzJC7OaUvdKDmSOkRWHWDNMm%2Fho%3D",
                    "price": "14.99",
                    "retailPrice": "14.99"
                },
                {
                    "storeID": "4",
                    "dealID": "C4zv7m9JgrpENQruwyRtghrE9aE8yklgRldEiPKZGBo%3D",
                    "price": "15.00",
                    "retailPrice": "15.00"
                },
                {
                    "storeID": "3",
                    "dealID": "S2BqLClJkTkuLqKKBwg17BHN6SXgJP%2Bi2s0YO72J45o%3D",
                    "price": "15.00",
                    "retailPrice": "15.00"
                },
                {
                    "storeID": "1",
                    "dealID": "YVakQjhMcizSIK2lDWVgW5zXo35ZV63u7u%2BXazw%2Bfm4%3D",
                    "price": "15.00",
                    "retailPrice": "15.00"
                }
            ]
        }
    }
    

Stores 

Information on stores we track

Resources 

/stores

Returns a full list of store IDs and names, an active flag specifying if price updates are currently enabled/disabled, and an array of image/logo sizes (relative URLs)

  • Response  200Toggle
  • Body
    [
        {
            storeID: "1",
            storeName: "Steam",
            isActive: 1,
            images: {
                banner: "/img/stores/banners/0.png",
                logo: "/img/stores/logos/0.png",
                icon: "/img/stores/icons/0.png"
            }
        },
        {
            storeID: "2",
            storeName: "Gamer's Gate",
            isActive: 1,
            images: {
                banner: "/img/stores/banners/1.png",
                logo: "/img/stores/logos/1.png",
                icon: "/img/stores/icons/1.png"
            }
        },
        {
            storeID: "3",
            storeName: "GreenManGaming",
            isActive: 1,
            images: {
                banner: "/img/stores/banners/2.png",
                logo: "/img/stores/logos/2.png",
                icon: "/img/stores/icons/2.png"
            }
        }
        ...
    ]
    

Alerts 

Price alerts are a combination of email address, gameID, and price

Resources 

/alerts{?action,email,gameID,price}

Set or remove a price alert. Example:

http://www.cheapshark.com/api/1.0/alerts?action=set&email=someone@example.org&gameID=34&price=14.99
  • Parameters
  • action
    string (required) Example: set

    The action to take on the price alert

    Choices: set, delete

    email
    string (required) Example: someone@example.org

    Any valid email address

    gameID
    integer (required) Example: 34

    An existing gameID

    price
    decimal (optional) Example: 14.99

    The price to wait for, only required when setting

  • Response  200Toggle
  • Body
    true/false