# Caching options

> Reference for the caching options of the shotkit screenshot API, with an example request for each.

Store the render and reuse it for identical requests. Cache hits are free and don't count toward your monthly screenshots.

### `cache`

Cache the result and return a CDN URL. Identical requests (same options, same workspace) return the stored file until it expires. GET requests are redirected (`302`) to the file's CDN URL; POST requests get the bytes. Send `Cache-Control: no-cache` to force a fresh render that also refreshes the entry. See [Caching](https://shotkit.net/docs/caching.md).

Type: `boolean` · Default: `false`

```bash
curl -X POST "https://shotkit.net/api/take" \
  -H "X-Access-Key: YOUR_ACCESS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com","cache":true}' \
  --fail-with-body -o shot.jpg
```

### `cache_ttl`

Cache lifetime in seconds. Between 4 hours (`14400`) and 30 days (`2592000`). Also how long uploaded files and URLs from `response_type=json` stay available.

Type: `number` · Default: `14400` · Range: `14400`–`2592000`

```bash
curl -X POST "https://shotkit.net/api/take" \
  -H "X-Access-Key: YOUR_ACCESS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com","cache":true,"cache_ttl":86400}' \
  --fail-with-body -o shot.jpg
```

### `cache_key`

Distinguish otherwise identical cached renders.

Type: `string`

```bash
curl -X POST "https://shotkit.net/api/take" \
  -H "X-Access-Key: YOUR_ACCESS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com","cache":true,"cache_key":"2026-10-09"}' \
  --fail-with-body -o shot.jpg
```