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

Get all ways to change a Pet Color/Species

GET
https://itemdb.com.br/api/v1/tools/petcolors
Returns all the known ways to change a pet to the desired color/specie
You can provide a colorTarget and/or a speciesTarget

Request

Query Params
colorTarget
string 
optional
A color name
Example:
baby
speciesTarget
string 
optional
A species name
Example:
acara

Responses

🟢200Success
application/json
Body
speciesId
integer 
optional
colorId
integer 
optional
thumbnail
object 
optional
species
string 
optional
color
string 
optional
speciesName
string 
optional
colorName
string 
optional
perfectMatch
array[object (ItemData) {27}] 
optional
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
colorChanges
array[object (ItemData) {27}] 
optional
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
speciesChanges
array[object (ItemData) {27}] 
optional
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
cheapestChange
array[object (ItemData) {27}] 
optional
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
{
    "speciesId": 0,
    "colorId": 0,
    "thumbnail": {
        "species": "string",
        "color": "string"
    },
    "speciesName": "string",
    "colorName": "string",
    "perfectMatch": [
        {
            "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
        }
    ],
    "colorChanges": [
        {
            "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
        }
    ],
    "speciesChanges": [
        {
            "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
        }
    ],
    "cheapestChange": [
        {
            "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 20:34:40
Previous
Get List Item Data
Next
Get wearable preview
Built with