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.

Request

curl -F "UPLOADCARE_PUB_KEY=dd51d1cd79804e3df51d" \
     -F "file=@/PATH/TO/FILE" \
     -F "UPLOADCARE_STORE=auto"
     "https://upload.uploadcare.com/base/"
Response
{
    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
  • 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.

Request

curl 'https://api.uploadcare.com/files/' \
     -H 'Accept: application/vnd.uploadcare-v0.7+json' \
     -H 'Authorization: Uploadcare.Simple demopublickey:demosecretkey'
Response
{
    "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.

People in office<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
/>
David Fairfull

Don’t build image-processing systems yourself.

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

Add smart media powers to your core offering

Mix & match the APIs you need to enrich your core product, infrastructure, or client work. Uploadcare is a scalable, modular stack that will play well with yours, and we’re here to help at every step.

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