## Table of Contents

- [screenshot › type](#screenshot-%E2%80%BA-type)
  - [CLI Microlink API example](#cli-microlink-api-example)
  - [cURL Microlink API example](#curl-microlink-api-example)
  - [JavaScript Microlink API example](#javascript-microlink-api-example)
  - [Python Microlink API example](#python-microlink-api-example)
  - [Ruby Microlink API example](#ruby-microlink-api-example)
  - [PHP Microlink API example](#php-microlink-api-example)
  - [Golang Microlink API example](#golang-microlink-api-example)

---

[API](https://microlink.io/docs/api/getting-started/overview)

[GUIDES](https://microlink.io/docs/guides) [MQL](https://microlink.io/docs/mql/getting-started/overview) [SDK](https://microlink.io/docs/sdk/getting-started/overview) [CARDS](https://microlink.io/docs/cards/getting-started/overview)

API GUIDES MQL SDK CARDS

Getting Started

[Overview](https://microlink.io/docs/api/getting-started/overview)

[Data fields](https://microlink.io/docs/api/getting-started/data-fields)

[CLI](https://microlink.io/docs/api/getting-started/cli)

Basics

[Authentication](https://microlink.io/docs/api/basics/authentication)

[Cache](https://microlink.io/docs/api/basics/cache)

[Compression](https://microlink.io/docs/api/basics/compression)

[Endpoint](https://microlink.io/docs/api/basics/endpoint)

[Error codes](https://microlink.io/docs/api/basics/error-codes)

[Format](https://microlink.io/docs/api/basics/format)

[Rate limit](https://microlink.io/docs/api/basics/rate-limit)

Query Parameters

[adblock](https://microlink.io/docs/api/parameters/adblock)

[animations](https://microlink.io/docs/api/parameters/animations)

[audio](https://microlink.io/docs/api/parameters/audio)

[cacheKey](https://microlink.io/docs/api/parameters/cacheKey)

[click](https://microlink.io/docs/api/parameters/click)

[colorScheme](https://microlink.io/docs/api/parameters/colorScheme)

[data](https://microlink.io/docs/api/parameters/data)

[device](https://microlink.io/docs/api/parameters/device)

[embed](https://microlink.io/docs/api/parameters/embed)

[filename](https://microlink.io/docs/api/parameters/filename)

[filter](https://microlink.io/docs/api/parameters/filter)

[force](https://microlink.io/docs/api/parameters/force)

[function](https://microlink.io/docs/api/parameters/function)

[headers](https://microlink.io/docs/api/parameters/headers)

[iframe](https://microlink.io/docs/api/parameters/iframe)

[insights](https://microlink.io/docs/api/parameters/insights)

[lighthouse](https://microlink.io/docs/api/parameters/insights/lighthouse)

[technologies](https://microlink.io/docs/api/parameters/insights/technologies)

[javascript](https://microlink.io/docs/api/parameters/javascript)

[mediaType](https://microlink.io/docs/api/parameters/mediaType)

[meta](https://microlink.io/docs/api/parameters/meta)

[modules](https://microlink.io/docs/api/parameters/modules)

[palette](https://microlink.io/docs/api/parameters/palette)

[pdf](https://microlink.io/docs/api/parameters/pdf)

[format](https://microlink.io/docs/api/parameters/pdf/format)

[height](https://microlink.io/docs/api/parameters/pdf/height)

[landscape](https://microlink.io/docs/api/parameters/pdf/landscape)

[margin](https://microlink.io/docs/api/parameters/pdf/margin)

[pageRanges](https://microlink.io/docs/api/parameters/pdf/pageRanges)

[scale](https://microlink.io/docs/api/parameters/pdf/scale)

[width](https://microlink.io/docs/api/parameters/pdf/width)

[ping](https://microlink.io/docs/api/parameters/ping)

[prerender](https://microlink.io/docs/api/parameters/prerender)

[proxy](https://microlink.io/docs/api/parameters/proxy)

[retry](https://microlink.io/docs/api/parameters/retry)

[screenshot](https://microlink.io/docs/api/parameters/screenshot)

[codeScheme](https://microlink.io/docs/api/parameters/screenshot/codeScheme)

[element](https://microlink.io/docs/api/parameters/screenshot/element)

[fullPage](https://microlink.io/docs/api/parameters/screenshot/fullPage)

[overlay](https://microlink.io/docs/api/parameters/screenshot/overlay)

[omitBackground](https://microlink.io/docs/api/parameters/screenshot/omitBackground)

[type](https://microlink.io/docs/api/parameters/screenshot/type)

[scripts](https://microlink.io/docs/api/parameters/scripts)

[scroll](https://microlink.io/docs/api/parameters/scroll)

[styles](https://microlink.io/docs/api/parameters/styles)

[staleTtl](https://microlink.io/docs/api/parameters/staleTtl)

[timeout](https://microlink.io/docs/api/parameters/timeout)

[ttl](https://microlink.io/docs/api/parameters/ttl)

[url](https://microlink.io/docs/api/parameters/url)

[video](https://microlink.io/docs/api/parameters/video)

[viewport](https://microlink.io/docs/api/parameters/viewport)

[waitForSelector](https://microlink.io/docs/api/parameters/waitForSelector)

[waitForTimeout](https://microlink.io/docs/api/parameters/waitForTimeout)

[waitUntil](https://microlink.io/docs/api/parameters/waitUntil)

API GUIDES MQL SDK CARDS

Getting Started

[Overview](https://microlink.io/docs/api/getting-started/overview)

[Data fields](https://microlink.io/docs/api/getting-started/data-fields)

[CLI](https://microlink.io/docs/api/getting-started/cli)

Basics

[Authentication](https://microlink.io/docs/api/basics/authentication)

[Cache](https://microlink.io/docs/api/basics/cache)

[Compression](https://microlink.io/docs/api/basics/compression)

[Endpoint](https://microlink.io/docs/api/basics/endpoint)

[Error codes](https://microlink.io/docs/api/basics/error-codes)

[Format](https://microlink.io/docs/api/basics/format)

[Rate limit](https://microlink.io/docs/api/basics/rate-limit)

Query Parameters

[adblock](https://microlink.io/docs/api/parameters/adblock)

[animations](https://microlink.io/docs/api/parameters/animations)

[audio](https://microlink.io/docs/api/parameters/audio)

[cacheKey](https://microlink.io/docs/api/parameters/cacheKey)

[click](https://microlink.io/docs/api/parameters/click)

[colorScheme](https://microlink.io/docs/api/parameters/colorScheme)

[data](https://microlink.io/docs/api/parameters/data)

[device](https://microlink.io/docs/api/parameters/device)

[embed](https://microlink.io/docs/api/parameters/embed)

[filename](https://microlink.io/docs/api/parameters/filename)

[filter](https://microlink.io/docs/api/parameters/filter)

[force](https://microlink.io/docs/api/parameters/force)

[function](https://microlink.io/docs/api/parameters/function)

[headers](https://microlink.io/docs/api/parameters/headers)

[iframe](https://microlink.io/docs/api/parameters/iframe)

[insights](https://microlink.io/docs/api/parameters/insights)

[lighthouse](https://microlink.io/docs/api/parameters/insights/lighthouse)

[technologies](https://microlink.io/docs/api/parameters/insights/technologies)

[javascript](https://microlink.io/docs/api/parameters/javascript)

[mediaType](https://microlink.io/docs/api/parameters/mediaType)

[meta](https://microlink.io/docs/api/parameters/meta)

[modules](https://microlink.io/docs/api/parameters/modules)

[palette](https://microlink.io/docs/api/parameters/palette)

[pdf](https://microlink.io/docs/api/parameters/pdf)

[format](https://microlink.io/docs/api/parameters/pdf/format)

[height](https://microlink.io/docs/api/parameters/pdf/height)

[landscape](https://microlink.io/docs/api/parameters/pdf/landscape)

[margin](https://microlink.io/docs/api/parameters/pdf/margin)

[pageRanges](https://microlink.io/docs/api/parameters/pdf/pageRanges)

[scale](https://microlink.io/docs/api/parameters/pdf/scale)

[width](https://microlink.io/docs/api/parameters/pdf/width)

[ping](https://microlink.io/docs/api/parameters/ping)

[prerender](https://microlink.io/docs/api/parameters/prerender)

[proxy](https://microlink.io/docs/api/parameters/proxy)

[retry](https://microlink.io/docs/api/parameters/retry)

[screenshot](https://microlink.io/docs/api/parameters/screenshot)

[codeScheme](https://microlink.io/docs/api/parameters/screenshot/codeScheme)

[element](https://microlink.io/docs/api/parameters/screenshot/element)

[fullPage](https://microlink.io/docs/api/parameters/screenshot/fullPage)

[overlay](https://microlink.io/docs/api/parameters/screenshot/overlay)

[omitBackground](https://microlink.io/docs/api/parameters/screenshot/omitBackground)

[type](https://microlink.io/docs/api/parameters/screenshot/type)

[scripts](https://microlink.io/docs/api/parameters/scripts)

[scroll](https://microlink.io/docs/api/parameters/scroll)

[styles](https://microlink.io/docs/api/parameters/styles)

[staleTtl](https://microlink.io/docs/api/parameters/staleTtl)

[timeout](https://microlink.io/docs/api/parameters/timeout)

[ttl](https://microlink.io/docs/api/parameters/ttl)

[url](https://microlink.io/docs/api/parameters/url)

[video](https://microlink.io/docs/api/parameters/video)

[viewport](https://microlink.io/docs/api/parameters/viewport)

[waitForSelector](https://microlink.io/docs/api/parameters/waitForSelector)

[waitForTimeout](https://microlink.io/docs/api/parameters/waitForTimeout)

[waitUntil](https://microlink.io/docs/api/parameters/waitUntil)

## screenshot › type

[Copy for LLM](https://microlink.io/docs/api/parameters/screenshot/type.md "Copy content for LLM")

\|

[View as Markdown](https://microlink.io/docs/api/parameters/screenshot/type.md "View content as Markdown")

Type: \<string\>\
Default: 'png'\
Values:

'jpeg' \| 'png'

It specifies the screenshot file type for the [screenshot](https://microlink.io/docs/api/parameters/screenshot) over the target [url](https://microlink.io/docs/api/parameters/url).

The following examples show how to use the Microlink API with CLI, cURL, JavaScript, Python, Ruby, PHP & Golang, targeting 'https://microlink.io' URL with 'screenshot' API parameter:

### CLI Microlink API example

```bash
microlink https://microlink.io&screenshot.type=jpeg
```

### cURL Microlink API example

```bash
curl -G "https://api.microlink.io" \
  -d "url=https://microlink.io" \
  -d "screenshot.type=jpeg"
```

### JavaScript Microlink API example

```javascript
import mql from '@microlink/mql'

const { data } = await mql('https://microlink.io', {
  screenshot: {
    type: "jpeg"
  }
})
```

### Python Microlink API example

```python
import requests

url = "https://api.microlink.io/"

querystring = {
    "url": "https://microlink.io",
    "screenshot.type": "jpeg"
}

response = requests.get(url, params=querystring)

print(response.json())
```

### Ruby Microlink API example

```ruby
require 'uri'
require 'net/http'

base_url = "https://api.microlink.io/"

params = {
  url: "https://microlink.io",
  screenshot.type: "jpeg"
}

uri = URI(base_url)
uri.query = URI.encode_www_form(params)

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
response = http.request(request)

puts response.body
```

### PHP Microlink API example

```php
<?php

$baseUrl = "https://api.microlink.io/";

$params = [
    "url" => "https://microlink.io",
    "screenshot.type" => "jpeg"
];

$query = http_build_query($params);
$url = $baseUrl . '?' . $query;

$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => $url,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => "GET"
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
    echo "cURL Error #: " . $err;
} else {
    echo $response;
}
```

### Golang Microlink API example

```
package main

import (
    "fmt"
    "net/http"
    "net/url"
    "io"
)

func main() {
    baseURL := "https://api.microlink.io"

    u, err := url.Parse(baseURL)
    if err != nil {
        panic(err)
    }
    q := u.Query()
    q.Set("url", "https://microlink.io")
    q.Set("screenshot.type", "jpeg")
    u.RawQuery = q.Encode()

    req, err := http.NewRequest("GET", u.String(), nil)
    if err != nil {
        panic(err)
    }

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}
```

```javascript
import mql from '@microlink/mql'

const { data } = await mql('https://microlink.io', {

  screenshot: {

    type: "jpeg"

  }

})
```

CLI cURL JavaScript Python Ruby PHP Golang Click to run the code and see the API response

This query parameter just defines the file format to be used at asset generation.

When you consume the asset thought [Microlink CDN](https://microlink.io/blog/edge-cdn), it automatically optimizes the assets to serve the best format possible (like WebP) based on your device (it's determining via `user-agent` header).

Last updated on February 4, 2026

[Edit on GitHub](https://github.com/microlinkhq/www/blob/master/src/content/docs/api/parameters/screenshot/type.md)