General¶
Overview¶
Display general information of online character:
- Rank
- RP level
- Total playtime
- Current bank balance
- Active crew
- Competitive stats
- Cash earned
- Criminal records
- Favorite weapon
- Recent activities
Example request:
GET /games/gtav/career/overviewAjax?nickname=RestlessNarwhal&slot=Freemode HTTP/1.1 Host: socialclub.rockstargames.com
Example response (full):
<script> if(window.SCSettings) { window.SCSettings.platform = 12; window.SCSettings.urlformat = '/games/gtav/(platform)/career/overview'; window.SCSettings.nickname = ''; } </script> <div id="page-header" class="clearfix"> <div id="freemodeRank" class="page-section clearfix"> <div class="rankHex right-grad bronze"> <h3 style="font-size:54px">283</h3> <p style="text-align:center;"></p> </div> <div class="rankXP"> <div class="clearfix"> <h3 class="left">7.7M<span> RP</span></h3> </div> <div class="rankBar"> <h4>Play Time: 74d 13h 41m</h4> <div class="clearfix"> <div class="progress-bar"> <span style="width:20%">20%</span> </div>
Query Parameters: - slot – needs to be
Freeroam
- nickname (optional) – target (Social Club name) to query defaults to logged in Social Club player
Player name to player ID¶
For some requests you need to know the player ID instead of the (human readable) player name.
Example request:
GET /member/restlessnarwhal HTTP/1.1 Host: socialclub.rockstargames.com
Example response (full):
<!doctype html> <html class="no-js" lang="en"> <head data-template-set="html5-reset"> <meta charset="utf-8"> <meta http-equiv="x-ua-compatible" content="ie=edge"> <title>Rockstar Games Social Club - Member : restlessnarwhal</title> <meta name="title" content="Rockstar Games Social Club Member : restlessnarwhal"> <meta name="keywords" content="Rockstar Games, Social Club, Rockstar"> <meta name="description" content="Rockstar Games Social Club"> <meta name="google-site-verification" content=""> <meta name="author" content="Rockstar North"> <meta name="copyright" content="Rockstar Games 2017. All Rights Reserved."> <meta name="msapplication-config" content="none"> <meta name="DC.title" content="Rockstar Games Social Club"> <meta name="DC.subject" content="Rockstar Games, Social Club, Rockstar"> <meta name="DC.creator" content="Rockstar North"> <meta http-equiv="cleartype" content="on"> <meta name="robots" content="all">
Parameters: - socialclub_username – target (Social Club name) to query
Note: Data is hidden somewhere in a
<script>
tag ("uid":36222077
)
Profile feed¶
Extract the profile feed from a certain Social Club user. Make sure to find out the ID first.
Example request:
GET /reference/profilefeed/47990204 HTTP/1.1 Host: socialclub.rockstargames.com
Example response (full):
{ "sl_translate": "ugcType,accomplishmentDesc,platform,accomplishmentName", "count": 15, "activities": [ { "metaId": 0, "numLikes": 0, "type": "MISSION_PUBLISHED", "actorMeta": { "url": "", "image": "GTAO/gtao.png", "type": "Person", "id": "47990204", "name": "RestlessNarwhal" }, "comments": [], "activityId": "2960911887742244965", "time": 1482705466, "actorId": "47990204", "data": { "body": "", "toMeta": { "url": "", "image": "GTAO/gtao.png", "type": "Person", "id": "47990204", "name": "RestlessNarwhal" }, "meta": { "name": "Empty lobby race",
Parameters: - socialclub_userid – target (Social Club ID) to query
Friends list¶
List all friends of a given Social Club username. Lists 12 entries per page.
Example request:
GET /friends/GetFriendsJson?nickname=restlessnarwhal&pageNumber=0 HTTP/1.1 Host: socialclub.rockstargames.com
Example response (full):
{ "TotalCount": 12, "Count": 0, "ForRockstarId": 47990204, "ViewerRockstarId": 0, "PageIndex": 0, "PageSize": 12, "RockstarAccounts": [ { "RockstarId": 37929140, "Name": "Bearhunter72", "AvatarUrl": "n/bearhunter72", "Relationship": "Friend", "AllowAddFriend": false, "MutualFriendCount": 0, "IsGamertagHidden": false, "PrimaryClan": { "Id": 7088603, "Name": "Hunter Crew Germany", "Tag": "Hunt", "IsOpenClan": false, "IsSystemClan": false, "IsPrivateClan": true, "IsFounderClan": false, "Color": "#1c2a99", "RankOrder": 0 }, "AllowAdd": false, "AllowDelete": false, "AllowBlock": false,
Query Parameters: - socialclub_name – target (Social Club username) to query
- page_number – page number, starting with
0
Search for player¶
-
GET
/friends/MemberSearch?searchTerm=
(search_term)¶ Search for a specific player/username.
Example request:
GET /friends/MemberSearch?searchTerm=restless HTTP/1.1 Host: socialclub.rockstargames.com
Example response (full):
{ "HasMore": true, "MatchedUsers": [ { "RockstarId": 26182414, "AvatarUrl": "n/jakelawrence", "DisplayName": "Jakelawrence", "UserName": "Narwhal Blood", "AllowAdd": true, "ServiceClass": "XBOX", "ServiceDisplayName": "Xbox Live Gamertag", "PrivacyLevel": "Everyone", "AllowDelete": false, "AllowCancel": false, "AllowMsg": true, "Relationship": "None" }, { "RockstarId": 30584411, "AvatarUrl": "n/stewie200", "DisplayName": "stewie200", "UserName": "Narwhal Facial", "AllowAdd": true, "ServiceClass": "XBOX", "ServiceDisplayName": "Xbox Live Gamertag", "PrivacyLevel": "Everyone", "AllowDelete": false, "AllowCancel": false, "AllowMsg": true, "Relationship": "None"
Query Parameters: - search_term – the term you want to search for