# URL to image quiz: 8 questions, explained

> Eight requests that turn a URL into an image. Guess what each one returns, then read why: formats, size, crop, full page, cache. Score yourself.

Quiz by Serghei Pogor, founder of CurlShot (https://curlshot.com/about/serghei-pogor). Published 6 November 2026. Page for people: https://curlshot.com/blog/url-to-image-quiz

To turn a URL into an image with CurlShot, send the full address as url, and the picture comes back as a PNG unless you set format to jpeg or webp. You get the first screen of the page (a 1280 by 1024 window) unless you add full_page=true. Set image_width alone to keep the shape, or image_width and image_height together to crop from the top. A JPEG cannot be see-through, and a WebP cannot pass 16,383 pixels on a side. This page tests those rules with 8 questions.

## Key facts

- A url must be a full address that starts with http or https, followed by a colon and two slashes. A bare domain is refused with invalid_options.
- The default format is png. Use jpeg or webp with image_quality (1 to 100, default 80) for smaller files.
- Without full_page=true you get the first screen. A full-page capture still counts as one screenshot.
- One of image_width and image_height keeps the shape; both crop to fill the box and keep the top of the page.
- JPEG has no transparency, and WebP stops at 16,383 pixels on a side. A repeat with cache=true is free. The Free plan of CurlShot has 100 screenshots a month (read on 2026-11-03).

## 1. What comes back?

```text
url=example.com
format=jpeg
```

- A. A JPEG of example.com
- B. An error: invalid_options
- C. A blank JPEG

**Answer: B. An error: invalid_options.** A url is a full address: it starts with http:// or https://. A bare example.com is refused with invalid_options, and nothing is drawn. A failed request is not counted against the plan. More: [The screenshot URL](https://curlshot.com/docs/screenshot-url).

## 2. Which file type do you get when you set no format?

```text
url=https://example.com
```

- A. JPEG
- B. PNG
- C. WebP

**Answer: B. PNG.** The default format is png. It keeps every pixel, so a long page makes a large file. Ask for jpeg or webp, with image_quality from 1 to 100 (default 80), when size matters more than exact pixels. More: [Options reference](https://curlshot.com/docs/options).

## 3. What comes back?

```text
url=https://example.com
format=jpeg
omit_background=true
```

- A. A JPEG with a see-through background
- B. A JPEG with a white background
- C. An error: invalid_options

**Answer: C. An error: invalid_options.** A JPEG has no alpha channel, so it cannot be see-through. CurlShot does not quietly give you a white page: it refuses the request and says omit_background needs a format with transparency, png or webp. [1] More: [omit_background](https://curlshot.com/docs/options#omit_background).

## 4. What does the picture show?

```text
url=https://en.wikipedia.org/wiki/Eiffel_Tower
```

- A. The whole article, top to bottom
- B. The first screen only
- C. The text of the article, without images

**Answer: B. The first screen only.** Without full_page=true you get what a visitor sees before scrolling. The default window is 1280 by 1024. Add full_page=true for the whole page. It is still one screenshot on your plan: a full-page capture of a long article counts the same as a thumbnail. More: [Full-page screenshots](https://curlshot.com/docs/full-page).

## 5. With the default 1280 by 1024 window, how big is the file?

```text
url=https://example.com
image_width=400
```

- A. 400 by 320: the height follows the shape of the page
- B. 400 by 400, squashed
- C. 1280 by 1024: image_width does nothing without image_height

**Answer: A. 400 by 320: the height follows the shape of the page.** Give one side and the other follows, so the shape stays. The first screen is 1280 by 1024, a ratio of 1.25, and 400 divided by 1.25 is 320. Each side can be 1 to 8,000 pixels. More: [image_width](https://curlshot.com/docs/options#image_width).

## 6. What happens to the 1280 by 1024 first screen?

```text
url=https://example.com
image_width=400
image_height=400
```

- A. It is squashed into a square
- B. It is cropped to fill the square, and the top of the page stays
- C. It is shrunk to fit, with white bars

**Answer: B. It is cropped to fill the square, and the top of the page stays.** With both sides set, the image fills the box and the rest is cut off, keeping the top of the page. That suits a thumbnail grid, where the top of a page is what people recognise. Nothing is stretched, and no bars are added. More: [image_height](https://curlshot.com/docs/options#image_height).

## 7. The page is 20,000 pixels tall. What comes back?

```text
url=https://example.com/very-long-page
format=webp
full_page=true
```

- A. A WebP 20,000 pixels tall
- B. A WebP cut off at 16,383 pixels
- C. An error: content_too_large

**Answer: C. An error: content_too_large.** A WebP can be at most 16,383 pixels on a side, and the full-page cut-off is 20,000 by default. The error lists three ways out: use png or jpeg, lower full_page_max_height, or set image_width or image_height so the picture is smaller. More: [Full-page screenshots](https://curlshot.com/docs/full-page).

## 8. How many screenshots do the two requests use from the plan?

```text
url=https://example.com
cache=true
(sent twice, a minute apart)
```

- A. Two
- B. One
- C. None

**Answer: B. One.** The first request is rendered and stored. The second is served from the cache, and a cache hit is not counted. The stored copy stays valid for cache_ttl, 14,400 seconds (4 hours) by default; change cache_key to force a fresh render. More: [Caching](https://curlshot.com/docs/caching).

## The eight rules in one table

| Question | Rule to remember | Answer |
| --- | --- | --- |
| 1 | url starts with https:// | An error, invalid_options |
| 2 | format defaults to png | PNG |
| 3 | transparency needs png or webp | An error, invalid_options |
| 4 | full_page=true for the whole page | The first screen only |
| 5 | one side set: the other follows | 400 by 320 |
| 6 | both sides set: crop, keep the top | Cropped to fill, from the top |
| 7 | webp stops at 16,383 px a side | An error, content_too_large |
| 8 | cache hits are free | One |

## One request that uses what you learned

A square 400 pixel WebP thumbnail of a page, kept in the cache so a repeat is free:

```bash
curl "https://curlshot.com/api/v1/screenshot?access_key=YOUR_ACCESS_KEY&url=https://example.com&format=webp&image_quality=80&image_width=400&image_height=400&cache=true" \
  --output thumb.webp
```

The answers come from the option rules of the API, read on 2026-11-03. The requests above were not sent in a test run for this page, so check the one you plan to use with your own key. The Free plan has 100 screenshots a month and needs no card; see [pricing](https://curlshot.com/pricing).

## Questions

### How do I turn a URL into an image?

Send a request with the full address as url and your access key. CurlShot loads the page in a real browser and returns the picture as the answer, as a PNG by default. Add format=jpeg or format=webp for a smaller file.

### Why does my URL to image request return invalid_options?

The most common cause is an address without http:// or https://, such as example.com. Others are a misspelled option name, which comes back with a hint for the name you probably meant, and omit_background=true together with format=jpeg.

### How do I get the whole page as an image, not only the top?

Add full_page=true. Without it you get the first screen only, which is the part a visitor sees before scrolling. A very tall page is cut at full_page_max_height, 20,000 pixels by default.

### How do I make a small square thumbnail of a page?

Set image_width and image_height to the same number, for example 400 and 400. The picture fills the square and the rest is cut off from the bottom, so the top of the page stays. Set only one of them to keep the shape of the page instead.

### Is URL to image free?

The Free plan of CurlShot has 100 screenshots a month and needs no card (read on 2026-11-03). A failed render and a cache hit are not counted. See the pricing page for the paid plans.

## Sources

1. MDN Web Docs, "Image file type and format guide (JPEG: "does not support an alpha channel")": https://developer.mozilla.org/en-US/docs/Web/Media/Guides/Formats/Image_types (checked 3 November 2026)

## Go deeper

- [URL to image](https://curlshot.com/tools/url-to-image)
- [Webpage to JPG](https://curlshot.com/tools/webpage-to-jpg)
- [Options reference](https://curlshot.com/docs/options)
- [Pricing](https://curlshot.com/pricing)

## Read next

- [PNG, JPEG, WebP or PDF for website screenshots](https://curlshot.com/blog/png-jpeg-webp-pdf-for-screenshots.md): A decision flow, a comparison table and our own file-size measurements for choosing PNG, JPEG, WebP or PDF when you save a screenshot of a web page.
- [Website thumbnail sizes: how small can it get](https://curlshot.com/blog/website-thumbnail-sizes.md): Thumbnail sizes for link lists, cards and previews, the viewport to capture from, 2x files for sharp screens, and the width where text stops being readable.
- [15 curl errors on a screenshot call, with fixes](https://curlshot.com/blog/curl-errors-screenshot-api.md): 15 curl errors from real runs of a screenshot call: the exact message, what it means, how to check it and the fix. Paste yours to look it up.
