Pull API \ Retrieve the games of a Steam user

Resource/URI HTTP GET
Facebook · Retrieve a user's likes /pull/identities/<identity_token>/facebook/likes.json Retrieve
Likes
Facebook · Retrieve a user's posts /pull/identities/<identity_token>/facebook/posts.json Retrieve
Posts
Facebook · Retrieve a user's pages /pull/identities/<identity_token>/facebook/pages.json Retrieve
Pages
Facebook · Retrieve a user's page posts /pull/identities/<identity_token>/facebook/page/<pageid>/posts.json Retrieve
Page Posts
LinkedIn · Retrieve a user's companies /pull/identities/<identity_token>/linkedin/companies.json Retrieve
Companies
LinkedIn · Retrieve a user's company posts /pull/identities/<identity_token>/linkedin/company/<companyid>/posts.json Retrieve
Company Posts
Pinterest · Retrieve a user's boards /pull/identities/<identity_token>/pinterest/boards.json Retrieve
Boards
Steam · Retrieve a user's games /pull/identities/<identity_token>/steam/games.json Retrieve
Games
Twitter · Retrieve a user's tweets /pull/identities/<identity_token>/twitter/tweets.json Retrieve
Tweets
YouTube · Retrieve a user's channels /pull/identities/<identity_token>/youtube/channels.json Retrieve
Channels
YouTube · Retrieve a user's playlists /pull/identities/<identity_token>/youtube/playlists.json Retrieve
Playlists
YouTube · Retrieve a user's playlist videos /pull/identities/<identity_token>/youtube/playlist/<playlistid>/videos.json Retrieve
Playlist Videos

Workflow

Request: the code to send to the API

Send an API request to this endpoint in order to retrieve the list of games that a user is playing on Steam:

GET /pull/identities/<identity_token>/steam/games.json

The <identity_token> is obtained whenever one of your users connects using Steam. The following URL parameters can optionally be used with this endpoint:

URL Parameter Description
num_games
integer
Indicates how many games should be included in the resultset. The valid range is between 1 an 200.
Default: 50
Example: 200
page
integer
Indicates the page that should be retrieved. To paginate the resultset, simply start with page 1 and make subsequent requests to this endpoint while incrementing the page number with each call.
Default: 1
Example: 5
only_game_id
integer
If specified, only the game with the specified id will be returned. This parameter can be used to check if the user plays a specific game. If the resultset is empty, the user does not play the given game.
Default: no value
Example: 570

To be able to use this endpoint Steam must be fully configured for your OneAll Site.

Result: the code returned by the API

Response Example

{
  "response": {
    "request": {
      "date": "Wed, 30 Jan 2019 11:53:59  0100",
      "resource": "/pull/identities/5dd7336a-cb66-42dc-95da-1a6dade8f743/steam/games.json?num_games=5",
      "status": {
        "flag": "success",
        "code": 200,
        "info": "Your request has been processed successfully"
      }
    },
    "result": {
      "data": {
        "count": 5,
        "entries": [
          {
            "id": 220,
            "name": "Half-Life 2",
            "image": "http://media.steampowered.com/steamcommunity/public/images/apps/220/e4ad9cf1b7dc8475c1118625daf9abd4bdcbcad0.jpg",
            "thumbnail": "http://media.steampowered.com/steamcommunity/public/images/apps/220/fcfb366051782b8ebf2aa297f3b746395858cb62.jpg",
            "minutes_played_total": 0,
            "minutes_played_last_two_weeks": 0
          },
          {
            "id": 320,
            "name": "Half-Life 2: Deathmatch",
            "image": "http://media.steampowered.com/steamcommunity/public/images/apps/320/6dd9f66771300f2252d411e50739a1ceae9e5b30.jpg",
            "thumbnail": "http://media.steampowered.com/steamcommunity/public/images/apps/320/795e85364189511f4990861b578084deef086cb1.jpg",
            "minutes_played_total": 0,
            "minutes_played_last_two_weeks": 0
          },
          {
            "id": 340,
            "name": "Half-Life 2: Lost Coast",
            "image": "http://media.steampowered.com/steamcommunity/public/images/apps/340/867cce5c4f37d5ed4aeffb57c60e220ddffe4134.jpg",
            "thumbnail": "http://media.steampowered.com/steamcommunity/public/images/apps/340/795e85364189511f4990861b578084deef086cb1.jpg",
            "minutes_played_total": 0,
            "minutes_played_last_two_weeks": 0
          },
          {
            "id": 500,
            "name": "Left 4 Dead",
            "image": "http://media.steampowered.com/steamcommunity/public/images/apps/500/0f67ee504d8f04ecd83986dd7855821dc21f7a78.jpg",
            "thumbnail": "http://media.steampowered.com/steamcommunity/public/images/apps/500/428df26bc35b09319e31b1ffb712487b20b3245c.jpg",
            "minutes_played_total": 0,
            "minutes_played_last_two_weeks": 0
          },
          {
            "id": 550,
            "name": "Left 4 Dead 2",
            "image": "http://media.steampowered.com/steamcommunity/public/images/apps/550/205863cc21e751a576d6fff851984b3170684142.jpg",
            "thumbnail": "http://media.steampowered.com/steamcommunity/public/images/apps/550/7d5a243f9500d2f8467312822f8af2a2928777ed.jpg",
            "minutes_played_total": 267,
            "minutes_played_last_two_weeks": 0
          }
        ]
      }
    }
  }
}

User Contributed Notes