SKU Service — docs.pricedb.io

General Information

Base URL:https://sku.pricedb.io

Resolves TF2 item names to SKUs and vice versa. Provides the canonical TF2 item schema as a downloadable resource.

Base URL:https://sku.pricedb.io

Rate Limiting:Standard rate limiting applies — 360 requests per minute per IP.

CORS:Cross-origin requests are fully supported.

Authentication:No authentication required.

General

GET/apiHealth check

Returns service status and a list of available API endpoints.

Response

Service is running

Try in browser

Resolution

GET/api/sku/{sku}Resolve SKU to item name

Looks up a TF2 SKU string and returns the corresponding human-readable item name and parsed attributes.

Parameters

Name	In	Type	Description
sku	path	string	TF2 item SKU string (e.g. `5021;6`)

Response

Resolved item details

{
  "success": true,
  "data": {
    "sku": "5021;6",
    "name": "Mann Co. Supply Crate Key",
    "defindex": 5021,
    "quality": 6,
    "craftable": true,
    "tradable": true,
    "killstreak": 0,
    "australium": false,
    "effect": null,
    "festive": false,
    "paintkit": null,
    "wear": null,
    "quality2": null,
    "craftnumber": null,
    "crateseries": null,
    "target": null,
    "output": null,
    "outputQuality": null,
    "paint": null
  }
}

Try in browser

GET/api/name/{name}Resolve item name to SKU

Looks up a TF2 item name and returns the corresponding SKU string and parsed item attributes.

The name must be URL-encoded when it contains special characters (e.g. `L%27Inspecteur` for `L'Inspecteur`).

Parameters

Name	In	Type	Description
name	path	string	TF2 item name, URL-encoded (e.g. `Mann%20Co.%20Supply%20Crate%20Key`)

Response

Resolved item details

{
  "success": true,
  "data": {
    "sku": "622;6",
    "name": "L'Inspecteur",
    "defindex": 622,
    "quality": 6,
    "craftable": true,
    "tradable": true,
    "killstreak": 0,
    "australium": false,
    "effect": null,
    "festive": false,
    "paintkit": null,
    "wear": null,
    "quality2": null,
    "craftnumber": null,
    "crateseries": null,
    "target": null,
    "output": null,
    "outputQuality": null,
    "paint": null
  }
}

Try in browser

Images

GET/api/sku/{sku}/imageGet image for a SKU

Returns an image for the given SKU.

- **Unusual items** (effect ≠ null): the effect overlay is composited onto the base item image server-side and the resulting PNG is served directly. The result is cached on disk.
- **All other items**: responds with a `302` redirect to the appropriate external image URL (Steam CDN or Scrap.tf).

Parameters

Name	In	Type	Description
sku	path	string	TF2 item SKU string (e.g. `30177;5;u13`)

Response

Unusual item image served directly as PNG

Try in browser

GET/api/name/{name}/imageGet image for an item by name

Resolves the given item name to a SKU, then responds with a `302` redirect to `/api/sku/{sku}/image`.

The name must be URL-encoded when it contains special characters.

Parameters

Name	In	Type	Description
name	path	string	TF2 item name, URL-encoded (e.g. `Burning%20Team%20Captain`)

Response

Redirect to the image endpoint for the resolved SKU

Try in browser

Metadata

GET/api/effect/listList all unusual effects

Returns all unusual particle effects known to the TF2 schema, sorted by ID.

Response

Array of unusual effects

{
  "success": true,
  "data": [
    {
      "id": 13,
      "name": "Community Sparkle"
    },
    {
      "id": 14,
      "name": "Holy Grail"
    },
    {
      "id": 16,
      "name": "Blizzardy Storm"
    }
  ]
}

Try in browser

GET/api/effect/{id}Get unusual effect by ID

Returns the name of a single unusual effect by its numeric ID.

Parameters

Name	In	Type	Description
id	path	integer	Unusual effect ID (e.g. `13` for Community Sparkle)

Response

Effect found

{
  "success": true,
  "data": {
    "id": 13,
    "name": "Community Sparkle"
  }
}

Try in browser

GET/api/effect/name/{name}Get unusual effect by name

Returns the ID of a single unusual effect by its display name. The name must be URL-encoded.

Parameters

Name	In	Type	Description
name	path	string	Unusual effect display name, URL-encoded (e.g. `Community%20Sparkle`)

Response

Effect found

{
  "success": true,
  "data": {
    "id": 13,
    "name": "Community Sparkle"
  }
}

Try in browser

GET/api/paint/listList all paint colors

Returns all paint colors with their decimal RGB color value and display name, sorted alphabetically by name.

Response

Array of paint colors

{
  "success": true,
  "data": [
    {
      "id": 8208497,
      "name": "A Color Similar to Slate"
    },
    {
      "id": 7511618,
      "name": "Indubitably Green"
    },
    {
      "id": 4345659,
      "name": "Zepheniah's Greed"
    }
  ]
}

Try in browser

GET/api/paint/{id}Get paint color by decimal color value

Returns the name of a single paint color by its decimal RGB color value.

Parameters

Name	In	Type	Description
id	path	integer	Paint decimal color value (e.g. `7511618` for Indubitably Green)

Response

Paint color found

{
  "success": true,
  "data": {
    "id": 7511618,
    "name": "Indubitably Green"
  }
}

Try in browser

GET/api/paint/name/{name}Get paint color by name

Returns the decimal color value of a single paint color by its display name. The name must be URL-encoded.

Parameters

Name	In	Type	Description
name	path	string	Paint color display name, URL-encoded (e.g. `Indubitably%20Green`)

Response

Paint color found

{
  "success": true,
  "data": {
    "id": 7511618,
    "name": "Indubitably Green"
  }
}

Try in browser

GET/api/wear/listList all wear levels

Returns the five wear levels used by Decorated Weapon (War Paint) items.

Response

Array of wear levels

{
  "success": true,
  "data": [
    {
      "id": 1,
      "name": "Factory New"
    },
    {
      "id": 2,
      "name": "Minimal Wear"
    },
    {
      "id": 3,
      "name": "Field-Tested"
    },
    {
      "id": 4,
      "name": "Well-Worn"
    },
    {
      "id": 5,
      "name": "Battle Scarred"
    }
  ]
}

Try in browser

GET/api/wear/{id}Get wear level by ID

Returns the display name for a single wear level ID (1–5).

Parameters

Name	In	Type	Description
id	path	integer	Wear level ID (1 = Factory New … 5 = Battle Scarred)

Response

Wear level found

{
  "success": true,
  "data": {
    "id": 1,
    "name": "Factory New"
  }
}

Try in browser

GET/api/paintkit/listList all War Paint kits

Returns all War Paint (Decorated Weapon) paint kits known to the TF2 schema, sorted by ID.

Response

Array of paint kits

{
  "success": true,
  "data": [
    {
      "id": 0,
      "name": "Decorated War Hero"
    },
    {
      "id": 1,
      "name": "Civil Servant"
    }
  ]
}

Try in browser

GET/api/paintkit/{id}Get War Paint kit by ID

Returns the name of a single War Paint kit by its numeric ID.

Parameters

Name	In	Type	Description
id	path	integer	Paint kit ID

Response

Paint kit found

{
  "success": true,
  "data": {
    "id": 0,
    "name": "Decorated War Hero"
  }
}

Try in browser

GET/api/paintkit/name/{name}Get War Paint kit by name

Returns the ID of a single War Paint kit by its display name. The name must be URL-encoded.

Parameters

Name	In	Type	Description
name	path	string	Paint kit display name, URL-encoded (e.g. `Decorated%20War%20Hero`)

Response

Paint kit found

{
  "success": true,
  "data": {
    "id": 0,
    "name": "Decorated War Hero"
  }
}

Try in browser

GET/api/strangepart/listList all Strange Parts

Returns all Strange Part attributes known to the TF2 schema.

Response

Array of Strange Parts

Try in browser

GET/api/crateseries/listList all crate series

Returns all crate series numbers known to the TF2 schema.

Response

Array of crate series

Try in browser

GET/api/craftweapon/listList all craftable weapons

Returns all craftable weapons usable in trading, as known by the TF2 schema.

Response

Array of craftable weapons

Try in browser

GET/api/uncraftweapon/listList all uncraftable weapons

Returns all uncraftable weapons usable in trading, as known by the TF2 schema.

Response

Array of uncraftable weapons

Try in browser

GET/api/quality/listList all item qualities

Returns all item quality levels known to the TF2 schema (e.g. Normal, Genuine, Vintage, Unique, Strange, Unusual).

Response

Object mapping quality names to IDs

{
  "success": true,
  "data": {
    "Normal": 0,
    "Genuine": 1,
    "Vintage": 3,
    "Unusual": 5,
    "Unique": 6,
    "Community": 7,
    "Developer": 8,
    "Self-Made": 9,
    "Strange": 11,
    "Haunted": 13,
    "Collector's": 14,
    "Decorated Weapon": 15
  }
}

Try in browser

Schema

GET/api/schemaGet TF2 item schema

Returns the full TF2 item schema as a JSON object. Cached and refreshed periodically. The schema contains all item definitions, qualities, effects, killstreaks, and attributes recognised by TF2Autobot.

Response

Full TF2 item schema object

Try in browser

GET/api/downloadDownload TF2 item schema

Returns the TF2 item schema as a downloadable JSON file. Sets `Content-Disposition` to trigger a browser download.

Response

Downloadable JSON schema file

Try in browser