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

    Getting Started

    Hey, this is the itemdb API Reference. Here you can get every info we have about an item and much more.
    When using itemdb and our data you're subject to our Terms of Use and Privacy Policy. Make sure you take a look at it before starting your projects with our API.

    General Rules#

    itemdb is an open-source project. We don't make any money out of it and all expenses are paid from our own pocket.
    That said, be mindful when using our api. Our main goal is to serve the community with the main site. If your use case creates a risk to our systems we will terminate you.
    Also:
    Absolutely no cheating. You may not use itemdb api to create neopets cheats and/or tools to give unfair advantage against other players.
    Don't use our api to scrape our entire database. You will be banned if you do so.
    Be clear to your users that you're using itemdb.com.br data. Include a link to our site or to the Contribute page so they can help make our data always accurate (you can also use our logo with a link)
    We love seeing what you create with itemdb. If you made something nice, hit me up at lucca[at]itemdb.com.br
    📌
    Note that itemdb is under constant development and these api endpoints are subject to changes without notice...
    ...and things can break

    Rate Limit#

    We have a item-based rate limit to ensure our api availability. Instead of tracking your requests we track how many items you got from each request. After hitting a certain number (few tens of thousands) you will receive 429 errors.
    Item data don't change much, so try to implement caching techniques and not fetch it everytime...
    If you have a very cool project and need a larger limit, we can talk :)
    Modified at 2025-03-03 17:42:28
    Next
    Slugs
    Built with