itemdb API Guide
    itemdb API Guide
    • Getting Started
    • Slugs
    • Widget
    • Widget Tabs Exemple
    • Item
      • Get latest items
        GET
      • Get an item
        GET
      • Get item's price history
        GET
      • Get item's auction history
        GET
      • Get item's restock history
        GET
      • Get item's trade history
        GET
      • Get items color palette
        GET
      • Get item's color palette
        POST
      • Get many items
        GET
      • Get many items
        POST
      • Get Item Drops Data
        GET
      • Get Dyeworks Variants
        GET
      • Get MME Paths
        GET
      • Get Item Effects
        GET
      • Get Cooking Pot Recipes
        GET
    • Search
      • Search for an item
        GET
    • Lists
      • Get List Info
        GET
      • Get List Item Info
        GET
      • Get List Item Data
        GET
    • Misc
      • Get all ways to change a Pet Color/Species
        GET
      • Get wearable preview
        GET
      • Get cached item's thumbnail
        GET

    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>
    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 2025-04-13 22:07:59
    Previous
    Slugs
    Next
    Widget Tabs Exemple
    Built with