---
title: Crop Images API
slug: crop-image
url: https://apyhub.com/apyhub/service/crop-image
provider: ApyHub
categories: [File Manipulation, Image Processing]
auth: api_key
---

# Crop Images API

Crop raster images by URL or file upload and get a binary file or signed download link. Use box crops or margin insets for thumbnails and asset prep.

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| POST | `/processor/image/crop/file-urls` | What it does Crops an image fetched from a URL and returns a signed URL for the cropped result. Use… | 30 |
| POST | `/processor/image/crop/file` | What it does Crops an uploaded image and returns the resulting file as binary data. You can crop by… | 30 |
| POST | `/processor/image/crop/file/url` | What it does Crops an uploaded raster image and returns a time-limited pre-signed URL to the stored… | 30 |
| POST | `/processor/image/crop/url/file` | What it does Crops an image fetched from a URL and returns the resulting file as binary data. The r… | 30 |

## About

## What it does
Image Cropper trims raster images by URL or file upload and returns either a downloaded crop or a time-limited signed URL to the result. Use it when you need to cut product shots, profile images, screenshots, or banner assets down to a specific frame without handling image processing yourself.

Send an image URL with `width` and `height` for a box crop from the top-left origin, or send an `image_url`/`image` with `top`, `bottom`, `left`, and `right` margin values to crop by insets. Margin values are strings such as `10px` or `5%`, and the service accepts `preserve_format` plus an `output` name on the upload endpoints. For URL-based crops, you can choose whether you want the cropped file returned directly or a pre-signed download link in the response.

The response is intentionally simple: download-mode endpoints return binary image data, while link-mode endpoints return a `data` field containing a signed URL. That makes Image Cropper easy to slot into workflows that resize CMS assets, generate thumbnails, or prepare images for listings and moderation queues.

If you already store images remotely, crop by URL. If you receive uploads from users, send the file directly and get back the cropped image in the format you need.

## Usage

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