itemdb API Guide
  1. Item
itemdb API Guide
  • Getting Started
  • Slugs
  • Widget
  • Widget Tabs Exemple
  • Item
    • Get latest items
      GET
    • Get a 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. Item

Get many items

POST
/items/many
Get many items at once. Userful for bulk

Request

Body Params application/json
id
array[number]
optional
Array of internal_id
item_id
array[number]
optional
Array of item_id
name
array[string]
optional
Array of item names
image_id
array[string]
optional
Array of image_id
name_image_id
array [array] 
optional
Array of tuples [name, image_id]
string 
optional
Example
{
  "id": [
    0
  ],
  "item_id": [
    0
  ],
  "name": [
    "string"
  ],
  "image_id": [
    "string"
  ],
  "name_image_id": [
    [
      "string",
      "string"
    ]
  ]
}

Responses

🟢200OK
application/json
returns an object as {[identificator: string]: ItemData}
where identificator is the param type you sended.
if you use the name_image_id param, the identificator will be encodeURI(name)_image_id. Check the encodeURI documentation
Body
[identificator]
object (ItemData) 
optional
Represents an item
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}
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.
findAt
object 
optional
Convenience links to find this item in places such as SDB, Shops, Shop Wizard, etc...
price
object (ItemPriceData) 
optional
Market value data for this item.
owls
object (OwlsData)  | null 
optional
Owls NC Value data
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
canonical_id
integer  | null 
optional
When we have duplicates, one item is chosen as the Canonical one
useTypes
object (UseTypes) 
optional
firstSeen
string <date-time> | null 
optional
First time we seen an item. Only exists for items released after itemdb was created
mallData
optional
Example
{
  "71": {
    "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": [
        null,
        null,
        null
      ],
      "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": "Thu Mar 23 2023 07:32:55 GMT+0100 (Central European Standard Time)",
      "inflated": false
    },
    "comment": null
  },
  "75": {
    "internal_id": 75,
    "image": "https://images.neopets.com/items/magic_mote_bubble.gif",
    "image_id": "magic_mote_bubble",
    "item_id": 24,
    "rarity": 58,
    "name": "Bubble Mote",
    "specialType": null,
    "isNC": false,
    "type": "np",
    "estVal": 175,
    "weight": 1,
    "description": "The bubble mote is most effective against fire attacks and can temporarily give your creature invisibility.",
    "status": "active",
    "category": "Brightvale Motes",
    "isNeohome": false,
    "isWearable": false,
    "color": {
      "hsv": [
        null,
        null,
        null
      ],
      "rgb": [
        8.895348837209262,
        246.1046511627907,
        246.1046511627907
      ],
      "lab": [
        88.30102877129474,
        -46.62106738211241,
        -13.7189518283185
      ],
      "hex": "#09F6F6",
      "type": "vibrant",
      "population": 0
    },
    "findAt": {
      "safetyDeposit": "https://www.neopets.com/safetydeposit.phtml?obj_name=Bubble+Mote&category=0",
      "shopWizard": "https://www.neopets.com/shops/wizard.phtml?string=Bubble+Mote",
      "auction": "https://www.neopets.com/genie.phtml?type=process_genie&criteria=exact&auctiongenie=Bubble+Mote",
      "trading": "https://www.neopets.com/island/tradingpost.phtml?type=browse&criteria=item_exact&search_string=Bubble+Mote",
      "closet": null,
      "restockShop": "https://www.neopets.com/objects.phtml?type=shop&obj_type=82",
      "dti": null
    },
    "isMissingInfo": false,
    "price": {
      "value": 4,
      "addedAt": "Tue Mar 21 2023 01:33:02 GMT+0100 (Central European Standard Time)",
      "inflated": false
    },
    "comment": null
  },
  "127": {
    "internal_id": 127,
    "image": "https://images.neopets.com/items/purpletradingcardback.gif",
    "image_id": "purpletradingcardback",
    "item_id": 476,
    "rarity": null,
    "name": "Ursula Usul",
    "specialType": "uncommon",
    "isNC": false,
    "type": "np",
    "estVal": null,
    "weight": null,
    "description": "This dedicated Usul has just one focus in life, to be the Ultimate Gormball Champion.  She has studied her entire life for this and wont be beaten easily.",
    "status": "active",
    "category": "Collectable Card",
    "isNeohome": false,
    "isWearable": false,
    "color": {
      "hsv": [
        null,
        null,
        null
      ],
      "rgb": [
        188,
        86,
        188
      ],
      "lab": [
        52.92517135891461,
        54.84055107884767,
        -35.33937842544705
      ],
      "hex": "#BC56BC",
      "type": "vibrant",
      "population": 6
    },
    "findAt": {
      "safetyDeposit": "https://www.neopets.com/safetydeposit.phtml?obj_name=Ursula+Usul&category=0",
      "shopWizard": "https://www.neopets.com/shops/wizard.phtml?string=Ursula+Usul",
      "auction": "https://www.neopets.com/genie.phtml?type=process_genie&criteria=exact&auctiongenie=Ursula+Usul",
      "trading": "https://www.neopets.com/island/tradingpost.phtml?type=browse&criteria=item_exact&search_string=Ursula+Usul",
      "closet": null,
      "restockShop": null,
      "dti": null
    },
    "isMissingInfo": true,
    "price": {
      "value": 1590,
      "addedAt": "Sun Mar 26 2023 16:56:27 GMT+0200 (Central European Summer Time)",
      "inflated": false
    },
    "comment": null
  }
}
Modified at 2025-03-02 19:23:37
Previous
Get many items
Next
Get Item Drops Data
Built with