▣ FILE CONVERSION · FILE MANIPULATION

Compress Video File API

Hosted on ApyHub

What it does

The video compression API reduces a video's file size by re-encoding it. Send the file as video or point it at a public video_url, set compression_percentage, and get the smaller file back as a direct download or as a signed link.

compression_percentage runs from 0 to 100 and defaults to 50. Higher values produce a smaller file at lower quality, so it is worth running two or three values against a sample clip to find the point where quality still holds for your content. Uploads accept .mp4, .mkv, .avi, .mov, .flv, .3gp and .webm, up to 100 MB per request, and the URL routes handle anything larger.

Teams use the video compression API to cut storage and bandwidth bills on user-generated uploads, to get clips under the size limits that email and chat tools enforce, and to shrink background and hero videos so a page loads faster on a slow connection.

One percentage controls the result. To see what you started with, the Video Metadata API returns duration, resolution, frame rate, codec and file size as JSON, which makes it easier to pick a sensible value.

For long videos and batch work, the Async Video Compression API runs the same compression as a job: submit, get a job_id, poll until it finishes. Compression also pairs with the Video Converter API when the output needs a different container. All of them are callable by AI agents through ApyHub MCP.

▣ ENDPOINT 01 / 04

POST

Compress video (upload → download)

https://api.eu.apyhub.com/apyhub/compress-video/multi-part/download

QUICKSTART

GUIDE

Quickstart

Upload a video file to get back the compressed video binary.

curl -X POST "https://api.eu.apyhub.com/apyhub/compress-video/multi-part/download" \
  -H "apy-token: $APY_TOKEN" \
  -F "video=@/path/to/video.mp4" \
  -F "compression_percentage=50"

What you'll get back

Returns a binary containing the compressed video file.

TRY ITLIVE · 550 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

Max 100MB total per request (all files combined). Larger? Use this API's URL-based endpoint instead, if it has one.

About this endpoint

What it does

Uploads a video file and returns the compressed video as a binary file in the response. You can optionally control the compression strength with compression_percentage.

Request Body

Parameter	Type	Mandatory	Description
video	Binary	Yes	Video file (`.mp4`, `.mkv`, `.avi`, `.mov`, `.flv`, `.3gp`, `.webm`).
compression_percentage	Integer	No	Compression strength from 0 to 100. Higher values produce a smaller file with lower quality. Default: `50`.

Response

Returns a binary file as the response body — the compressed video output. The output schema is a binary string, so there is no JSON wrapper or named response field.

Parameter	Type	Mandatory	Description
binary response body	String	Yes	Compressed video file returned as raw binary data.

Max 100MB total per request (all files combined). Larger? Use this API's URL-based endpoint instead, if it has one.

▣ ENDPOINT 02 / 04

POST

Compress video (upload → cloud link)

https://api.eu.apyhub.com/apyhub/compress-video/multi-part/link

QUICKSTART

GUIDE

Quickstart

Upload a video and set the compression percentage to get a temporary download link.

curl -X POST "https://api.eu.apyhub.com/apyhub/compress-video/multi-part/link" \
  -H "apy-token: $APY_TOKEN" \
  -F "video=@/path/to/video.mp4" \
  -F "compression_percentage=50"

What you'll get back

Returns a JSON object with a data string field containing a time-limited signed URL for download.

{
  "data": "https://example.com/download/video-compressed.mp4?signature=..."
}

TRY ITLIVE · 550 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

Max 100MB total per request (all files combined). Larger? Use this API's URL-based endpoint instead, if it has one.

About this endpoint

What it does

Uploads a video file and returns a time-limited signed URL for downloading the compressed result.

Request Body

Parameter	Type	Mandatory	Description
video	Binary	Yes	Binary video file to compress.
compression_percentage	Integer	No	Target compression percentage. Default: 50. Allowed range: 0 to 100.

Response

Returns a JSON object with a data string field containing a time-limited signed URL for download.

Parameter	Type	Mandatory	Description
data	String	No	Time-limited signed URL for download.

Max 100MB total per request (all files combined). Larger? Use this API's URL-based endpoint instead, if it has one.

▣ ENDPOINT 03 / 04

POST

Compress video (URL → download)

https://api.eu.apyhub.com/apyhub/compress-video/url/download

QUICKSTART

GUIDE

Quickstart

Compress a video from a public URL by sending the source video_url in the JSON body.

curl -X POST "https://api.eu.apyhub.com/apyhub/compress-video/url/download" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"video_url":"https://assets.apyhub.com/samples/sample.mp4", "compression_percentage":"50"}'

What you'll get back

Returns a binary file that contain the compressed video content.

TRY ITLIVE · 550 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Compresses a video from a provided URL and returns the compressed file as binary content for download.

Request Body

Parameter	Type	Mandatory	Description
video_url	String	Yes	Video URL to compress. Must be a URI.
compression_percentage	String	No	Compression strength from 0 to 100, provided as a string or number. Default: `50`.

Response

Returns binary file content in the success response. The output schema is a string with binary format, so the endpoint responds with the compressed video data itself rather than a JSON object.

▣ ENDPOINT 04 / 04

POST

Compress video (URL → cloud link)

https://api.eu.apyhub.com/apyhub/compress-video/url/link

QUICKSTART

GUIDE

Quickstart

Compress a video from a public URL by sending the source link and a compression percentage.

curl -X POST "https://api.eu.apyhub.com/apyhub/compress-video/url/link" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"video_url":"https://assets.apyhub.com/samples/sample.mp4", "compression_percentage":"50"}'

What you'll get back

Returns a JSON object with a data string field containing a time-limited signed download URL.

{
  "data": "https://..."
}

TRY ITLIVE · 550 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Compresses a video from a provided URL and returns a time-limited signed download URL for the compressed file.

Request Body

Parameter	Type	Mandatory	Description
video_url	String	Yes	Video URL to compress. Must be a valid URI.
compression_percentage	String	No	Compression percentage to apply. Default: `50`.

Response

Returns a JSON object with a data string field containing a time-limited signed URL for downloading the compressed video.

Parameter	Type	Mandatory	Description
data	String	No	Time-limited signed URL for download.

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.

Similar APIs

Closest matches in the catalog based on this service.

CALLCompress Images APIApyHub CALLCompress Video Job APIApyHub CALLTrim Video Clip APIApyHub CALLConvert Video Formats APIApyHub

From the blog

Reads that touch this API.

Extending Low/No-Code Platforms via Third-Party APIsAug 5, 2026 Exploring the world of Software Utility APIsJul 9, 2026 Exploring the Top Video Thumbnail ( Preview) APIsJul 9, 2026 All About File Compression: RAR, ZIP, 7z ExplainedSep 10, 2026