Assets

Retrieve CS assets with filters and pagination

Baseurl: https://www.steamwebapi.com/api/assets?key=YOUR_API_KEY

💬 **What this endpoint does:**
- Returns over million CS assets (inventory- and market-related items) with flexible filter options.
- Supports powerful pagination for large result sets.

🛠️ **Features:**
- Filter by owner (SteamID64), weapon (def_index), skin (paint_index), float range, StatTrak, Souvenir, rarity, quality, origin and paint_seed.
- Filter by exact market hash name (market_hash_name).
- Filter only assets that belong to Steam profiles or only to market listings.
- Filter assets that have stickers and/or keychains.
- Paginated responses via limit and offset.

🌐 **How to use:**
- All query parameters use snake_case naming.
- Combine multiple filter parameters as needed (for example steam_id + def_index + min_float/max_float).
- Use offset for pagination (for example offset=50 for page 2 with limit=50).
- By default the endpoint returns a limited number of assets per request (configurable via the limit parameter).
- Also reachable at the legacy path `/steam/api/float/assets` — identical behavior, kept for backward compatibility.
get/api/assets

Request

  • Base URL: https://www.steamwebapi.com
  • URL: https://www.steamwebapi.com/api/assets
  • Auth: API key in query parameter key

Query parameters

Your API key for authentication. Retrieve it from your Dashboard (top-right corner).

steam_idstring

Filter by SteamID64 of the owner, for example 76561198042843401.

market_hash_namestring

Filter by exact market hash name, for example "AK-47 | Uncharted (Factory New)".

def_indexinteger

Filter by weapon definition index, for example 7 for AK-47.

paint_indexinteger

Filter by paint index / skin ID, for example 836 for "AK-47 | Uncharted".

floatstring
Example:0.030868796632

Exact float (wear) lookup, for example 0.030868796632. Matches the value at the precision you supply: the tolerance is one unit in the last decimal place you send, so a displayed/rounded float finds the stored asset (0.030868796631694) instead of returning nothing. Send more decimals to narrow the match, fewer to widen it — 0.030868796632 searches ±1e-12, while 0.03 searches ±0.01. Prefer this over min_float=X&max_float=X, which compares raw Float64 values and therefore misses rounded input.

min_floatnumber float

Minimum float value (wear) inclusive, for example 0.00 for Factory New range start.

max_floatnumber float

Maximum float value (wear) inclusive, for example 0.07 for Factory New range end.

is_stattrak0 | 1

Filter by StatTrak status (1 = StatTrak, 0 = non-StatTrak).

is_souvenir0 | 1

Filter by Souvenir status (1 = Souvenir, 0 = non-Souvenir).

rarityinteger

Filter by rarity tier. Typical values are in the range 1-6 (for example 6 = Covert).

qualityinteger

Filter by item quality, for example 4 = normal, 9 = rarity-specific.

originstring

Filter by origin such as drop, market-purchase or case-reward.

paint_seedinteger

Filter by exact paint seed / pattern number, for example 915.

wear'fn' | 'mw' | 'ft' | 'ww' | 'bs'

Filter by wear category code: fn (Factory New), mw (Minimal Wear), ft (Field-Tested), ww (Well-Worn), bs (Battle-Scarred). Case-insensitive.

phasestring

Filter by Doppler / Gamma phase, for example "p1", "p2", "p3", "p4", "ruby", "sapphire", "black-pearl", "emerald".

sourcestring

Filter by ingestion source. Examples: "inventory" (collected via /inventory endpoint), "csfloat", "youpin" (third-party marketplace scrapers).

asset_idstring

Filter by exact Steam asset id (inventory id) — useful for direct lookups.

datestring
Example:2025-12-31

Filter by calendar date when the asset was created. Accepts ISO dates (YYYY-MM-DD) or local format such as 31.12.2025.

sort'newest' | 'oldest' | 'lowest_float' | 'highest_float'

Sort order. Supported values: newest, oldest, lowest_float, highest_float. Default is newest.

limitinteger

Number of results to return. Default is 10, upper limit depends on your plan.

offsetinteger

Offset for pagination, for example 50 for page 2 when limit=50.

only_steam_id0 | 1

If set to 1, only assets with a SteamID64 owner are returned.

only_market_id0 | 1

If set to 1, only assets without a SteamID64 owner (market listings) are returned.

with_stickers0 | 1

If set to 1, only assets that have at least one sticker are returned.

with_keychains0 | 1

If set to 1, only assets that have at least one keychain are returned.

with_items0 | 1

If set to 1, enrich each asset with the matching item record from the items database (joined by market_hash_name). The item payload is exposed under the "item" key.

with_profiles0 | 1

If set to 1, enrich each asset with the matching Steam profile (joined by SteamID64). The profile payload is exposed under the "profile" key.

formatstring

Response format: json (default), csv, xml, html, gzip, zip, ndjson, mysql, mysql_with_table, pgsql, pgsql_with_table, mongo.

Response

Request was successful and the assets are returned.

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.