Guilded Client
  1. Users
Guilded Client
  • Intro
  • Community Libraries
  • Permissions Values
  • Reference
  • Webhooks
  • Chat
    • Get Embed for URL
      GET
    • Get Metadata
      GET
    • Get Channel Messages
      GET
    • Get Pinned Messages
      GET
  • List Items
    • Get List Items
      GET
    • Get List Item Note
      GET
  • Users
    • Modify User
      GET
    • Get Current User Verification
      GET
    • Send Verification Email
      POST
    • Verify Email Address
      GET
    • Get User Owned Steam Apps
      GET
    • Get User
      GET
    • Get User Profile
      GET
    • Get User Profile Posts
      GET
    • Get User Profile Post
      GET
    • Check Email Address
      GET
  • Teams
    • Get Team Presences
      GET
    • Get Team Info
      GET
    • Get Shallow Search Results
      GET
    • Submit Deep Search Query
      GET
    • Check Subdomain
      GET
    • Look up Teams
      GET
    • Check Team Name
      GET
  • Members
    • Get Team Members
    • Detail Team Members
    • Detail Voice Members
    • Sort Member IDs
    • Detail Team Bots
  • Channels
    • Get Team Channels
    • Get Team Channel
    • Get Group Archived Channels
    • Get Thread
    • Get Channel Threads
    • Get Channel Thread Count
    • Get Voice Channel Groups
  • Webhooks
    • Get Channel Webhooks
    • Execute Webhook
  • Guilded Meta
    • Redirect to App
    • Get App QR
  • Tournaments
    • Get Tournaments
    • Get Tournament
    • Get Tournament Info
    • Get Tournament Any Bracket Confirmed
    • Get Tournament from Invite
    • Get Tournament Hash Invites
    • Get Tournament Bracket Matches
    • Get Upcoming Tournaments
    • Get Completed Tournaments
    • Get Featured Tournaments
  • Websocket
    • Websocket
  1. Users

Get User Profile Posts

GET
/users/{userId}/posts
users
Get a list of posts on a given user's profile

Request

Path Params
userId
string 
required
Query Params
maxPosts
integer 
optional
The maximum number of posts to return in this response
>= 0<= 10
Default:
10
offset
integer 
optional
For pagination, the post index to start returning posts at
>= 0
Default:
0

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://www.guilded.gg/api/users//posts'

Responses

🟢200OK
application/json
Body
array of:
id
integer 
required
The ID of the post
title
string 
required
The title of the post
message
object (Content) 
read-onlyrequired
Generic structured content
object
enum<string> 
required
Allowed value:
value
Example:
value
document
object 
required
reactions
array [object {5}] 
optional
reactedUsers
array[string]
required
The user IDs who reacted with this emoji to the post
reactionId
integer 
deprecated
The ID of the reaction (always 0)
customReactionId
integer 
optional
The ID of the emoji
createdAt
string <date-time>
required
When the reaction was first added
customReaction
object (CustomReaction) 
required
The emoji shown for the reaction
Examples:
{"id":761262,"name":"frog-donut","png":"https://s3-us-west-2.amazonaws.com/www.guilded.gg/CustomReaction/02f8bf8e57fb08568e9260461f34390c-Full.webp?w=120&h=120","webp":"https://s3-us-west-2.amazonaws.com/www.guilded.gg/CustomReaction/02f8bf8e57fb08568e9260461f34390c-Full.webp?w=120&h=120","apng":null}{"id":90002582,"name":"hyperclap_gil","png":"/asset/Emojis/Custom/hyperclap_gil.png","webp":null,"apng":"/asset/Emojis/Custom/hyperclap_gil.gif"}{"id":90000027,"name":"face_with_rolling_eyes","png":null,"webp":null,"apng":null}
replies
array [object {9}]  | null 
optional
contentId
integer 
required
The ID of the post
id
integer 
required
The ID of the reply
message
object (Content) 
read-onlyoptional
The content of the reply
createdAt
string <date-time>
required
When the reply was created
createdBy
string 
required
The user ID who created the reply
userId
string 
required
The user ID who's page the reply is on
name
string 
required
The name of the user who created the reply
profilePicture
string <uri> | null 
optional
The avatar URL of the user who created the reply
editedAt
string <date-time> | null 
optional
When the reply was last updated
createdAt
string <date-time>
required
When the post was created
bumpedAt
string <date-time>
required
When the post was last bumped (could be equal to createdAt)
editedAt
string <date-time> | null 
optional
When the post was last updated
isShare
boolean 
optional
createdBy
string 
required
The user ID who created the post
userId
string 
required
The user ID who's page the post is on
publishUrl
string  | null 
optional
If the post is published, its globally-unique slug (a URL is constructable as: https://www.guilded.gg/p/{publishUrl})
publishedAt
string <date-time> | null 
optional
When the post was published, if ever
publishedBy
string  | null 
optional
The user ID who published the post, if it is published
createdByInfo
object 
optional
Info about the user who created the post
id
string 
required
The ID of the user
name
string 
required
The name of the user
profilePicture
string <uri> | null 
optional
The avatar URL of the user
profileBannerBlur
string <uri> | null 
optional
The banner URL of the user
Example
[
    {
        "id": 541583015,
        "title": "ATTENTION!",
        "message": {
            "object": "value",
            "document": {
                "object": "document",
                "data": {},
                "nodes": [
                    {
                        "object": "block",
                        "type": "paragraph",
                        "data": {},
                        "nodes": [
                            {
                                "object": "text",
                                "leaves": [
                                    {
                                        "object": "leaf",
                                        "text": "Made you look",
                                        "marks": []
                                    }
                                ]
                            }
                        ]
                    }
                ]
            }
        },
        "reactions": [
            {
                "reactedUsers": [
                    "EdVMVKR4"
                ],
                "reactionId": 0,
                "customReactionId": 90002582,
                "createdAt": "2022-08-13T19:30:04.620102+00:00",
                "customReaction": {
                    "id": 90002582,
                    "name": "hyperclap_gil",
                    "png": "/asset/Emojis/Custom/hyperclap_gil.png",
                    "webp": null,
                    "apng": "/asset/Emojis/Custom/hyperclap_gil.gif"
                }
            }
        ],
        "replies": null,
        "createdAt": "2022-07-11T21:40:14.315Z",
        "bumpedAt": "2022-07-11T21:40:14.315Z",
        "editedAt": null,
        "isShare": false,
        "createdBy": "EdVMVKR4",
        "userId": "F41Mp0Wc",
        "publishUrl": null,
        "publishedAt": null,
        "publishedBy": null,
        "createdByInfo": {
            "id": "EdVMVKR4",
            "name": "shay",
            "profilePicture": "https://s3-us-west-2.amazonaws.com/www.guilded.gg/UserAvatar/c2da767cf9795e7c73facc399159fefc-Large.png?w=450&h=450",
            "profileBannerBlur": "https://s3-us-west-2.amazonaws.com/www.guilded.gg/UserBanner/acaa9d0f78dd8cdd93f3ce44d14c0260-Hero.png?w=960&h=540"
        }
    }
]
🟠400invalid maxPosts
🔴500An unexpected error occurred An invalid user ID was provided to `userId`
Modified at 2024-06-10 14:16:22
Previous
Get User Profile
Next
Get User Profile Post
Built with