Skip to main content
Fetch a post by its share code.

​
Behavior

  • Albums (posts with more than one file) include urls and isAlbum: true.
  • Video posts include thumbnailUrl, a generated still frame. For private posts it is a signed URL with the same 24-hour expiry as the file URL.
  • Use fileName from the files array when calling /deleteUpload to address a specific file. On albums, /deleteUpload removes just that file; on single-file posts it deletes the post.
  • Liking and commenting are Relay-only actions; see the Relay Reference to perform them.
  • Private posts are only visible to the owner. Requests for another user’s private post return 404.
  • URLs for private posts are returned as signed URLs with a 24-hour expiry. After that, request the endpoint again for a fresh signed URL.
  • Moderated posts are only fully returned to their owner, with moderated: true on the post. Requests by anyone else return 403 with moderated: true.

​
Examples

Fetch a post by code: 
curl -X GET "https://api.snipp.gg/posts/AbCd1234" \
  -H "api-key: YOUR_API_KEY"

​
Responses

Single-file post: 
{
  "post": {
    "code": "AbCd1234",
    "url": "https://i.snipp.gg/123456789012345678/a1b2c3d4e5f6789012345678abcdef01.png",
    "files": [
      {
        "index": 0,
        "fileName": "a1b2c3d4e5f6789012345678abcdef01.png",
        "url": "https://i.snipp.gg/123456789012345678/a1b2c3d4e5f6789012345678abcdef01.png"
      }
    ],
    "title": "Nice shot",
    "description": null,
    "postPrivacy": "public",
    "created": "2026-05-03T12:00:00Z",
    "views": 128,
    "likeCount": 42,
    "commentCount": 3,
    "file": {
      "size": 2487312,
      "size_formatted": "2.37 MB",
      "mime_type": "image/png",
      "dimensions": { "width": 1920, "height": 1080 }
    }
  }
}
Album post (includes urls and isAlbum): 
{
  "post": {
    "code": "AbCd1234",
    "url": "https://i.snipp.gg/123456789012345678/a1b2c3d4e5f6789012345678abcdef01.png",
    "urls": [
      "https://i.snipp.gg/123456789012345678/a1b2c3d4e5f6789012345678abcdef01.png",
      "https://i.snipp.gg/123456789012345678/b2c3d4e5f6789012345678abcdef0102.png"
    ],
    "isAlbum": true,
    "files": [
      {
        "index": 0,
        "fileName": "a1b2c3d4e5f6789012345678abcdef01.png",
        "url": "https://i.snipp.gg/123456789012345678/a1b2c3d4e5f6789012345678abcdef01.png"
      },
      {
        "index": 1,
        "fileName": "b2c3d4e5f6789012345678abcdef0102.png",
        "url": "https://i.snipp.gg/123456789012345678/b2c3d4e5f6789012345678abcdef0102.png"
      }
    ],
    "title": "Match highlights",
    "description": null,
    "postPrivacy": "public",
    "created": "2026-05-03T12:00:00Z",
    "views": 128,
    "likeCount": 42,
    "commentCount": 3,
    "file": {
      "size": 2487312,
      "size_formatted": "2.37 MB",
      "mime_type": "image/png",
      "dimensions": { "width": 1920, "height": 1080 }
    }
  }
}