📤

File Uploader API

Upload files and get temporary shareable links (7 days)

Endpoint

POST/api/v1/file-uploader

Authentication

Include your API key in the request header:

X-API-Key: your_api_key_here

Get your API key from the Dashboard

Request Body

Content-Type: multipart/form-data

Field	Type	Required	Description
file	file	Yes	The file to upload (max 100MB)
metadata	string	No	JSON string with additional metadata

Response

Field	Type	Description
success	boolean	Whether the upload was successful
upload.uploadId	string	Unique identifier for the upload
upload.fileName	string	Stored file name
upload.originalName	string	Original file name
upload.mimeType	string	MIME type of the file
upload.size	number	File size in bytes
upload.downloadUrl	string	Direct download URL
upload.downloadUrlEncoded	string	URL-encoded download URL (use this for sharing)
upload.provider	string	Storage provider used
upload.expiresAt	string	ISO 8601 date when the file expires

Code Examples

# Upload a file
curl -X POST https://tools.shubhambadgujar.com/api/v1/file-uploader \
  -H "X-API-Key: your_api_key" \
  -F "file=@/path/to/document.pdf"

# Upload with metadata
curl -X POST https://tools.shubhambadgujar.com/api/v1/file-uploader \
  -H "X-API-Key: your_api_key" \
  -F "file=@/path/to/image.png" \
  -F 'metadata={"source": "screenshot", "project": "my-app"}'

Pricing

First 50 free, then $0.01 per call

Get API Key

Rate Limits

• 100 requests per minute
• 10,000 requests per day
• Max request size: 10MB