Pull API \ Retrieve the games of a Steam user

Resource/URI GET POST PUT DELETE
Facebook · Retrieve a user's pages /pull/identities/<identity_token>/facebook/pages.json Retrieve Pages
Facebook · Retrieve a user's posts /pull/identities/<identity_token>/facebook/posts.json Retrieve Posts
LinkedIn · Retrieve a user's companies /pull/identities/<identity_token>/linkedin/companies.json Retrieve Companies
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 videos /pull/identities/<identity_token>/youtube/videos.json Retrieve Videos

Workflow

Request: the code to send to the API

Send a GET request to the endpoint /pull/identities/<identity_token>/steam/games.json to retrieve the games of a Steam user. The <identity_token> is obtained whenever one of your users connects using a social network account.

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

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

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