Upload Files

curl --request POST \
  --url https://api.snipp.gg/upload \
  --header 'Content-Type: multipart/form-data' \
  --header 'api-key: <api-key>' \
  --form file=@example-file \
  --form 'title=<string>' \
  --form 'description=<string>'

import requests

url = "https://api.snipp.gg/upload"

files = { "file": ("example-file", open("example-file", "rb")) }
payload = {
    "title": "<string>",
    "description": "<string>"
}
headers = {"api-key": "<api-key>"}

response = requests.post(url, data=payload, files=files, headers=headers)

print(response.text)

const form = new FormData();
form.append('file', '<string>');
form.append('title', '<string>');
form.append('description', '<string>');

const options = {method: 'POST', headers: {'api-key': '<api-key>'}};

options.body = form;

fetch('https://api.snipp.gg/upload', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.snipp.gg/upload",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"title\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"description\"\r\n\r\n<string>\r\n-----011000010111000001101001--",
  CURLOPT_HTTPHEADER => [
    "Content-Type: multipart/form-data",
    "api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.snipp.gg/upload"

	payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"title\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"description\"\r\n\r\n<string>\r\n-----011000010111000001101001--")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.snipp.gg/upload")
  .header("api-key", "<api-key>")
  .body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"title\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"description\"\r\n\r\n<string>\r\n-----011000010111000001101001--")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.snipp.gg/upload")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["api-key"] = '<api-key>'
request.body = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"title\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"description\"\r\n\r\n<string>\r\n-----011000010111000001101001--"

response = http.request(request)
puts response.read_body

{
  "url": "https://i.snipp.gg/123456789012345678/a1b2c3d4e5f6789012345678abcdef01.png",
  "post": {
    "code": "AbCd1234",
    "url": "https://snipp.gg/p/AbCd1234",
    "title": "my gaming POV",
    "description": null,
    "privacy": "unlisted",
    "created_at": "2026-10-01T09:15:27.204Z",
    "view_count": 0,
    "like_count": 0,
    "comment_count": 0,
    "priority": false,
    "file_count": 1,
    "files": [
      {
        "name": "a1b2c3d4e5f6789012345678abcdef01.png",
        "url": "https://i.snipp.gg/123456789012345678/a1b2c3d4e5f6789012345678abcdef01.png",
        "size": 2487312,
        "mime_type": "image/png",
        "width": 1920,
        "height": 1080,
        "thumbnail_url": null
      }
    ],
    "team_id": null,
    "author": {
      "id": "123456789012345678",
      "username": "playerone",
      "nickname": "Player One",
      "avatar": "https://i.snipp.gg/avatars/123456789012345678/7e1f0a2b3c4d5e6f708192a3b4c5d6e7.png",
      "verified": false,
      "plan": "plus"
    },
    "liked": false,
    "moderated": false,
    "restricted": false
  }
}

POST

upload

Upload Files

curl --request POST \
  --url https://api.snipp.gg/upload \
  --header 'Content-Type: multipart/form-data' \
  --header 'api-key: <api-key>' \
  --form file=@example-file \
  --form 'title=<string>' \
  --form 'description=<string>'

import requests

url = "https://api.snipp.gg/upload"

files = { "file": ("example-file", open("example-file", "rb")) }
payload = {
    "title": "<string>",
    "description": "<string>"
}
headers = {"api-key": "<api-key>"}

response = requests.post(url, data=payload, files=files, headers=headers)

print(response.text)

const form = new FormData();
form.append('file', '<string>');
form.append('title', '<string>');
form.append('description', '<string>');

const options = {method: 'POST', headers: {'api-key': '<api-key>'}};

options.body = form;

fetch('https://api.snipp.gg/upload', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.snipp.gg/upload",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"title\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"description\"\r\n\r\n<string>\r\n-----011000010111000001101001--",
  CURLOPT_HTTPHEADER => [
    "Content-Type: multipart/form-data",
    "api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.snipp.gg/upload"

	payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"title\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"description\"\r\n\r\n<string>\r\n-----011000010111000001101001--")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.snipp.gg/upload")
  .header("api-key", "<api-key>")
  .body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"title\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"description\"\r\n\r\n<string>\r\n-----011000010111000001101001--")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.snipp.gg/upload")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["api-key"] = '<api-key>'
request.body = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"title\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"description\"\r\n\r\n<string>\r\n-----011000010111000001101001--"

response = http.request(request)
puts response.read_body

{
  "url": "https://i.snipp.gg/123456789012345678/a1b2c3d4e5f6789012345678abcdef01.png",
  "post": {
    "code": "AbCd1234",
    "url": "https://snipp.gg/p/AbCd1234",
    "title": "my gaming POV",
    "description": null,
    "privacy": "unlisted",
    "created_at": "2026-10-01T09:15:27.204Z",
    "view_count": 0,
    "like_count": 0,
    "comment_count": 0,
    "priority": false,
    "file_count": 1,
    "files": [
      {
        "name": "a1b2c3d4e5f6789012345678abcdef01.png",
        "url": "https://i.snipp.gg/123456789012345678/a1b2c3d4e5f6789012345678abcdef01.png",
        "size": 2487312,
        "mime_type": "image/png",
        "width": 1920,
        "height": 1080,
        "thumbnail_url": null
      }
    ],
    "team_id": null,
    "author": {
      "id": "123456789012345678",
      "username": "playerone",
      "nickname": "Player One",
      "avatar": "https://i.snipp.gg/avatars/123456789012345678/7e1f0a2b3c4d5e6f708192a3b4c5d6e7.png",
      "verified": false,
      "plan": "plus"
    },
    "liked": false,
    "moderated": false,
    "restricted": false
  }
}

Upload between 1 and 50 files in one request. Every upload creates a post. Two or more files are grouped into one album post unless you ask for individual posts.

Headers

Header	Required	Description
`api-key`	Yes	Your API key, or a team access key
`post-privacy`	No	`public`, `unlisted` or `private`. Omitted means `private`. Any other value returns `400`.
`post-type`	No	`album` (default) or `individual`. Only matters for two or more files.
`include-metadata`	No	`true` keeps file metadata. Omitted or `false` strips it.
`priority`	No	`false` opts videos out of priority (adaptive) streaming. Omitted or `true` keeps it on, subject to your remaining priority minutes.

Header values are trimmed and case-insensitive. Boolean headers accept only true or false; anything else returns 400.

Form fields

Field	Required	Description
`file`	Yes	The file. Repeat the field for up to 50 files.
`title`	No	Up to 30 characters. Longer titles return `400`.
`description`	No	Up to 200 characters. Longer descriptions return `400`.

Behavior

One file: creates one post. post-type is ignored.
Two or more files: creates one album post, or one post per file with post-type: individual.
Response shape: when one post is created the body is {url, post}, where url is the direct URL of the post’s first file (post.files[0].url). When several posts are created (individual), the body is {posts}. An album where only one file survived also returns {url, post}.
url and post.url: the top-level url is the direct file on i.snipp.gg. post.url is the share page, https://snipp.gg/p/{code}, or https://{domain}/{code} when the account has picked another link domain.
Private posts: file URLs are signed and expire after 24 hours. Fetch the post again with GET /posts/{code} for fresh ones.
Videos: .mp4, .mov and .mkv are remuxed to MP4 with +faststart, so .mov and .mkv come back with an .mp4 name. A file that cannot be remuxed is rejected as corrupt. Uploaded videos get a thumbnail in files[].thumbnail_url. See File Types.
Metadata: stripped by default. PNG, JPG, WebP and GIF are stripped at any size without re-encoding, so pixels are untouched; JPG and WebP keep their orientation and GIF keeps its animation. Videos lose container metadata during the remux.
Priority streaming: eligible videos use adaptive streaming by default and spend priority minutes. post.priority is true when a video was queued for it. Minutes are charged after the response; if your budget runs out first, the video falls back to standard quality and the post later reports priority: false.
Partial failures: files that fail are listed in failed, each with its zero-based index and an error object. The stored files are still returned with 200.
Every file failed: a one-file request returns that file’s error at the top level, with 413 for file_too_large, 500 for internal and 400 otherwise. A request with several files returns 400 with type upload_failed and the same failed array. See Errors.
Weekly quota: a file that would exceed your weekly usage limit fails with type quota_exceeded, carrying quota, used and resets_at.
Size limits: a file over your plan’s per-file limit fails with type file_too_large. A request whose declared Content-Length is already larger than your weekly quota (or 50 times the per-file limit) is refused with 413 before any file is read.
Team keys: posts are always created private, whatever post-privacy says, and count against the team’s quota. A lapsed team returns 403 with type forbidden.
New posts are scanned automatically. A flagged post is moderated after the response.

Examples

One file:

curl -X POST "https://api.snipp.gg/upload" \
  -H "api-key: YOUR_API_KEY" \
  -H "post-privacy: unlisted" \
  -F "title=my gaming POV" \
  -F "file=@screenshot.png"

An album:

curl -X POST "https://api.snipp.gg/upload" \
  -H "api-key: YOUR_API_KEY" \
  -H "post-privacy: public" \
  -F "title=Match highlights" \
  -F "file=@photo1.png" \
  -F "file=@photo2.png"

One post per file:

curl -X POST "https://api.snipp.gg/upload" \
  -H "api-key: YOUR_API_KEY" \
  -H "post-type: individual" \
  -F "file=@image1.png" \
  -F "file=@image2.png" \
  -F "file=@image3.png"

Responses

One file:

{
  "url": "https://i.snipp.gg/123456789012345678/a1b2c3d4e5f6789012345678abcdef01.png",
  "post": {
    "code": "AbCd1234",
    "url": "https://snipp.gg/p/AbCd1234",
    "title": "my gaming POV",
    "description": null,
    "privacy": "unlisted",
    "created_at": "2026-10-01T09:15:27.204Z",
    "view_count": 0,
    "like_count": 0,
    "comment_count": 0,
    "priority": false,
    "file_count": 1,
    "files": [
      {
        "name": "a1b2c3d4e5f6789012345678abcdef01.png",
        "url": "https://i.snipp.gg/123456789012345678/a1b2c3d4e5f6789012345678abcdef01.png",
        "size": 2487312,
        "mime_type": "image/png",
        "width": 1920,
        "height": 1080,
        "thumbnail_url": null
      }
    ],
    "team_id": null,
    "author": {
      "id": "123456789012345678",
      "username": "playerone",
      "nickname": "Player One",
      "avatar": "https://i.snipp.gg/avatars/123456789012345678/7e1f0a2b3c4d5e6f708192a3b4c5d6e7.png",
      "verified": false,
      "plan": "plus"
    },
    "liked": false,
    "moderated": false,
    "restricted": false
  }
}

A private upload. The file URLs are signed:

{
  "url": "https://i.snipp.gg/123456789012345678/a1b2c3d4e5f6789012345678abcdef01.png?e=1790035200&s=9f2c4b7d1e8a3f6c0b5d2e9a7c4f1b8e3d6a0c9f2b5e8d1a4c7f0b3e6d9a2c5f",
  "post": {
    "code": "AbCd1234",
    "url": "https://snipp.gg/p/AbCd1234",
    "title": null,
    "description": null,
    "privacy": "private",
    "created_at": "2026-10-01T09:15:27.204Z",
    "view_count": 0,
    "like_count": 0,
    "comment_count": 0,
    "priority": false,
    "file_count": 1,
    "files": [
      {
        "name": "a1b2c3d4e5f6789012345678abcdef01.png",
        "url": "https://i.snipp.gg/123456789012345678/a1b2c3d4e5f6789012345678abcdef01.png?e=1790035200&s=9f2c4b7d1e8a3f6c0b5d2e9a7c4f1b8e3d6a0c9f2b5e8d1a4c7f0b3e6d9a2c5f",
        "size": 2487312,
        "mime_type": "image/png",
        "width": 1920,
        "height": 1080,
        "thumbnail_url": null
      }
    ],
    "team_id": null,
    "author": {
      "id": "123456789012345678",
      "username": "playerone",
      "nickname": "Player One",
      "avatar": "https://i.snipp.gg/avatars/123456789012345678/7e1f0a2b3c4d5e6f708192a3b4c5d6e7.png",
      "verified": false,
      "plan": "plus"
    },
    "liked": false,
    "moderated": false,
    "restricted": false
  }
}

An album:

{
  "url": "https://i.snipp.gg/123456789012345678/a1b2c3d4e5f6789012345678abcdef01.png",
  "post": {
    "code": "AlBm5678",
    "url": "https://snipp.gg/p/AlBm5678",
    "title": "Match highlights",
    "description": null,
    "privacy": "public",
    "created_at": "2026-10-01T09:15:27.204Z",
    "view_count": 0,
    "like_count": 0,
    "comment_count": 0,
    "priority": false,
    "file_count": 2,
    "files": [
      {
        "name": "a1b2c3d4e5f6789012345678abcdef01.png",
        "url": "https://i.snipp.gg/123456789012345678/a1b2c3d4e5f6789012345678abcdef01.png",
        "size": 2487312,
        "mime_type": "image/png",
        "width": 1920,
        "height": 1080,
        "thumbnail_url": null
      },
      {
        "name": "b2c3d4e5f6789012345678abcdef0102.png",
        "url": "https://i.snipp.gg/123456789012345678/b2c3d4e5f6789012345678abcdef0102.png",
        "size": 1843210,
        "mime_type": "image/png",
        "width": 1280,
        "height": 720,
        "thumbnail_url": null
      }
    ],
    "team_id": null,
    "author": {
      "id": "123456789012345678",
      "username": "playerone",
      "nickname": "Player One",
      "avatar": "https://i.snipp.gg/avatars/123456789012345678/7e1f0a2b3c4d5e6f708192a3b4c5d6e7.png",
      "verified": false,
      "plan": "plus"
    },
    "liked": false,
    "moderated": false,
    "restricted": false
  }
}

Individual posts, where the third file went over the weekly quota:

{
  "posts": [
    {
      "code": "InDv0001",
      "url": "https://snipp.gg/p/InDv0001",
      "title": null,
      "description": null,
      "privacy": "public",
      "created_at": "2026-10-01T09:15:27.204Z",
      "view_count": 0,
      "like_count": 0,
      "comment_count": 0,
      "priority": false,
      "file_count": 1,
      "files": [
        {
          "name": "a1b2c3d4e5f6789012345678abcdef01.png",
          "url": "https://i.snipp.gg/123456789012345678/a1b2c3d4e5f6789012345678abcdef01.png",
          "size": 2487312,
          "mime_type": "image/png",
          "width": 1920,
          "height": 1080,
          "thumbnail_url": null
        }
      ],
      "team_id": null,
      "author": {
        "id": "123456789012345678",
        "username": "playerone",
        "nickname": "Player One",
        "avatar": "https://i.snipp.gg/avatars/123456789012345678/7e1f0a2b3c4d5e6f708192a3b4c5d6e7.png",
        "verified": false,
        "plan": "plus"
      },
      "liked": false,
      "moderated": false,
      "restricted": false
    },
    {
      "code": "InDv0002",
      "url": "https://snipp.gg/p/InDv0002",
      "title": null,
      "description": null,
      "privacy": "public",
      "created_at": "2026-10-01T09:15:27.204Z",
      "view_count": 0,
      "like_count": 0,
      "comment_count": 0,
      "priority": false,
      "file_count": 1,
      "files": [
        {
          "name": "b2c3d4e5f6789012345678abcdef0102.png",
          "url": "https://i.snipp.gg/123456789012345678/b2c3d4e5f6789012345678abcdef0102.png",
          "size": 1843210,
          "mime_type": "image/png",
          "width": 1280,
          "height": 720,
          "thumbnail_url": null
        }
      ],
      "team_id": null,
      "author": {
        "id": "123456789012345678",
        "username": "playerone",
        "nickname": "Player One",
        "avatar": "https://i.snipp.gg/avatars/123456789012345678/7e1f0a2b3c4d5e6f708192a3b4c5d6e7.png",
        "verified": false,
        "plan": "plus"
      },
      "liked": false,
      "moderated": false,
      "restricted": false
    }
  ],
  "failed": [
    {
      "index": 2,
      "error": {
        "type": "quota_exceeded",
        "message": "Weekly usage limit exceeded.",
        "quota": 21474836480,
        "used": 21470000000,
        "resets_at": "2026-10-04T16:20:00.000Z"
      }
    }
  ]
}

Every file failed:

{
  "error": {
    "type": "upload_failed",
    "message": "All files failed to upload.",
    "failed": [
      {
        "index": 0,
        "error": {
          "type": "unsupported_type",
          "message": "Unsupported file type."
        }
      },
      {
        "index": 1,
        "error": {
          "type": "file_too_large",
          "message": "File size exceeds the 50 MB limit."
        }
      }
    ]
  }
}

Errors

Status	Type	When
`400`	`invalid_request`	Bad header value, no file, more than 50 files, title or description too long, or a corrupt video
`400`	`unsupported_type`	The only file is not a supported type
`400`	`quota_exceeded`	The only file would exceed your weekly quota
`400`	`upload_failed`	Every file of a multi-file request failed
`401`	`unauthorized`	Missing or invalid key
`403`	`suspended`	Your account, or the team owner’s, is suspended
`403`	`forbidden`	The team’s subscription has lapsed
`413`	`file_too_large`	The only file is over your limit, or the declared request size is
`429`	`rate_limited`	More than 20 uploads in 30 seconds
`500`	`internal`	The upload could not be saved

Authorizations

api-key

string

header

required

Your API key from an app on snipp.gg/settings/apps

Headers

post-privacy

enum<string>

default:private

public, unlisted or private. Omitted means private.

Available options:

public,

unlisted,

private

post-type

enum<string>

default:album

album or individual. Only matters for two or more files.

Available options:

album,

individual

include-metadata

boolean

default:false

true keeps file metadata. Omitted or false strips it.

priority

boolean

default:true

false opts videos out of priority (adaptive) streaming.

Body

multipart/form-data

file

file[]

required

1 to 50 files. Repeat the file field.

title

string

Up to 30 characters.

Maximum string length: 30

description

string

Up to 200 characters.

Maximum string length: 200

Response

Success

Option 1
Option 2

One post was created.

url

string

required

Direct URL of the first file (post.files[0].url).

post

object

required

Show child attributes

failed

object[]

Show child attributes

Overview

Uploads

Posts

Users

Meta

Upload Files

Headers

Form fields

Behavior

Examples

Responses

Errors

Authorizations

Headers

Body

Response

​Headers

​Form fields

​Behavior

​Examples

​Responses

​Errors

Authorizations

Headers

Body

Response

Headers

Form fields

Behavior

Examples

Responses

Errors