User
Get Social Data
TERMINAL 3 API
SIGN IN WITH TERMINAL 3
- Getting Started
- Authorization
- User
- User Credential
NOTIFICATION
VERIFIABLE CREDENTIAL SDK
- Getting Started
- Issuer SDK
- Verifier SDK
User
Get Social Data
This API is used for retrieving the social data of a user.
GET
/
v1
/
user
/
{user_id}
/
social_data
Copy
curl --request GET \
--url https://staging.terminal3.io/v1/user/{user_id}/social_data \
--header 'Authorization: Bearer <token>' \
--header 'x-api-token: <x-api-token>'
Copy
{
"steam": {
"steamid": "<string>",
"personaname": "<string>",
"profileurl": "<string>",
"avatar": "<string>",
"personastate": 123,
"timecreated": 123
},
"owned_games": {
"game_count": 0,
"games": [
{
"appid": "<string>",
"name": "<string>",
"playtime_2weeks": 0,
"playtime_forever": 0
}
]
},
"recent_played_games": {
"total_count": 0,
"games": [
{
"appid": "<string>",
"name": "<string>",
"playtime_2weeks": 0,
"playtime_forever": 0
}
]
},
"discord": {
"email_verified": true,
"guilds": [
{
"id": "<string>",
"name": "<string>",
"owner": true
}
]
},
"twitch": {
"username": "<string>",
"view_count": 0,
"follower_count": 0,
"followed_channels": {
"total": 0,
"broadcasters": [
{
"broadcaster_login": "<string>",
"broadcaster_name": "<string>",
"followed_at": "<string>"
}
]
}
}
}
Supported social connections:
- Steam
- Discord
- Twitch
- Twitter (X)
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Path Parameters
Required range:
x > 0
Response
200
application/json
Success
Steam data
Unique Steam user ID
Steam display name
URL to the user's Steam profile
URL to the user's avatar image
Current persona state (e.g. online/offline)
Timestamp of account creation
Owned games object
Total number of owned games
Recently played games object
Number of recently played games
List of recently played games
Twitch data
Twitch username
Total channel views
Number of followers
Channels followed by the user
Total number of followed channels
List of broadcasters followed
Copy
curl --request GET \
--url https://staging.terminal3.io/v1/user/{user_id}/social_data \
--header 'Authorization: Bearer <token>' \
--header 'x-api-token: <x-api-token>'
Copy
{
"steam": {
"steamid": "<string>",
"personaname": "<string>",
"profileurl": "<string>",
"avatar": "<string>",
"personastate": 123,
"timecreated": 123
},
"owned_games": {
"game_count": 0,
"games": [
{
"appid": "<string>",
"name": "<string>",
"playtime_2weeks": 0,
"playtime_forever": 0
}
]
},
"recent_played_games": {
"total_count": 0,
"games": [
{
"appid": "<string>",
"name": "<string>",
"playtime_2weeks": 0,
"playtime_forever": 0
}
]
},
"discord": {
"email_verified": true,
"guilds": [
{
"id": "<string>",
"name": "<string>",
"owner": true
}
]
},
"twitch": {
"username": "<string>",
"view_count": 0,
"follower_count": 0,
"followed_channels": {
"total": 0,
"broadcasters": [
{
"broadcaster_login": "<string>",
"broadcaster_name": "<string>",
"followed_at": "<string>"
}
]
}
}
}