itemdb API Guide
  1. Lists
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
  1. Lists

Get List Item Data

GET
https://itemdb.com.br/api/v1/lists/{username}/{list_id_or_slug}/itemdata
Returns all items from that list

Request

Path Params
username
string 
required
Owner's Username
Example:
official
list_id_or_slug
string 
required
List ID or List Slug. Slugs are unique per user (ie: diferent users can have the same list slug)
Example:
weekly-quest-prize

Responses

🟢200Success
application/json
Body
array of:
internal_id
number 
optional
itemdb internal id for this item
item_id
number  | null 
optional
Represents the id that Neopets uses for this item
name
string 
optional
description
string 
optional
image
string 
optional
item thumbnail url
image_id
string 
optional
represents the item's image filename without the file extension aka .gif
category
string  | null 
optional
item official "type"
rarity
number  | null 
optional
weight
number  | null 
optional
estVal
number  | null 
optional
Neopets Official Estimate Value for this item.
Does not reflect the actual item price
type
enum<string> 
optional
Represents whether is a NP, NC or Paint Brush item
Allowed values:
npncpb
Default:
np
isNC
boolean 
optional
whether is a Neocash Item
defaults to false if we don't have all the information about the item
isWearable
boolean 
optional
whether is an wearable Item
defaults to false if we don't have all the information about the item
isNeohome
boolean 
optional
whether is an neohome item
defaults to false if we don't have all the information about the item
status
enum<string> 
optional
item status
defaults to 'active' if we don't have all the information about the item
Allowed values:
activeno trade
comment
string  | null 
optional
any relevant comment about this item
color
object (itemColorData) 
optional
object with information about the vibrant color of this item.
hex
string 
optional
the hex code for this color
Example:
#fff000
lab
array[number]
optional
the LAB color space representation
>= 3 items<= 3 items
rgb
array[number]
optional
RGB color representation
>= 3 items<= 3 items
hsv
array[number]
optional
HSV color representation
>= 3 items<= 3 items
type
optional
represents the color type (always "vibrant" in this case)
Allowed value:
vibrant
population
number 
optional
population of the color in the item image
findAt
object 
optional
Convenience links to find this item in places such as SDB, Shops, Shop Wizard, etc...
shopWizard
string  | null 
optional
auction
string  | null 
optional
trading
string  | null 
optional
closet
string  | null 
optional
safetyDeposit
string  | null 
optional
restockShop
string  | null 
optional
dti
string  | null 
optional
price
object (ItemPriceData) 
optional
Market value data for this item.
addedAt
string  | null 
optional
Date string in the ISO 8601 format
Example:
2023-03-23T18:52:57.056Z
value
number  | null 
optional
item market price in neopoints
inflated
boolean 
optional
whether this item price is currently inflated
owls
object (OwlsData)  | null 
optional
Owls NC Value data
pricedAt
string 
optional
Date string in the ISO 8601 format
valueMin
integer 
optional
The lowest cap value as a number or 0 if the value field is not a cap value
value
string 
optional
The Owls Value (it's not always a cap value)
buyable
boolean 
optional
Whenever this item is currently for sale on NC Mall
isMissingInfo
boolean 
optional
Whether there is missing data or not. Keep in mind that fields with default values may be incorrect even if this field is false
slug
string  | null 
optional
URL Slug
saleStatus
optional
Any of
sold
integer 
optional
Total of items sold
total
integer 
optional
Total available in the market
percent
integer 
optional
Percent sold
status
enum<string> 
optional
Allowed values:
etsregularhts
addedAt
string <date-time>
optional
type
string 
deprecated
canonical_id
integer  | null 
optional
When we have duplicates, one item is chosen as the Canonical one
useTypes
object (UseTypes) 
optional
canEat
enum<string> 
optional
Allowed values:
truefalseunknown
canRead
enum<string> 
optional
Allowed values:
truefalseunknown
canOpen
enum<string> 
optional
Allowed values:
truefalseunknown
canPlay
enum<string> 
optional
Allowed values:
truefalseunknown
firstSeen
string <date-time> | null 
optional
First time we seen an item. Only exists for items released after itemdb was created
mallData
optional
Any of
price
integer 
optional
saleBegin
string  | null 
optional
saleEnd
string  | null 
optional
discountBegin
string  | null 
optional
discountEnd
string  | null 
optional
discountPrice
integer 
optional
Example
[
    {
        "internal_id": 71,
        "image": "https://images.neopets.com/items/negg.gif",
        "image_id": "negg",
        "item_id": 8,
        "rarity": 45,
        "name": "Negg",
        "specialType": "trading",
        "isNC": false,
        "type": "np",
        "estVal": 4371,
        "weight": 3,
        "description": "A Negg is a Neopian delicacy.  *** WORTH 1 NEGG POINT AT THE NEGGERY ***",
        "status": "active",
        "category": "Food",
        "isNeohome": false,
        "isWearable": false,
        "color": {
            "hsv": [
                28.643216080402,
                98.02955665024629,
                79.6078431372549
            ],
            "rgb": [
                203,
                99,
                4
            ],
            "lab": [
                53.63108729347468,
                36.90719903461171,
                61.33641181173597
            ],
            "hex": "#CB6304",
            "type": "vibrant",
            "population": 58
        },
        "findAt": {
            "safetyDeposit": "https://www.neopets.com/safetydeposit.phtml?obj_name=Negg&category=0",
            "shopWizard": "https://www.neopets.com/shops/wizard.phtml?string=Negg",
            "auction": "https://www.neopets.com/genie.phtml?type=process_genie&criteria=exact&auctiongenie=Negg",
            "trading": "https://www.neopets.com/island/tradingpost.phtml?type=browse&criteria=item_exact&search_string=Negg",
            "closet": null,
            "restockShop": "https://www.neopets.com/objects.phtml?type=shop&obj_type=1",
            "dti": null
        },
        "isMissingInfo": false,
        "price": {
            "value": 22450,
            "addedAt": "2023-03-23T06:32:55.181Z",
            "inflated": false
        },
        "comment": null
    }
]
Modified at 2025-03-02 21:36:40
Previous
Get List Item Info
Next
Get all ways to change a Pet Color/Species
Built with