Crop Screenshots by Pixel Coordinates

Pixel-coordinate cropping returns exactly the rectangle you define — an X/Y start position plus a width and height — regardless of the page's markup. It is ideal when the region you need has no stable selector, or when you want the same fixed frame (a logo, a chart, a table) captured identically on every run. If the target does have a selector, the section parameter is usually simpler.

Need format guidance? See the PNG vs JPEG format guide and the website screenshot API for automation.

By selecting and cropping just the portion you need, you can ensure that your screenshots highlight only the most relevant information, improving clarity and effectiveness.

Start Cropping for Free or See Plan Limits

• Precise targeting: Combine crop parameters with request templates to standardize recurring captures.
• No throttling: Run concurrent crop jobs across three regions without waiting for capacity.
• Direct delivery: Send cropped outputs to AWS S3, Azure, Google Cloud, or Cloudflare R2.

Understanding Crop Area Parameters

To crop a specific area of your screenshot, you'll need to configure the following parameters:

1. Viewport: Defines the size of the area to crop (e.g., 643x296 pixels).
2. X Coordinate: Specifies the horizontal start position from the top-left corner of the image (e.g., 645).
3. Y Coordinate: Specifies the vertical start position from the top-left corner of the image (e.g., 184).

The X and Y coordinates are optional and default to 0,0 (top-left corner) if not specified.

Crop Area Example

Below is an example of cropping a screenshot starting from coordinates X=645 and Y=184, with a viewport size of 643x296 pixels.

// Example API request for cropping a screenshot https://api.addscreenshots.com/screenshots
?apikey=YOUR_API_KEY
&crop_area_x=645
&crop_area_y=184
&crop_area_viewport=643x296
&url=google.com

Your API key can be found on the API Keys page. Need an API Key? Sign up to get started.
For internal applications, replace YOUR_API_KEY with your own unique API Key.
For public facing websites or hotlinks, generate a signed URL.

Finding the Right Area and Coordinates

To accurately determine the area and coordinates for cropping, follow these steps:

1. Capture a full-size screenshot of the webpage.
2. Open the screenshot in an image editor, such as Paint on Windows.
3. Use the editor to identify the coordinates and dimensions of the area you wish to crop.
4. Apply these values to the crop area parameters in your screenshot API request.

Automate Cropped Screenshots