Overview
Uploads are the core content type in FoN. Users can upload images or submit links for the community to vote on.
Upload Types
FoN supports three types of uploads:
Image Upload
Upload an image file directly to FoN.
Supported formats: JPEG, PNG, GIF, WebP
Size limit: 10 MB
curl -X POST https://api.fucksornot.com/api/v1/upload \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-F "upload_type=image" \
-F "description=Check out this gadget" \
-F "file=@/path/to/image.jpg"
Image URL
Submit a URL to an image hosted elsewhere. FoN will fetch and process the image.
curl -X POST https://api.fucksornot.com/api/v1/upload \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-F "upload_type=image_url" \
-F "description=Cool find from the web" \
-F "image_url=https://example.com/image.jpg"
Link
Submit a link to external content. FoN supports rich embeds for popular platforms.
Supported platforms:
- Bluesky
- Instagram
- Threads
- YouTube
- Tumblr
- Spotify
curl -X POST https://api.fucksornot.com/api/v1/upload \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-F "upload_type=link" \
-F "description=Great video" \
-F "external_url=https://youtube.com/watch?v=..."
Upload Properties
| Property | Type | Description |
|---|
id | UUID | Unique identifier |
user_id | UUID | Owner’s user ID |
filename | string | Stored filename (images only) |
original_name | string | Original filename |
description | string | User-provided description (max 500 chars) |
upload_type | string | image or link |
external_url | string | URL for links |
upvotes | integer | Number of “fucks” votes |
downvote_count | integer | Number of “does not fuck” votes |
is_private | boolean | Privacy status |
tags | array | Associated tags |
created_at | timestamp | Creation time |
Duplicate Detection
FoN automatically detects duplicate image uploads using content hashing. If you upload an image that already exists, you’ll receive:
{
"duplicate": true,
"existingUploadId": "uuid-of-existing-upload",
"message": "This image has already been uploaded"
}
Image Processing
Uploaded images are automatically:
- Validated - Checked for supported format and size
- Analyzed - Scanned for content (human detection)
- Optimized - Converted to efficient formats
- Thumbnailed - Generated preview versions
Privacy
Uploads can be set as private:
curl -X PATCH https://api.fucksornot.com/api/upload/UPLOAD_ID/privacy \
-H "Authorization: Bearer YOUR_JWT_TOKEN" \
-H "Content-Type: application/json" \
-d '{"is_private": true}'
- Don’t appear in public feeds
- Only visible to the owner and admins
- Still accessible via direct link (if you know the ID)
Add tags to help categorize your upload:
curl -X POST https://api.fucksornot.com/api/v1/upload \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-F "upload_type=image" \
-F "description=My upload" \
-F "tags=gadget,tech,cool" \
-F "[email protected]"
- Maximum 10 tags per upload
- Tags are comma-separated
Rate Limits
Uploads are rate limited to 20 per hour per user to prevent abuse.
Deleting Uploads
Users can delete their own uploads:
curl -X DELETE https://api.fucksornot.com/api/upload/UPLOAD_ID \
-H "Authorization: Bearer YOUR_JWT_TOKEN"
Deletion is permanent and cannot be undone.