Skip to content
QuizBy 5 min read

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. 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 URL
  2. 2. 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 reference
  3. 3. 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_background
  4. 4. 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 screenshots
  5. 5. 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_width
  6. 6. 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_height
  7. 7. 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 screenshots
  8. 8. 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

The answers come from the option rules of the API: the docs pages linked above, and the checks that run on a request before it is drawn. They were read on 2026-11-03. The requests were not sent in a test run for this page, so try the one you plan to use with your own key. The one outside fact is that a JPEG file has no alpha channel.[1] The source was opened on 2026-11-03.

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.

The 8 rules from the quiz, with the answer to each
QuestionRule to rememberAnswer
1url starts with https://An error, invalid_options
2format defaults to pngPNG
3transparency needs png or webpAn error, invalid_options
4full_page=true for the whole pageThe first screen only
5one side set: the other follows400 by 320
6both sides set: crop, keep the topCropped to fill, from the top
7webp stops at 16,383 px a sideAn error, content_too_large
8cache hits are freeOne

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.

A square WebP thumbnail
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

Replace 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.

Screenshot any page in one step

Paste an address into CurlShot and download the screenshot. A free account gives you 100 screenshots every month. No card needed.