Overview
The Snipp API is the public, third-party integration surface. Use it to upload media, manage your files, fetch posts, and build apps and SDKs on top of Snipp. For first-party clients (for example, the Snipp mobile app) that need account-level features such as the discover feed, likes, comments, blocking, and profile editing, use the Relay API instead.Base URL
The default base URL is:api.snipp.gg is proxied and load-balanced through Cloudflare. It picks the closest healthy region for you, so it’s the fastest option for most requests. Because Cloudflare proxies the traffic, uploads on this host are capped at 100 MB per request.
Regional endpoints
For uploads larger than 100 MB (or when you want to pin a specific region), use a regional endpoint instead. Regional endpoints are unproxied, so there is no 100 MB cap. Your file size limit is whatever your plan allows.
You can mix and match. Use
api.snipp.gg for everyday calls and switch to a regional endpoint only when an upload exceeds 100 MB.
To confirm which region served a request, hit GET /region on any host.
Authentication
Include your API key in theapi-key header with every request. See Authentication for details on locating your key and security best practices.
Endpoints
Looking for the discover feed, likes, comments, blocking, profile editing, avatar uploads, or anything that powers the full Snipp experience? See the Relay API.
Rate Limits
Rate limits apply per endpoint, not per account. See Rate Limits for the full table and details on handling429 responses.
Error Format
All errors return a JSON object with anerror field: