Pull API \ Retrieve the games of a Steam user
Pull API Resources
Resource/URI | 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 groups
/pull/identities/<identity_token>/facebook/groups.json
|
Retrieve Groups |
Facebook · Retrieve a user's group posts
/pull/identities/<identity_token>/facebook/group/<pageid>/posts.json
|
Retrieve Group 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 |
Facebook · Retrieve a user's page post reactions
/pull/identities/<identity_token>/facebook/page/<pageid>/posts.json
|
Retrieve Page Post Reactions |
LinkedIn · Retrieve a user's posts
/pull/identities/<identity_token>/linkedin/user/posts.json
|
Retrieve User 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 |
LinkedIn · Retrieve a post
/pull/identities/<identity_token>/linkedin/post.json
|
Retrieve Post |
LinkedIn · Retrieve post comments
/pull/identities/<identity_token>/linkedin/post/comments.json
|
Retrieve Post Comments |
Pinterest · Retrieve a user's boards
/pull/identities/<identity_token>/pinterest/boards.json
|
Retrieve Boards |
Pinterest · Retrieve a user's board pins
/pull/identities/<identity_token>/pinterest/board/<boardid>/pins.json
|
Retrieve Board Pins |
Steam · Retrieve a user's games
/pull/identities/<identity_token>/steam/games.json
|
Retrieve Games |
TikTok · Retrieve videos information
/pull/identities/<identity_token>/tiktok/videos.json
|
Retrieve Videos |
Twitch · Retrieve all broadcaster's subscriptions
/pull/identities/<identity_token>/twitch/broadcaster/subscriptions.json
|
Retrieve Broadcaster's subscriptions |
Twitch · Retrieve channels information
/pull/identities/<identity_token>/twitch/channels.json
|
Retrieve Channels |
Twitch · Retrieve clips information
/pull/identities/<identity_token>/twitch/clips.json
|
Retrieve Clips |
Twitch · Retrieve games information
/pull/identities/<identity_token>/twitch/games.json
|
Retrieve Games |
Twitch · Retrieve most viewed games
/pull/identities/<identity_token>/twitch/games/top.json
|
Retrieve Top Games |
Twitch · Retrieve live streams
/pull/identities/<identity_token>/twitch/streams.json
|
Retrieve Streams |
Twitch · Retrieve users information
/pull/identities/<identity_token>/twitch/users.json
|
Retrieve Users |
Twitch · Retrieve follow relationships between two users
/pull/identities/<identity_token>/twitch/users/follow.json
|
Retrieve Users Follows |
Twitch · Retrieve videos information
/pull/identities/<identity_token>/twitch/videos.json
|
Retrieve Videos |
Twitter · Retrieve a user's followers
/pull/identities/<identity_token>/twitter/followers.json
|
Retrieve Followers |
Twitter · Retrieve a user's followings
/pull/identities/<identity_token>/twitter/followings.json
|
Retrieve Followings |
Twitter · Retrieve a user's tweets
/pull/identities/<identity_token>/twitter/tweets.json
|
Retrieve Tweets |
Twitter · Retrieve a user
/pull/identities/<identity_token>/twitter/user.json
|
Retrieve User |
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 |
YouTube · Retrieve a user's channel sections
/pull/identities/<identity_token>/youtube/channel/sections.json
|
Retrieve Channel Sections |
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_gamesinteger
|
Indicates how many games should be included in the resultset. The valid range is between 1 an 200.
Default: 50 Example: 200 |
pageinteger
|
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_idinteger
|
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 } ] } } } }