Uploadcare API

Three APIs for your entire file pipeline

Get started
  • Upload API

    Upload files to Uploadcare servers, faster, securely, and reliably. This API comes with the best-in-class File Uploader widget.

  • REST API

    From basic CRUD operations to adding metadata, converting videos and documents, checking for viruses and running various add-ons.

  • URL API

    Compress, transform, and adjust images on the fly. From simple cropping to color science and object recognition.

Upload API — accept any & all files

The Upload API allows uploading files to Uploadcare servers. The API can be used with our File Uploader HTML5 widget, or via direct integration.

Code
curl -F "UPLOADCARE_PUB_KEY=YOUR_PUBLIC_KEY" \
     -F "file=@cat.jpg" \
     -F "UPLOADCARE_STORE=auto" \
     "https://upload.uploadcare.com/base/"
Result
{
    file: '17be4678-dab7-4bc7-8753-28914a22960a'
  }

Enable rock-solid uploads at lightspeed

Our uploading API rests on a geographically distributed network of servers. Like a CDN in reverse, the API makes sure uploads always go the fastest route possible. The service won’t skip a beat with huge files, multiple uploads, or spotty connections.

  • Accelerated uploading
  • Uploads from URL
  • Image API
  • Video API
  • Malware protection
  • Signed uploads
  • Platform-side MIME-type filtering
  • Up to 5 TB file size
Yakov Karda

In-house file infrastructure? No thank you.

Uploader screenshot

File uploader our flagship API client

Learn more

REST API — file ops for pros

The REST File API provides low-level access to Uploadcare platform features. You can manage files, file groups and projects, including metadata, data from external services, conversions, and batch operations.

Code
curl 'https://api.uploadcare.com/files/' \
     -H 'Accept: application/vnd.uploadcare-v0.7+json' \
     -H 'Authorization: Uploadcare.Simple YOUR_PUBLIC_KEY:YOUR_SECRET_KEY'
Result
{
  "next": "https://api.uploadcare.com/files/?limit=3&from=2018-11-27T01%3A00%3A43.001705%2B00%3A00&offset=0",
  "previous": "https://api.uploadcare.com/files/?limit=3&to=2018-11-27T01%3A00%3A36.436838%2B00%3A00&offset=0",
  "total": 2484,
  "totals": {
    "removed": 0,
    "stored": 2480,
    "unstored": 4
  },
  "per_page": 2,
  "results": [ ... ]
}

Automate, command and control your file pipeline

  • Webhooks

    Connect your app to Uploadcare. Receive uploading events, and trigger actions.

  • Metadata

    Assign additional arbitrary data associated with the uploaded file. Store the unique file identifier from your system or data to train your ML model.

  • Document conversion

    DOC, DOCX, XLS, XLSX, PPS, PPSX, PPT, PPTX, VSD, VSDX, SKW, WPD, WPS, XLR, PUB, MPP, KEY, MSG, NUMBERS, PAGES

  • Video processing

    Crop, trim, adjust resolution, and generate thumbnails. Encode into MP4, WebM or OGG.

URL API — edit images on the fly

This top-level API lets you instantly process images stored on Uploadcare, by using chainable URL operations. Adjust each piece of image right before it’s delivered.

<img src=
'https://ucarecdn.com/0693...aae6/
Image ID
-/resize/1200x/
-/blur_region/faces/
-/filter/jadis/
-/format/auto/
-/quality/smart/
Chain of transformations
my-image'
File name
/>
People in office
Sergey Bliznetsov

Before using Uploadcare, I did all the image processing myself.

Spawn the right file at the right time. Anytime

  • Smart

    Cropping, compression, conversion automations, powered by ever-improving machine learning.

  • Chainable

    Build processing sequences of any complexity, and always get a predictable result.

  • 42 operations

    A complete toolkit with geometric operations, color filters, and compression options.

  • Unlimited derivatives

    Different image versions won’t clutter your storage, as they are kept only on the CDN. Plus, we don’t charge for processing.

Adaptive image usage illustration

Adaptive Image. Optimize images automatically

Learn more

Partner up with us and get media superpowers

Enrich your core product, infrastructure, or client work with our core tech. Mix & match the APIs you need — Uploadcare is a flexible stack that will play well with yours. Our team will, too!

  • CDN providers
  • Hosting & cloud
  • Dev agencies
  • Media products
Akamai logoAWS logoEvrone logoY Combinator logo