Items - Mannco.store API

Base URL: https://api.mannco.store. Routes here use the api filter. Endpoints marked Connected + API need Authorization: Bearer <jwt> from POST /user/login. Endpoints marked API only do not require a user session (no Bearer).

Get item details

GET /item/details/{item}

Permission: API only (no session required)

item

string

required

Item identifier (numeric ID or URL slug)

Returns full item details from the items table. You can pass either a numeric item ID or a URL slug.

Response

{
  "err": false,
  "success": true,
  "content": {
    "informations": {
      "id": 101869,
      "name": "Souvenir M4A1-S | Imminent Danger (Field-Tested)",
      "effect": "",
      "SKU": "",
      "quality": "Souvenir;",
      "type": "Rifle",
      "type_steam": null,
      "class": null,
      "image": "-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXH5ApeO4YmlhxYQknCRvCo04DEVlxkKgpou-6kejhz2v_Nfz5H_uOxh7-Gw_alDK3UhH9Y78pOh-zF_Jn4t1i1uRQ5fWv3IYCXewE9Y16F-lO5kOrq0ZS86ZnMyndg6CZx4XzfnR22gBgaPLdxxavJlxkVjNA",
      "imagePertinence": 1,
      "craftable": 1,
      "rarity": "Covert",
      "featured": 0,
      "deal": 71708,
      "t": null,
      "color": "ffd700",
      "game": 730,
      "slot": "",
      "hero": null,
      "weapon": "M4A1-S",
      "exterior": "Field-Tested",
      "url": "730-souvenir-m4a1-s-imminent-danger-field-tested",
      "description": null,
      "tf2shop": null
    }
  }
}

Item Fields

Field	Type	Description
`id`	integer	Unique item ID
`name`	string	Item display name
`effect`	string	Unusual effect name (TF2) or empty
`SKU`	string	Stock Keeping Unit identifier
`quality`	string	Item quality (Unique, Strange, Unusual, Souvenir, etc.)
`type`	string	Item type/category
`type_steam`	string/null	Steam-specific type
`class`	string/null	Item class (TF2)
`image`	string	Item image URL/path
`imagePertinence`	integer	Image relevance score
`craftable`	integer	`1` = craftable, `0` = uncraftable
`rarity`	string	Item rarity (CS:GO/CS2)
`featured`	integer	`1` if featured, `0` otherwise
`deal`	integer	Steam market price in cents
`t`	any/null	Additional data
`color`	string	Hex color code for rarity
`game`	integer	Game App ID (`440`, `730`, `570`, `252490`)
`slot`	string	Equipment slot (TF2)
`hero`	string/null	Hero name (Dota 2)
`weapon`	string	Weapon name (CS:GO/CS2)
`exterior`	string	Wear condition (CS:GO/CS2)
`url`	string	URL-friendly slug
`description`	string/null	Item description
`tf2shop`	any/null	TF2 shop related data

Get item sales graph

GET /item/salesGraph/{item}?period={period}

Permission: Connected + API

item

string

required

Item identifier (numeric ID)

period

string

required

Time period for sales data: 1M, 3M, 6M, 1Y, 5Y, or ALL

Returns historical sales data for charting. Data is aggregated from the items_stats table with daily price and volume. For periods 5Y and ALL, data is grouped by week instead of by day.

Query Parameters

Parameter	Type	Required	Description
`period`	string	Yes	Time period: `1M` (1 month), `3M` (3 months), `6M` (6 months), `1Y` (1 year), `5Y` (5 years), `ALL` (all time)

Response (Daily data for 1M, 3M, 6M, 1Y)

{
  "err": false,
  "success": true,
  "content": {
    "values": [
      {
        "date": "2025-01-15 00:00:00",
        "price": 50000,
        "nb": 3
      },
      {
        "date": "2025-01-14 00:00:00",
        "price": 48000,
        "nb": 2
      }
    ]
  }
}

Response (Weekly data for 5Y and ALL)

{
  "err": false,
  "success": true,
  "content": {
    "values": [
      {
        "first_date": "2025-01-13",
        "week": "202502",
        "total_price": 150000,
        "total_nb": 8
      },
      {
        "first_date": "2025-01-06",
        "week": "202501",
        "total_price": 120000,
        "total_nb": 6
      }
    ]
  }
}

Response Fields (Daily)

Field	Type	Description
`date`	string	Date and time (YYYY-MM-DD HH:MM:SS)
`price`	integer	Total sales value in cents for the day
`nb`	integer	Number of sales that day

Response Fields (Weekly)

Field	Type	Description
`first_date`	string	First day of the week (Monday)
`week`	string	Year and week number (YYYYWW)
`total_price`	integer	Total sales value in cents for the week
`total_nb`	integer	Number of sales that week

Use daily data (1M, 3M, 6M, 1Y) for detailed graphs. Use weekly data (5Y, ALL) for long-term trends to reduce data points.

Get listing count

GET /item/listing/count/{item}
GET /item/listing/count/{item}/{userid}

Permission: API

item

string

required

Item identifier (numeric ID)

userid

string

Optional user SteamID to filter listings by seller

Returns the number of active listings for an item. If userid is provided, returns the count for that specific seller only.

Response

{
  "err": false,
  "success": true,
  "content": {
    "count": 13291
  }
}

Response Fields

Field	Type	Description
`err`	boolean	Error flag (false if no error)
`success`	boolean	Success flag (true if successful)
`content.count`	integer	Number of active listings for the item

Get item listings

GET /item/listing/{item}
GET /item/listing/{item}/{userid}

Permission: API

item

string

required

Item identifier (numeric ID)

userid

string

Optional user SteamID to filter by seller

count

integer

default:"10"

Number of items per page

page

integer

default:"0"

Page number (offset = page × count)

game

integer

Game ID filter (440 for TF2, 730 for CS2). Affects which extra info is joined.

Returns paginated listings sorted by price ascending. The number of items per page is capped by the server configuration (maxCount.itemListing). Each listing includes backpack details. For non-admin callers, user and ip are omitted from each listing.

Listing type

Field	Type	Description
`id`	integer	Backpack entry ID
`assetId`	string	Steam asset ID
`item_id`	integer	Item definition ID
`user`	string	Seller SteamID
`state`	integer	Item state (`1` = on sale)
`price`	integer	Listed price in cents
`bot`	string	Bot holding the item
`game`	integer	Game App ID
`wear`	float\|null	Wear value (CS2 items)
`sheen`	string	Killstreak sheen (TF2)
`killstreaker`	string	Killstreaker effect (TF2)
`spell`	string	Halloween spell (TF2)
`parts`	string	Strange parts (TF2)
`html`	string	Custom HTML description
`paint`	string	Paint color (TF2)
`values`	object\|null	Extra inspection values (CS2/TF2)
`getImage`	string\|null	Custom image URL

Get buy order list

GET /item/buyorderList/{item}

Permission: API

item

string

required

Item identifier (numeric ID)

Returns active buy orders for an item, grouped by price tier. Up to 5 price tiers are returned as keys 0–4; additional tiers are aggregated under the key "more".

Response

{
  "err": false,
  "success": true,
  "content": {
    "informations": {
      "0": { "count": 5, "price": 15000 },
      "1": { "count": 3, "price": 14500 },
      "2": { "count": 12, "price": 14000 },
      "more": { "count": 8, "price": 13500 }
    }
  }
}

Field	Type	Description
`informations[n].count`	integer	Total quantity at this price
`informations[n].price`	integer	Buy order price in cents
`informations.more`	object	Aggregated count and lowest price for remaining tiers

Get item pricing

GET /item/pricing/{item}

Permission: Connected + API

item

string

required

Item identifier (numeric ID)

Returns calculated pricing data for an item including lowest sale, highest buy order, Steam price, suggested listing price, and optional last sale.

Response

{
  "err": false,
  "success": true,
  "content": {
    "item_id": 12345,
    "cached": true,
    "last_updated": "2025-02-19 12:00:00",
    "pricing": {
      "lowest_sale_price": 15000,
      "lowest_buy_order": 12000,
      "steam_price": 18000,
      "suggested_price": 14999,
      "last_sale": {
        "price": 14800,
        "date": 1706745600
      }
    }
  }
}

Field	Type	Description
`item_id`	integer	Item ID
`cached`	boolean	Whether the result was served from cache
`last_updated`	string	Last calculation or cache update (Y-m-d H:i:s)
`pricing.lowest_sale_price`	float	Lowest active listing price in cents
`pricing.lowest_buy_order`	float	Highest active buy order price in cents
`pricing.steam_price`	float	Steam Community Market price in cents
`pricing.suggested_price`	float	Suggested listing price
`pricing.last_sale`	object/null	Last sale price and date (Unix timestamp) if available

Pricing data is cached for 20 minutes. Fresh data is calculated and stored when the cache expires.

Get bulk pricing

GET /item/pricing/bulk

Permission: Connected + API

items

string

required

Comma-separated item IDs (maximum 100 items)

Returns pricing data for multiple items at once. Each entry mirrors GET /item/pricing/{item} pricing fields, plus from_cache: true if the row was read from prices while still considered fresh, false if prices were recalculated and written back to prices. The envelope includes cached_items and refreshed_items counts (same semantics as from_cache, summed over every returned row — duplicate IDs in the query string are counted separately).

Response

{
  "err": false,
  "success": true,
  "content": {
    "total_items": 3,
    "cached_items": 2,
    "refreshed_items": 1,
    "items": [
      {
        "item_id": 12345,
        "from_cache": true,
        "last_updated": "2025-02-19 12:00:00",
        "pricing": {
          "lowest_sale_price": 15000,
          "lowest_buy_order": 12000,
          "steam_price": 18000,
          "suggested_price": 14999,
          "last_sale": { "price": 14800, "date": 1706745600 }
        }
      },
      {
        "item_id": 67890,
        "from_cache": false,
        "last_updated": "2025-02-19 12:01:05",
        "pricing": {
          "lowest_sale_price": 9000,
          "lowest_buy_order": 8500,
          "steam_price": 9500,
          "suggested_price": 8999,
          "last_sale": null
        }
      }
    ]
  }
}

Field	Type	Description
`total_items`	integer	Number of item entries returned (same length as `items`)
`cached_items`	integer	How many entries were served from cache (`from_cache` true)
`refreshed_items`	integer	How many entries were recalculated and persisted (`from_cache` false)
`items[].item_id`	integer	Item ID
`items[].from_cache`	boolean	`true` if read from `prices` without recalculation; `false` if refreshed this request
`items[].last_updated`	string	`updated_at` from DB when cached, or time of refresh (`Y-m-d H:i:s`)
`items[].pricing.*`		Same as Get item pricing (`lowest_sale_price`, `lowest_buy_order`, `steam_price`, `suggested_price`, `last_sale`)

Bulk pricing reuses rows in prices when updated_at is within the last 5 minute (shorter than the single-item GET /item/pricing/{item} cache window). Outside that window, the API recomputes from live tables and updates prices.

Example

GET /item/pricing/bulk?items=12345,67890,11111

Get item details from backpack ID (TF2)

GET /item/details/fromid/{backpackid}

Permission: API

backpackid

string

required

Backpack asset ID

Returns full backpack + item details for a TF2 item by its asset ID. Joins backpack, items, and item_infos tables.

Get item details from backpack ID (CS2)

GET /item/cs/details/fromid/{backpackid}

Permission: API

backpackid

string

required

Backpack asset ID

Same as above but specifically for CS2 items with wear, sticker, and pattern information.

Response Fields for Backpack Details

Both endpoints return combined data from backpack, items, and item_infos tables:

{
  "err": false,
  "success": true,
  "content": {
    "informations": {
      // Backpack fields
      "id": "integer",
      "assetId": "string",
      "user": "string (Steam ID)",
      "item_id": "integer",
      "price": "integer (cents) or null",
      "state": "integer (0=inventory, 1=on sale, 2=withdrawal)",
      "bot": "string (bot Steam ID)",
      "game": "integer (440/730/570/252490)",
      "wear": "float or null (CS2 items)",
      "sheen": "string (TF2 killstreak)",
      "killstreaker": "string (TF2 killstreak)",
      "spell": "string (TF2 spells)",
      "parts": "string or null (TF2 strange parts)",
      "paint": "string or null (TF2 paint)",
      "lastupdate": "integer (Unix timestamp)",
      
      // Items table fields
      "name": "string",
      "effect": "string",
      "quality": "string",
      "type": "string",
      "craftable": "integer or empty string",
      "image": "string",
      "rarity": "string",
      "url": "string",
      "color": "string (hex color)",
      
      // item_infos fields (if available)
      "values": "string (JSON) or null",
      "getImage": "integer or null"
    }
  }
}

Important: The craftable field is set to empty string ("") for all non-TF2 games. Only TF2 items (game 440) retain the original craftable value (0 or 1). Additionally, trailing spaces and trailing semicolons are removed from all string fields.

Documentation Index

​Get item details

​Response

​Item Fields

​Get item sales graph

​Query Parameters

​Response (Daily data for 1M, 3M, 6M, 1Y)

​Response (Weekly data for 5Y and ALL)

​Response Fields (Daily)

​Response Fields (Weekly)

​Get listing count

​Response

​Response Fields

​Get item listings

​Listing type

​Get buy order list

​Response

​Get item pricing

​Response

​Get bulk pricing

​Response

​Example

​Get item details from backpack ID (TF2)

​Get item details from backpack ID (CS2)

​Response Fields for Backpack Details

Get item details

Response

Item Fields

Get item sales graph

Query Parameters

Response (Daily data for 1M, 3M, 6M, 1Y)

Response (Weekly data for 5Y and ALL)

Response Fields (Daily)

Response Fields (Weekly)

Get listing count

Response

Response Fields

Get item listings

Listing type

Get buy order list

Response

Get item pricing

Response

Get bulk pricing

Response

Example

Get item details from backpack ID (TF2)

Get item details from backpack ID (CS2)

Response Fields for Backpack Details