---
title: "Render a CS2 item screenshot"
method: GET
path: "/steam/api/screenshot"
tags: ["Screenshot"]
---

# Render a CS2 item screenshot

`GET /steam/api/screenshot`

## Request

- Base URL: `https://www.steamwebapi.com`
- URL: `https://www.steamwebapi.com/steam/api/screenshot`
- Auth: one of:
  - API key in query parameter `key`
  - API key in header `X-Api-Key`
  - API key in header `Key`

Available in every package, including Free and Free+. Screenshot-specific limits take precedence; otherwise the package Global limits apply. Render front, back or both sides as AVIF using your existing SteamWebAPI key. game defaults to cs2. Transparent cutouts support front/back; use background_color for a solid background. with_float requires width >= 960. Each authenticated screenshot request, including result retrieval and retries, consumes a separate screenshot quota with UTC calendar day/month windows. Ordinary SteamWebAPI credits are not charged. A 202 response contains job_id: retrieve it through this same route after Retry-After. Reuse Idempotency-Key after a timeout. See [examples and response formats](/docs/raw/screenshot-api.md).

## Query parameters

- `key` string
- `url` string
- `game` 'cs2'
- `mode` 'front' | 'back' | 'both'
- `width` integer
- `view` 'transparent'
- `background_color` string
- `color` string
- `background_url` string, uri
- `background_vertical_align` 'top' | 'center' | 'bottom'
- `logo_url` string, uri
- `logo_offset_start` 'top left' | 'top right' | 'bottom left' | 'bottom right'
- `logo_offset_x` integer
- `logo_offset_y` integer
- `logo_opacity` number
- `logo_width` integer
- `with_float` boolean
- `item_name` string
- `paint_name` string
- `format` 'screen' | 'download' | 'base64'
- `as_base64` boolean
- `idempotency_key` string
- `job_id` string

## Headers

- `Idempotency-Key` string

## Response `200`

Rendered screenshot. download uses filename screenshot.avif.

- object
  - `status` 'success', required
  - `image` string, required

## Other responses

- `202`: Render pending. Wait for Retry-After, then request job_id through this endpoint.
- `401`: Missing or unknown customer key.
- `402`: Package does not allow screenshot registration.
- `403`: Account or provider key is disabled.
- `404`: Result not found or not owned by this key.
- `405`: Unsupported method; use GET.
- `406`: Unsupported inspect-link format.
- `409`: Registration or idempotency conflict.
- `410`: Image expired.
- `422`: Invalid options.
- `429`: Provider quota or capacity limit. Respect Retry-After.
- `502`: Invalid screenshot response; retry with the same idempotency key.
- `503`: Proxy disabled or provider unavailable.
- `default`: Errors return JSON with status, code and message.

---

[API](https://skmtc.dev/steamwebapi/apis/steamwebapi-com-third-party-steam-market-api-documentation.md) · [All operations](https://skmtc.dev/steamwebapi/apis/steamwebapi-com-third-party-steam-market-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/steamwebapi/apis/steamwebapi-com-third-party-steam-market-api-documentation/revisions/f9a4109cbda6?raw)