General

Overview

GET /games/gtav/career/overviewAjax?[nickname=(socialclub_name)&]slot=Freemode

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

GET /member/(socialclub_username)

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

GET /reference/profilefeed/(socialclub_userid)

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

GET /friends/GetFriendsJson?nickname=(socialclub_name)&pageNumber=(page_number)

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