Skip to main content

Documentation Index

Fetch the complete documentation index at: https://rocks.docs.rive.wtf/llms.txt

Use this file to discover all available pages before exploring further.

Every API key is tied to one IP. To apply for a key, DM southctrl on Discord.
Use the endpoint path below, replace the required params, and send Authorization: Bearer YOUR_API_KEY.

​
Quick Start

1

Choose a username

Use the PSN username you want to look up.
2

Call the player route

Send the request with your Bearer token.
3

Use the response

Read profile info, trophy data, and presence from the result.
Good for PSN profile cards, trophy trackers, and player presence tools.

​
Get Player Info

Get detailed information about a PSN player by their username, including trophy counts and online presence.

​
Endpoint

GET /api/psn/{username}

​
Path Parameters

​
username
string
required
PSN username.

​
Example Request

cURL
curl -X GET "https://rocks.rive.wtf/api/psn/PowerPyx" \
  -H "Authorization: Bearer YOUR_API_KEY"
JavaScript
const response = await fetch('https://rocks.rive.wtf/api/psn/PowerPyx', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});
const data = await response.json();
console.log(data);
Python
import requests

headers = {'Authorization': 'Bearer YOUR_API_KEY'}
response = requests.get(
    'https://rocks.rive.wtf/api/psn/PowerPyx',
    headers=headers
)
print(response.json())

​
Example Response

{
  "username": "PowerPyx",
  "avatar": "http://static-resource.np.community.playstation.net/avatar_m/WWS_E/E0002_m.png",
  "about_me": null,
  "languages": ["de-DE", "en-US"],
  "is_plus": true,
  "is_verified": false,
  "online_status": "offline",
  "last_online": "2026-04-10T18:22:00Z",
  "current_game": null,
  "current_platform": null,
  "level": 635,
  "level_progress": 92,
  "trophy_tier": 7,
  "trophies": 19389,
  "platinum": 302,
  "gold": 1357,
  "silver": 4473,
  "bronze": 13257,
  "recent_titles": [
    {
      "title": "God of War Ragnarök",
      "title_id": "PPSA01284_00",
      "platforms": ["PS5"],
      "cover": "https://image.api.playstation.com/...",
      "play_count": 1,
      "play_duration": "12:34:00",
      "first_played": "2026-03-01T10:00:00+00:00",
      "last_played": "2026-03-15T18:00:00+00:00"
    }
  ]
}

​
Response Fields

​
username
string
The player’s PSN username as it appears on their profile.
​
avatar
string
URL to the player’s PSN avatar image.
​
about_me
string | null
The player’s profile bio. null if not set.
​
languages
array of strings
Languages set on the player’s profile (e.g. "en-US", "de-DE").
​
is_plus
boolean | null
Whether the player has an active PlayStation Plus subscription.
​
is_verified
boolean | null
Whether the player is an officially verified PSN account.
​
online_status
string | null
The player’s current online status. null if their presence is private.
​
last_online
string | null
ISO 8601 timestamp of when the player was last online. null if private.
​
current_game
string | null
Title of the game the player is currently playing. null if offline or private.
​
current_platform
string | null
Platform the player is currently active on (e.g. "PS5", "PS4"). null if offline or private.
​
level
integer | null
The player’s overall trophy level.
​
level_progress
integer | null
Percentage progress towards the next trophy level (0–100).
​
trophy_tier
integer | null
The tier bracket the player’s trophy level falls within (1–8).
​
trophies
integer | null
Total number of trophies earned across all types.
​
platinum
integer | null
Number of platinum trophies earned.
​
gold
integer | null
Number of gold trophies earned.
​
silver
integer | null
Number of silver trophies earned.
​
bronze
integer | null
Number of bronze trophies earned.
​
recent_titles
array
List of recently played titles. Empty if the player’s game library is private.
Presence data (online_status, last_online, current_game, current_platform) and recent_titles will be empty or null if the player has set their profile to private.