1. Search
itemdb API Guide
  • General
    • Getting Started
    • API Access
    • Slugs
    • Widget
      • Widget
      • Tab Example
  • v1
    • Item
      • Get latest items
      • Get an item
      • Get item's price history
      • Get item's auction history
      • Get item's restock history
      • Get item's trade history
      • Get items color palette
      • Get item's color palette
      • Get many items
      • Get many items
      • Get Item Drops Data
      • Get Dyeworks Variants
      • Get MME Paths
      • Get Item Effects
      • Get Cooking Pot Recipes
    • Search
      • Search for an item
    • Lists
      • Get List Info
      • Get List Item Info
      • Get List Item Data
    • Misc
      • Get all ways to change a Pet Color/Species
      • Get wearable preview
      • Get cached item's thumbnail
    • Schemas
      • Schemas
        • SaleStatus
        • ItemMallData
        • UseTypes
        • ListData
        • ListItemInfo
        • ItemData
        • itemColorData
        • ItemPriceData
        • OwlsData
        • ItemRestockData
        • ItemAuctionData
        • TradeData
        • TradeItem
        • UserList
        • ListItemInfo
        • ColorData
        • SearchFilters
  • v2
    • Intents & Cache
    • Items
      • Get a single item
      • Get many items
      • Get many items
    • Search
      • Search items
        GET
    • Lists
      • Get a list's items
    • Schemas
      • ItemIntent
      • ItemFlags
      • ItemPriceField
      • ItemPriceV2
      • NCValue
      • ItemSaleStatusV2
      • UseTypes
      • ThreeStateBoolean
      • ItemV2Minimal
      • ItemV2Card
      • ItemV2Pricer
      • ItemV2Full
      • Error
  1. Search

Search items

GET
https://itemdb.com.br/api/v2/search
Filters/sort/pagination mirror /api/v1/search; only the response shape (ItemV2) changes. totalResults is opt-in via includeStats=true (otherwise it just equals the page length).
Cache: Not CDN-cached in this phase (Cache-Control: private, no-store). Every returned item counts toward API quota. Default intent is card.

Request

Query Params

Responses

🟢200
application/json
Search results page.
Bodyapplication/json

Example
{
    "content": [
        {
            "internal_id": 0,
            "item_id": 0,
            "name": "string",
            "description": "string",
            "image": {
                "url": "string",
                "id": "string",
                "hash": "string"
            },
            "type": "np",
            "status": "string",
            "slug": "string"
        }
    ],
    "page": 0,
    "totalResults": 0,
    "resultsPerPage": 0
}
🟠400
🟠401
Modified at 2026-07-22 23:09:58
Previous
Get many items
Next
Get a list's items
Built with