---
updatedAt: 2025-06-18T02:37:52.000Z
agentTools:
  projectIndex: https://api.encoding.com/llms.txt
---

# Cropping

<a name="cropping"></a>Crop the dimensions of your source video.

```xml
<?xml version="1.0"?>
<query>
    <userid>[UserID]</userid> <!-- required-->
    <userkey>[UserKey]</userkey> <!-- required-->
    <action>[Action]</action> <!-- required-->
    <format>
        <crop_top>[CropTop]</crop_top>
        <crop_right>[CropRight]</crop_right>
        <crop_bottom>[CropBottom]</crop_bottom>
        <crop_left>[CropLeft]</crop_left>
    </format>
</query>
```
```json
{
    "query": {
        "userid": "[UserID]",
        "userkey": "[UserKey]",
        "action": "[Action]",
        "format": {
            "crop_top": "[CropTop]",
            "crop_right": "[CropRight]",
            "crop_bottom": "[CropBottom]",
            "crop_left": "[CropLeft]"
        }
    }
}
```

| Parameter        | Description                                  | Allowed Values   | Default Values |
| :--------------- | :------------------------------------------- | :--------------- | :------------- |
| **crop\_top**    | Specify the top crop band size in pixels.    | Positive integer | None           |
| **crop\_right**  | Specify the right crop band size in pixels.  | Positive integer | None           |
| **crop\_bottom** | Specify the bottom crop band size in pixels. | Positive integer | None           |
| **crop\_left**   | Specify the left crop band size in pixels.   | Positive integer | None           |