Skip to main content
GET
List User Posts
List a user’s public posts, newest first. Use @me for your own.

Behavior

  • Only public posts are returned. Unlisted, private, draft, team, moderated and restricted posts never appear, including on @me. To list all of your own posts, use GET /posts.
  • Results are paginated: pass limit (1 to 100, default 30) and the previous page’s next_cursor as cursor.
  • Each item is a full post object. liked is whether you have liked it. moderated and restricted only appear on your own posts.
  • If the user is suspended, the response is 403 with type suspended. If the user has blocked you, it is 403 with type blocked.
  • Shares a rate limit bucket with GET /posts/{code}.

Examples

Next page:

Responses

Errors

Authorizations

relay-key
string
header
required

Your relay key from snipp.gg/settings/relay

Path Parameters

id
string
required

User ID, or @me for your own account.

Query Parameters

limit
integer
default:30

Items per page, 1 to 100.

Required range: 1 <= x <= 100
cursor
string

next_cursor from the previous page.

Response

Success

posts
object[]
required
has_more
boolean
required
next_cursor
string | null
required

Pass as cursor to fetch the next page. null on the last page.