Skip to main content

​
Get started in three steps

Make your first API call and upload a file to Snipp.

​
Step 1: Get your API key

  1. Sign in at snipp.gg.
  2. Open Settings and navigate to the API section.
  3. Copy your API key. You’ll include it in the api-key header with every request.
Never share your API key or commit it to version control. Store it in an environment variable in production.

​
Step 2: Verify your setup

Test your API key by fetching your own profile: 
curl -X GET "https://api.snipp.gg/users/@me" \
  -H "api-key: YOUR_API_KEY"
A successful response returns your user object: 
{
  "user": {
    "id": "123456789012345678",
    "username": "yourname",
    "plus": false,
    "verified": false,
    "badges": { ... },
    "uploads": 0
  }
}

​
Step 3: Upload a file

Upload an image or video to your account: 
curl -X POST "https://api.snipp.gg/upload" \
  -H "api-key: YOUR_API_KEY" \
  -H "post-privacy: unlisted" \
  -F "file=@/path/to/image.png"
The response includes a direct URL to your file and a post object with share metadata: 
{
  "message": "Upload successful!",
  "url": "https://i.snipp.gg/123456789012345678/abc123.png",
  "post": {
    "code": "AbCd1234",
    "url": "https://snipp.gg/share/AbCd1234",
    "postPrivacy": "unlisted"
  }
}

​
Albums

Upload multiple files in one request to create an album. Just add more -F "file=@..." fields: 
curl -X POST "https://api.snipp.gg/upload" \
  -H "api-key: YOUR_API_KEY" \
  -H "posttitle: My album" \
  -F "file=@photo1.png" \
  -F "file=@photo2.png"
Albums are the default when sending 2+ files. To create separate posts instead, add -H "post-type: individual".

​
Privacy options

Control who can see your uploads by setting the post-privacy header:
ValueVisibility
privateOnly you can view it
unlistedAnyone with the share link can view it (default)
publicVisible to everyone and eligible for the Discover feed

​
Next steps

Authentication

Learn how the API key header works and security best practices.

API reference

Explore all available endpoints and response schemas.

File types

See supported formats and size limits per plan.

Rate limits

Understand request limits and how to handle throttling.