1. Items
itemdb API Guide
  • General
    • Getting Started
    • API Access
    • Slugs
    • Widget
      • Widget
      • Tab Example
  • v1
    • Item
      • Get latest items
      • Get an item
      • Get item's price history
      • Get item's auction history
      • Get item's restock history
      • Get item's trade history
      • Get items color palette
      • Get item's color palette
      • Get many items
      • Get many items
      • Get Item Drops Data
      • Get Dyeworks Variants
      • Get MME Paths
      • Get Item Effects
      • Get Cooking Pot Recipes
    • Search
      • Search for an item
    • Lists
      • Get List Info
      • Get List Item Info
      • Get List Item Data
    • Misc
      • Get all ways to change a Pet Color/Species
      • Get wearable preview
      • Get cached item's thumbnail
    • Schemas
      • Schemas
        • SaleStatus
        • ItemMallData
        • UseTypes
        • ListData
        • ListItemInfo
        • ItemData
        • itemColorData
        • ItemPriceData
        • OwlsData
        • ItemRestockData
        • ItemAuctionData
        • TradeData
        • TradeItem
        • UserList
        • ListItemInfo
        • ColorData
        • SearchFilters
  • v2
    • Intents & Cache
    • Items
      • Get a single item
        GET
      • Get many items
        GET
      • Get many items
        POST
    • Search
      • Search items
    • Lists
      • Get a list's items
    • Schemas
      • ItemIntent
      • ItemFlags
      • ItemPriceField
      • ItemPriceV2
      • NCValue
      • ItemSaleStatusV2
      • UseTypes
      • ThreeStateBoolean
      • ItemV2Minimal
      • ItemV2Card
      • ItemV2Pricer
      • ItemV2Full
      • Error
  1. Items

Get a single item

GET
https://itemdb.com.br/api/v2/items/{id_name}
Lookup by internal_id, slug, or name (LIKE match unless the caller passes wildcards).
Cache: Redis + CDN for successful GETs. TTL follows the request intent. Cache hits do not consume API quota; database misses do. Use ?fresh=1 to bypass Redis (still counts toward quota; response is no-store). 404s are never cached.

Request

Path Params

Query Params

Responses

🟢200
application/json
Item found.
Bodyapplication/json

Example
{
    "internal_id": 0,
    "item_id": 0,
    "name": "string",
    "description": "string",
    "image": {
        "url": "string",
        "id": "string",
        "hash": "string"
    },
    "type": "np",
    "status": "string",
    "slug": "string"
}
🟠400
🟠404
Modified at 2026-07-22 23:09:58
Previous
Intents & Cache
Next
Get many items
Built with