Skip to main content
Fetch either your own profile (@me) or another user’s public profile.

Behavior

  • id=@me returns your full account profile, including apiKey, keyHasUploadsAccess, limits, and uploads.
  • id=<userId> returns a public-safe profile for that user.
  • badges is always included and follows this order: verified, staff, partner, bugHunterTier, translator, plus.
  • bugHunterTier is an integer from 0 to 2: 0 is no badge, 1 is Bug Hunter, 2 is Elite Bug Hunter.
  • includePosts controls publicUploads.
  • includePosts defaults to false for @me and true for non-self requests.
  • postsLimit limits publicUploads to 1 to 50 (default 50).
  • Non-self profiles include a blockedByYou boolean indicating whether you have blocked that user.
  • If the target user has blocked you, the endpoint returns 403 with "You have been blocked by this user.".

Examples

Fetch your own profile:
curl -X GET "https://api.snipp.gg/users/@me" \
  -H "api-key: YOUR_API_KEY"
Fetch another profile with a smaller public uploads payload:
curl -X GET "https://api.snipp.gg/users/USER_ID?includePosts=true&postsLimit=10" \
  -H "api-key: YOUR_API_KEY"

Responses

@me returns your full account profile, including apiKey, keyHasUploadsAccess, and limits.
{
  "user": {
    "id": "123456789012345678",
    "username": "playerone",
    "avatar": "https://i.snipp.gg/avatars/123456789012345678/avatar.png",
    "banner": "https://i.snipp.gg/banners/123456789012345678/banner.png",
    "nickname": "Player One",
    "bio": "Building things at Snipp",
    "socials": { "github": "https://github.com/playerone" },
    "plus": true,
    "enterprise": false,
    "verified": false,
    "staff": false,
    "partner": false,
    "bugHunterTier": 0,
    "translator": false,
    "suspended": false,
    "created": "2026-01-04T09:30:00Z",
    "customEmbed": null,
    "apiKey": "aB3xK9mP2qR7sT1vW4yZ6cD8fG0hJ5kL",
    "limits": {
      "plan": "plus",
      "maxFileSize": null,
      "usage": {
        "used": 5242880,
        "quota": 21474836480,
        "usedPercent": 0.02,
        "windowStart": "2026-05-12T00:00:00Z",
        "windowEnd": "2026-05-19T00:00:00Z",
        "resetsInSeconds": 345600
      }
    }
  }
}
A non-self request returns a public-safe profile with blockedByYou and (by default) publicUploads.
{
  "user": {
    "id": "987654321098765432",
    "username": "playertwo",
    "avatar": "https://i.snipp.gg/avatars/987654321098765432/avatar.png",
    "banner": null,
    "nickname": "Player Two",
    "bio": null,
    "socials": null,
    "plus": false,
    "enterprise": false,
    "verified": false,
    "staff": false,
    "partner": false,
    "bugHunterTier": 1,
    "translator": false,
    "created": "2026-02-18T14:00:00Z",
    "customEmbed": null,
    "blockedByYou": false,
    "publicUploads": [
      {
        "code": "AbCd1234",
        "url": "https://i.snipp.gg/987654321098765432/a1b2c3d4e5f6789012345678abcdef01.png",
        "postPrivacy": "public"
      }
    ]
  }
}