Advanced Search

Advanced marketplace search with filters and sorting.

Field	Type	Required	options	Notes
searchTerm	string	Yes
marketPlaceType	string	Yes	’buy’, ‘sell’
types	Object	Yes	See types	to pass in no options use `{}`
tags	Object	Yes	See tags	to pass in no options use `{}`
sortBy	string	Yes	See sort by	Default for ‘buy’ is `Sale available: high to low`. Default for ‘sell’ is `Purchase available: high to low`
limit	number	yes

index.ts

await api.advancedMarketplaceSearch(
  searchTerm,
  marketplaceType,
  types,
  tags,
  sortBy,
  limit
);

Here a Sample of the function:

sample.ts

const tags = {
  rarity: ["SuperRare"],
  seasons: [],
  operators: [],
  weapon: [],
  events: [],
  esportsTeams: [],
};
 
const types = {
  type: ["WeaponSkin"],
};
 
await api.advancedMarketplaceSearch(
  "Black Ice",
  "sell",
  types,
  tags,
  "Item names: A-Z",
  20
);

Example response

{
  "items": [
    {
      "id": "0d2ae42d-4c27-4cb7-af6c-2099062302bb-f4d787a6-a17d-40a5-9a05-22c924066e81",
      "assetUrl": "https://ubiservices.cdn.ubi.com/0d2ae42d-4c27-4cb7-af6c-2099062302bb/DeployerAssetsJune2023/ad2e679b_f8d4_38fc_6f01_1402dbea4ac8.png",
      "itemId": "f4d787a6-a17d-40a5-9a05-22c924066e81",
      "name": "BLACK ICE",
      "tags": [
        "M590A1",
        "Texture",
        "W_SG_591A1",
        "Y1S1",
        "sku_china",
        "sku_ww",
        "type_weapon_skins",
        "type_weaponskin",
        "rarity_superrare",
        "lc_classic-edition-v0",
        "lc_yttrium-edition-v0"
      ],
      "type": "WeaponSkin",
      "marktetData": {
        "id": "0d2ae42d-4c27-4cb7-af6c-2099062302bb-f4d787a6-a17d-40a5-9a05-22c924066e81",
        "sellStats": {
          "id": "0d2ae42d-4c27-4cb7-af6c-2099062302bb-f4d787a6-a17d-40a5-9a05-22c924066e81-9ef71262-515b-46e8-b9a8-b6b6ad456c67-sell",
          "paymentItemId": "9ef71262-515b-46e8-b9a8-b6b6ad456c67",
          "lowestPrice": 400,
          "highestPrice": 1000000,
          "activeCount": 2065
        },
        "buyStats": {
          "id": "0d2ae42d-4c27-4cb7-af6c-2099062302bb-f4d787a6-a17d-40a5-9a05-22c924066e81-9ef71262-515b-46e8-b9a8-b6b6ad456c67-buy",
          "paymentItemId": "9ef71262-515b-46e8-b9a8-b6b6ad456c67",
          "lowestPrice": 10,
          "highestPrice": 330,
          "activeCount": 1928
        },
        "lastSoldAt": {
          "id": "0d2ae42d-4c27-4cb7-af6c-2099062302bb-f4d787a6-a17d-40a5-9a05-22c924066e81-9ef71262-515b-46e8-b9a8-b6b6ad456c67-last",
          "paymentItemId": "9ef71262-515b-46e8-b9a8-b6b6ad456c67",
          "price": 400,
          "performedAt": "2024-10-06T11:06:17.944Z"
        }
      }
    },
    {
      "id": "0d2ae42d-4c27-4cb7-af6c-2099062302bb-f3fde1b4-329c-4dc7-9e22-987cc6c77b04",
      "assetUrl": "https://ubiservices.cdn.ubi.com/0d2ae42d-4c27-4cb7-af6c-2099062302bb/DeployerAssetsJune2023/08f7a0ba_be13_9f01_4ff9_8026b07e5ecd.png",
      "itemId": "f3fde1b4-329c-4dc7-9e22-987cc6c77b04",
      "name": "BLACK ICE",
      "tags": [
        "P226_MK_25",
        "Texture",
        "W_SA_P226",
        "Y1S1",
        "sku_china",
        "sku_ww",
        "type_weapon_skins",
        "type_weaponskin",
        "rarity_superrare",
        "lc_classic-edition-v0"
      ],
      "type": "WeaponSkin",
      "marktetData": {
        "id": "0d2ae42d-4c27-4cb7-af6c-2099062302bb-f3fde1b4-329c-4dc7-9e22-987cc6c77b04",
        "sellStats": {
          "id": "0d2ae42d-4c27-4cb7-af6c-2099062302bb-f3fde1b4-329c-4dc7-9e22-987cc6c77b04-9ef71262-515b-46e8-b9a8-b6b6ad456c67-sell",
          "paymentItemId": "9ef71262-515b-46e8-b9a8-b6b6ad456c67",
          "lowestPrice": 160,
          "highestPrice": 803723,
          "activeCount": 153
        },
        "buyStats": {
          "id": "0d2ae42d-4c27-4cb7-af6c-2099062302bb-f3fde1b4-329c-4dc7-9e22-987cc6c77b04-9ef71262-515b-46e8-b9a8-b6b6ad456c67-buy",
          "paymentItemId": "9ef71262-515b-46e8-b9a8-b6b6ad456c67",
          "lowestPrice": 10,
          "highestPrice": 110,
          "activeCount": 131
        },
        "lastSoldAt": {
          "id": "0d2ae42d-4c27-4cb7-af6c-2099062302bb-f3fde1b4-329c-4dc7-9e22-987cc6c77b04-9ef71262-515b-46e8-b9a8-b6b6ad456c67-last",
          "paymentItemId": "9ef71262-515b-46e8-b9a8-b6b6ad456c67",
          "price": 160,
          "performedAt": "2024-10-06T11:05:49.128Z"
        }
      }
    },
    {
      "id": "0d2ae42d-4c27-4cb7-af6c-2099062302bb-b1cdb343-8ca2-4f7e-b489-af66bfe914cd",
      "assetUrl": "https://ubiservices.cdn.ubi.com/0d2ae42d-4c27-4cb7-af6c-2099062302bb/DeployerAssetsJune2023/dd1d42bd_53ce_0c52_e256_4808fb7667ac.png",
      "itemId": "b1cdb343-8ca2-4f7e-b489-af66bfe914cd",
      "name": "BLACK ICE",
      "tags": [
        "SMG-11",
        "Texture",
        "W_MP_MAC11",
        "Y1S1",
        "sku_china",
        "sku_ww",
        "type_weapon_skins",
        "type_weaponskin",
        "rarity_superrare",
        "lc_classic-edition-v0",
        "lc_platinum-edition-v0"
      ],
      "type": "WeaponSkin",
      "marktetData": {
        "id": "0d2ae42d-4c27-4cb7-af6c-2099062302bb-b1cdb343-8ca2-4f7e-b489-af66bfe914cd",
        "sellStats": {
          "id": "0d2ae42d-4c27-4cb7-af6c-2099062302bb-b1cdb343-8ca2-4f7e-b489-af66bfe914cd-9ef71262-515b-46e8-b9a8-b6b6ad456c67-sell",
          "paymentItemId": "9ef71262-515b-46e8-b9a8-b6b6ad456c67",
          "lowestPrice": 1000,
          "highestPrice": 1000000,
          "activeCount": 1903
        },
        "buyStats": {
          "id": "0d2ae42d-4c27-4cb7-af6c-2099062302bb-b1cdb343-8ca2-4f7e-b489-af66bfe914cd-9ef71262-515b-46e8-b9a8-b6b6ad456c67-buy",
          "paymentItemId": "9ef71262-515b-46e8-b9a8-b6b6ad456c67",
          "lowestPrice": 10,
          "highestPrice": 890,
          "activeCount": 4186
        },
        "lastSoldAt": {
          "id": "0d2ae42d-4c27-4cb7-af6c-2099062302bb-b1cdb343-8ca2-4f7e-b489-af66bfe914cd-9ef71262-515b-46e8-b9a8-b6b6ad456c67-last",
          "paymentItemId": "9ef71262-515b-46e8-b9a8-b6b6ad456c67",
          "price": 1000,
          "performedAt": "2024-10-06T11:05:41.995Z"
        }
      }
    }
  ]
}

Basic Search Get Item Details