---
title: Compress Video Job API
slug: compress-video
url: https://apyverse.com/apyhub/service/compress-video
provider: ApyHub
categories: [File Conversion]
tags: [video-compression, media-processing, file-compression, ffmpeg, async-jobs]
auth: api_key
---

# Compress Video Job API

Compress a video file or video URL and poll for a job result. Returns a download URL when processing finishes successfully.

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| POST | `job/compress/video/file` | What it does Submits a video file for asynchronous compression and returns a job identifier immedia… | 400 |
| POST | `job/compress/video/url` | What it does Submits an asynchronous video compression job using a source video URL and returns a j… | 400 |
| GET | `job/compress/video/status` | What it does Checks the current status of a video compression job by jobid and returns the job meta… | 1 |

## About

## What it does
Video Compressor lets you submit a video file or a video URL, set a compression percentage, and get back an async job you can poll for the compressed result.

Use `POST /file-to-json` when you already have the source video as multipart file upload, or `POST /url-to-json` when the video lives at an HTTP(S) URL. In both cases, `compression_percentage` is a string from 0 to 100; if you omit it or send an empty value, the service defaults to 50. The upload endpoint accepts `video`, and the URL endpoint accepts `video_url`.

Each successful submission returns a `job_id` immediately. Check `GET /jobs/:job_id` to follow the job state. The status response includes `job_id`, `status`, and, when the job finishes successfully, a `url` for the compressed output. If the job is still running or has failed, you also get a human-readable `message`.

Use Video Compressor when you need to shrink uploaded assets before storage, reduce bandwidth for previews, or normalize delivery files in a media workflow.

## Usage

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyverse.com/apyhub/service/compress-video