1. Widget
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 many items
      • Get many items
    • Search
      • Search items
    • Lists
      • Get a list's items
    • Schemas
      • ItemIntent
      • ItemFlags
      • ItemPriceField
      • ItemPriceV2
      • NCValue
      • ItemSaleStatusV2
      • UseTypes
      • ThreeStateBoolean
      • ItemV2Minimal
      • ItemV2Card
      • ItemV2Pricer
      • ItemV2Full
      • Error
  1. Widget

Widget

You can also embed itemdb content on your webpage using widgets!
It's pretty simple to use:
Where:
FieldDefault ValueDescription
idnoneYour regular HTML ID
data-itemdb-widget-idnone - requiredA unique ID for this widget div
data-itemdb-widget-typelatest-itemsWhich item list this widget is showing. Possible values: latest-items latest-prices latest-ncmall leaving-ncmall trending-items list
data-itemdb-widget-limit5Quantity of items to show
data-itemdb-widget-localeenCustom locale. Possible values: en pt es
data-itemdb-widget-badgesfalseAdds item badge with price info and more
data-itemdb-widget-list-idnoneList id or slug
data-itemdb-widget-list-usernamenoneList owner username

Lists#

You can also return list items. All fields are required:
You can get list-id and username by looking at a list's url:
https://itemdb.com.br/pt/lists/<username>/<list-id>
Caution
This will only return public data - private lists or hidden items will not be returned

Customizing#

You can also add your own custom CSS. Here some of the classes we use:
ClassDescription
itemdb-widgetWidget Wrapper
itemdb-widget-itemListItem List Wrapper
itemdb-widget-itemItem
itemdb-widget-buttonitemdb button
itemdb-widget-badgeitem badge
itemdb-widget-badge-yellowPB items badge
itemdb-widget-badge-purpleNC items badge
Be sure to place your CSS after the div to be sure it won't be overwritten :)
Tip
You can use multiples widget instances in the same page with only one script tag. Be sure that the script tag is placed after the last widget div

Cache#

We’ve implemented several caching techniques, so the Widget shouldn’t impact your site’s loading time (or speed). For this reason, the Widget data is updated every 10 minutes (or so).
Modified at 2026-07-20 01:03:46
Previous
Slugs
Next
Tab Example
Built with