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