# Screenshots

Capture any public webpage as a high-quality image.

## Overview

The HTML/CSS to Image API can capture screenshots of any publicly accessible URL. Pass a URL to the API, and get back a pixel-perfect screenshot rendered in a real instance of Google Chrome.

## Basic usage

```bash
curl -X POST https://hcti.io/v1/image -u 'UserID:APIKey' \
  --data-urlencode url="https://stripe.com"
```

![Screenshot of stripe.com generated with the API](/assets/images/stripe.png)

## Common use cases

### Website archival

Capture and preserve webpage snapshots for compliance, legal, or historical purposes.

### Link previews

Generate preview images for links shared in your application, similar to how Slack or Twitter shows link previews.

### Competitive monitoring

Automatically capture competitor websites to track design changes over time.

### Documentation

Generate up-to-date screenshots for product documentation and tutorials.

### Testing and QA

Capture screenshots during automated testing to verify UI changes.

## Capture specific elements

Use the `selector` parameter to capture just a portion of a page:

```bash
curl -X POST https://hcti.io/v1/image -u 'UserID:APIKey' \
  --data-urlencode url="https://stripe.com" \
  --data-urlencode selector="section#complete-toolkit"
```

![Screenshot cropped to a CSS selector](/assets/images/url-selector-example.png)

## Full-page screenshots

Capture the entire scrollable length of a page:

```bash
curl -X POST https://hcti.io/v1/image -u 'UserID:APIKey' \
  --data-urlencode url="https://example.com/long-page" \
  --data full_screen=true
```

[Learn more about full\_screen](/parameters/full_screen/)

## Hide cookie banners

Many websites display consent popups. Use `block_consent_banners` to hide them:

```bash
curl -X POST https://hcti.io/v1/image -u 'UserID:APIKey' \
  --data-urlencode url="https://example.com" \
  --data block_consent_banners=true
```

[Learn more about blocking cookie banners](/guides/advanced/blocking-cookie-banners/)

## High-resolution screenshots

Set `device_scale` to 2 for retina-quality images:

```bash
curl -X POST https://hcti.io/v1/image -u 'UserID:APIKey' \
  --data-urlencode url="https://example.com" \
  --data device_scale=2
```

## Control the viewport

Set a specific [viewport size](/parameters/viewport/#viewport-width-and-height) for your screenshots:

```bash
curl -X POST https://hcti.io/v1/image -u 'UserID:APIKey' \
  --data-urlencode url="https://example.com" \
  --data viewport_width=1920 \
  --data viewport_height=1080
```

## Wait for JavaScript

If the page needs time to fully render (e.g., charts, animations), add a delay:

```bash
curl -X POST https://hcti.io/v1/image -u 'UserID:APIKey' \
  --data-urlencode url="https://example.com" \
  --data ms_delay=1000
```

## Inject custom CSS

Modify the appearance of the page before capturing:

```bash
curl -X POST https://hcti.io/v1/image -u 'UserID:APIKey' \
  --data-urlencode url="https://example.com" \
  --data-urlencode css=".banner { display: none; } body { background: white; }"
```

## Social media screenshots

We have dedicated guides for capturing content from popular platforms:

*   [Twitter/X Screenshots](/guides/social-media/twitter/)
*   [Facebook Screenshots](/guides/social-media/facebook/)
*   [Instagram Embeds](/guides/social-media/instagram/)
*   [LinkedIn Screenshots](/guides/social-media/linkedin/)

## Limitations

*   The hosted renderer must be able to reach the URL; local addresses such as `localhost` are not accessible.
*   For protected pages you control, use [custom request headers](/parameters/headers/) or a [configured proxy](/guides/advanced/proxies/). An interactive login flow is not performed automatically.
*   Some sites may block automated access

## Need help?

Talk to a human. Email [support@htmlcsstoimage.com](mailto:support@htmlcsstoimage.com) and we’ll help you get started.