URL to image quiz: 8 questions, explained
Each question shows the options of one request. Pick what you think comes back, and the page tells you what does, and why.
Question 1 of 8
The request has these options:
url=example.com format=jpeg
What comes back?
The answer key, all 8
The same questions as the quiz, with the right answer marked. Read it before you take the quiz if you prefer, or after, for the ones you missed.
1. What comes back?
url=example.com format=jpeg
- A JPEG of example.com
- An error: invalid_options (right answer)
- A blank JPEG
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.
The screenshot URL2. Which file type do you get when you set no format?
url=https://example.com
- JPEG
- PNG (right answer)
- WebP
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.
Options reference3. What comes back?
url=https://example.com format=jpeg omit_background=true
- A JPEG with a see-through background
- A JPEG with a white background
- An error: invalid_options (right answer)
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]
omit_background4. What does the picture show?
url=https://en.wikipedia.org/wiki/Eiffel_Tower
- The whole article, top to bottom
- The first screen only (right answer)
- The text of the article, without images
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.
Full-page screenshots5. With the default 1280 by 1024 window, how big is the file?
url=https://example.com image_width=400
- 400 by 320: the height follows the shape of the page (right answer)
- 400 by 400, squashed
- 1280 by 1024: image_width does nothing without image_height
400 by 320. 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.
image_width6. What happens to the 1280 by 1024 first screen?
url=https://example.com image_width=400 image_height=400
- It is squashed into a square
- It is cropped to fill the square, and the top of the page stays (right answer)
- It is shrunk to fit, with white bars
Cropped to fill, from the top. 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.
image_height7. The page is 20,000 pixels tall. What comes back?
url=https://example.com/very-long-page format=webp full_page=true
- A WebP 20,000 pixels tall
- A WebP cut off at 16,383 pixels
- An error: content_too_large (right answer)
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.
Full-page screenshots8. How many screenshots do the two requests use from the plan?
url=https://example.com cache=true (sent twice, a minute apart)
- Two
- One (right answer)
- None
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.
Caching
How these answers were checked
Eight rules, one table
Keep this part. If you remember one line per question, you can write most URL to image requests without opening the docs.
| 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 thumbnail of a page, 400 pixels a side, as a WebP, with the top of the page kept. The cache option makes a repeat of the same request free.
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.webpReplace YOUR_ACCESS_KEY with the key from your account. The Free plan has 100 screenshots a month and needs no card, read on the pricing page on 2026-11-03. The tool page for URL to image has a box for one address, and webpage to JPG does the same for JPEG.
Questions people ask
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"). Checked .
Read next
- ComparisonPNG, JPEG, WebP or PDF for website screenshotsA 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.
- Cheat sheetWebsite thumbnail sizes: how small can it getThumbnail 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.
- Error dictionary15 curl errors on a screenshot call, with fixes15 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.