Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.snipp.gg/llms.txt

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

Browse public uploads from the community. Returns up to 50 items, newest first.

​
Behavior

  • Only public posts are returned. unlisted and private posts never appear in Discover.
  • Moderated posts are excluded.
  • Blocked users are filtered both ways: posts from users you have blocked, and posts from users who have blocked you, are excluded.
  • Hits to this endpoint count a view toward each returned post. Views are deduplicated per IP and post: up to 3 counted views per IP per post per hour.
  • Files that no longer exist on the CDN are skipped silently.

​
Examples

curl -X GET "https://relay.snipp.gg/discover" \
  -H "relay-key: YOUR_RELAY_KEY"

​
Responses

{
  "uploads": [
    {
      "url": "https://i.snipp.gg/123456789012345678/abc123.png",
      "code": "AbCd1234",
      "title": "Nice shot",
      "description": null,
      "created": "2026-05-03T12:00:00Z",
      "views": 128,
      "likeCount": 42,
      "commentCount": 3,
      "author": "Player One",
      "authorId": "123456789012345678",
      "authorUsername": "playerone",
      "authorAvatar": "https://cdn.snipp.gg/avatars/123456789012345678/avatar.png",
      "authorPlus": true,
      "isVerified": false
    }
  ]
}
Each item is the primary file of its post. To fetch the full album, call GET /posts/{code} with the code field.