---
title: "🔍 Preview CS2 Items - Lightweight Metadata (No Prices)"
method: GET
path: "/steam/api/items/preview"
tags: ["Items"]
---

# 🔍 Preview CS2 Items - Lightweight Metadata (No Prices)

`GET /steam/api/items/preview`

## Request

- Base URL: `https://www.steamwebapi.com`
- URL: `https://www.steamwebapi.com/steam/api/items/preview`
- Auth: API key in query parameter `key`

Baseurl: https://www.steamwebapi.com/steam/api/items/preview?key=YOUR_API_KEY

    💬 **What this endpoint does:**
    - Returns a lightweight preview of CS2 items without pricing data.
    - Intended for fast access to item metadata and newly available items.
    - For full item details including pricing, prefer using `/steam/api/items`.

    🛠️ **Features:**
    - Search items by name using `search` parameter (case-insensitive).
    - Filter by `paint_index` or `def_index` for specific weapons/skins.
    - Group results using `groupBy` to get unique values (e.g., all item types).
    - Combine phase variants with `grouped=true` (default); unrelated items with the same display name remain separate.
    - Returns only skin IDs by default; use `show_all=1` to include other catalog categories.
    - Marks database-missing items with `preview=true` and `new=true`.
    - Also marks items without a live Steam image with `new=true`; their image is served through the SteamWebAPI image proxy.
    - Marks items sold for the first time within 30 days with `recent=true`.
    - Filter only items with phases using `only_phases=true`.
    - Supports multiple output formats via `format` parameter.

    🌐 **How to use:**
    - Basic call: `GET /steam/api/items/preview?key=YOUR_KEY`
    - Search: `GET /steam/api/items/preview?search=AK-47&key=YOUR_KEY`
    - Filter by weapon: `GET /steam/api/items/preview?def_index=7&key=YOUR_KEY`
    - Get all item types: `GET /steam/api/items/preview?groupBy=itemtype&key=YOUR_KEY`
    - Export as CSV: `GET /steam/api/items/preview?format=csv&key=YOUR_KEY`

## Query parameters

- `search` string
- `paint_index` integer
- `def_index` integer
- `grouped` boolean
- `groupBy` 'itemtype' | 'itemname' | 'rarity' | 'collection' | 'wear' | 'phase' | 'defindex' | 'paintindex' | 'markethashname' | 'groupname'
- `format` 'json' | 'gzip' | 'zip' | 'csv' | 'xml' | 'html' | 'table' | 'ndjson' | 'mysql' | 'mysql_with_table' | 'pgsql' | 'pgsql_with_table' | 'mongo'
- `pretty` '0' | '1'
- `show_all` boolean
- `preview` boolean
- `only_phases` boolean

## Response `200`

CS2 items matching the filters. Returns item metadata without pricing. When `grouped=true` (default), items with multiple phases include a `variants` array.

- unknown

## Other responses

- `400`: Invalid request parameters.
- `500`: Internal server error or upstream API unavailable.
- `503`: The Redis-backed database availability snapshot is temporarily unavailable.

---

[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)