Explore Items

curl --request GET \
  --url 'https://openapi.msu.io/v1rc1/search/items?paginationParam.pageNo=1&paginationParam.pageSize=30' \
  --header 'Content-Type: application/json' \
  --header 'x-nxopen-api-key: YOUR_API_KEY'

const response = await fetch('https://openapi.msu.io/v1rc1/search/items?paginationParam.pageNo=1&paginationParam.pageSize=30', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
    'x-nxopen-api-key': 'YOUR_API_KEY'
  }
});
const data = await response.json();

import requests

url = "https://openapi.msu.io/v1rc1/search/items"
params = {
  "paginationParam.pageNo": 1,
  "paginationParam.pageSize": 30
}
headers = {
  "x-nxopen-api-key": "YOUR_API_KEY"
}

response = requests.get(url, params=params, headers=headers)
data = response.json()

{
  "success": true,
  "data": {
    "items": [],
    "paginationResult": {
      "totalCount": 0,
      "currPageNo": 1,
      "pageSize": 30,
      "isLastPage": true
    }
  }
}

GET

v1rc1

items

curl --request GET \
  --url 'https://openapi.msu.io/v1rc1/search/items?paginationParam.pageNo=1&paginationParam.pageSize=30' \
  --header 'Content-Type: application/json' \
  --header 'x-nxopen-api-key: YOUR_API_KEY'

const response = await fetch('https://openapi.msu.io/v1rc1/search/items?paginationParam.pageNo=1&paginationParam.pageSize=30', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
    'x-nxopen-api-key': 'YOUR_API_KEY'
  }
});
const data = await response.json();

import requests

url = "https://openapi.msu.io/v1rc1/search/items"
params = {
  "paginationParam.pageNo": 1,
  "paginationParam.pageSize": 30
}
headers = {
  "x-nxopen-api-key": "YOUR_API_KEY"
}

response = requests.get(url, params=params, headers=headers)
data = response.json()

{
  "success": true,
  "data": {
    "items": [],
    "paginationResult": {
      "totalCount": 0,
      "currPageNo": 1,
      "pageSize": 30,
      "isLastPage": true
    }
  }
}

Header parameters

msu-authorization

string

Auth token. When provided, search filters are applied; without it, filters are not applied.

Query parameters

filter.name

string

Item name partial match (bidirectional wildcard, case-sensitive)

filter.mintingNo

integer

Minting number (exact match)

filter.categoryNo

integer

Category number (exact match)

filter.itemId

integer

Item meta ID (exact match)

filter.classes

array

Class code filter (OR condition). Include all_classes to remove filter

filter.achievedCharName

string

History achievement character name (exact match, case-sensitive)

filter.color

array

Color code filter for beauty/hair items (OR condition). Include all_colors to remove filter

filter.PetSkills

array

Pet skill code filter (OR condition)

filter.price.min

number

Minimum price (NESO, ≥0)

filter.price.max

number

Maximum price (NESO, ≥min)

filter.level.min

integer

Minimum required level

filter.level.max

integer

Maximum required level (≥min)

filter.starforce.min

integer

Minimum Starforce (valid range: 0–25)

filter.starforce.max

integer

Maximum Starforce

filter.potential.min

integer

Minimum Potential grade (0: Normal, 1: Rare, 2: Epic, 3: Unique, 4: Legendary)

filter.potential.max

integer

Maximum Potential grade

filter.bonusPotential.min

integer

Minimum additional Potential grade

filter.bonusPotential.max

integer

Maximum additional Potential grade

sorting

string

Sort criterion (HIGHEST_PRICE, LOWEST_PRICE, ENDING_SOON, RECENTLY_LISTED)

paginationParam.pageNo

integer

Page number (starting from 1, default: 1)

paginationParam.pageSize

integer

Page size (default: 30). Combined offset of (pageNo-1) × pageSize must not exceed 10,000

Response

success

boolean

Indicates if the request was successful

data

object

Show properties

items

array

List of items on sale

paginationResult.totalCount

integer

Total result count

paginationResult.currPageNo

integer

Current page number

paginationResult.pageSize

integer

Page size

paginationResult.isLastPage

boolean

Whether this is the last page

curl --request GET \
  --url 'https://openapi.msu.io/v1rc1/search/items?paginationParam.pageNo=1&paginationParam.pageSize=30' \
  --header 'Content-Type: application/json' \
  --header 'x-nxopen-api-key: YOUR_API_KEY'

const response = await fetch('https://openapi.msu.io/v1rc1/search/items?paginationParam.pageNo=1&paginationParam.pageSize=30', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
    'x-nxopen-api-key': 'YOUR_API_KEY'
  }
});
const data = await response.json();

import requests

url = "https://openapi.msu.io/v1rc1/search/items"
params = {
  "paginationParam.pageNo": 1,
  "paginationParam.pageSize": 30
}
headers = {
  "x-nxopen-api-key": "YOUR_API_KEY"
}

response = requests.get(url, params=params, headers=headers)
data = response.json()

{
  "success": true,
  "data": {
    "items": [],
    "paginationResult": {
      "totalCount": 0,
      "currPageNo": 1,
      "pageSize": 30,
      "isLastPage": true
    }
  }
}

Stream Reward History Explore Characters

⌘I

MSU Builder

MSU Resources

MSU OPEN API

Header parameters

Query parameters

Response

​Header parameters

​Query parameters

​Response

Header parameters

Query parameters

Response