---
title: "Find and get shop data"
method: GET
path: "/raw/{region}/shop/search"
tags: ["raw"]
---

# Find and get shop data

`GET /raw/{region}/shop/search`

Find and get shop data

## Path parameters

- `region` 'JP' | 'NA' | 'CN' | 'KR' | 'TW', required — Region Enum

## Query parameters

- `name` string, nullable
- `eventId` integer[]
- `type` NiceShopType[]
- `payType` NicePayType[]
- `purchaseType` NicePurchaseType[]
- `limit` integer

## Response `200`

Shop Entities

- ShopEntity[]
  - `mstShop` MstShop, required
    - `itemIds` integer[], required
    - `prices` integer[], required
    - `targetIds` integer[], required
    - `script` object, required
    - `anotherPayType` integer, nullable
    - `anotherItemIds` integer[], nullable
    - `useAnotherPayCommonReleaseId` integer, nullable
    - `freeShopCondId` integer, nullable
    - `freeShopCondMessage` string, nullable
    - `hideWarningMessageCondId` integer, nullable
    - `freeShopReleaseDate` integer, nullable
    - `id` integer, required
    - `baseShopId` integer, required
    - `eventId` integer, required
    - `slot` integer, required
    - `flag` integer, required
    - `priority` integer, required
    - `purchaseType` integer, required
    - `setNum` integer, required
    - `payType` integer, required
    - `shopType` integer, required
    - `limitNum` integer, required
    - `defaultLv` integer, required
    - `defaultLimitCount` integer, required
    - `name` string, required
    - `detail` string, required
    - `infoMessage` string, required
    - `warningMessage` string, required
    - `imageId` integer, required
    - `bgImageId` integer, required
    - `openedAt` integer, required
    - `closedAt` integer, required
  - `mstSetItem` MstSetItem[], required
    - `id` integer, required
    - `purchaseType` integer, required
    - `targetId` integer, required
    - `setNum` integer, required
    - `createdAt` integer
  - `mstShopRelease` MstShopRelease[], required
    - `condValues` integer[], required
    - `shopId` integer, required
    - `condType` integer, required
    - `condNum` integer, required
    - `priority` integer, required
    - `isClosedDisp` boolean, required
    - `closedMessage` string, required
    - `closedItemName` string, required
  - `mstShopScript` MstShopScript
    - `ignoreEventIds` integer[], required
    - `shopId` integer, required
    - `priority` integer, required
    - `name` string, required
    - `scriptId` string, required
    - `frequencyType` integer, required
    - `eventId` integer, required
    - `svtId` integer, required
    - `limitCount` integer, required
    - `materialFolderId` integer, required
  - `mstItem` MstItem[], required
    - `individuality` integer[], required
    - `script` object, required
    - `eventId` integer
    - `eventGroupId` integer
    - `isPresent` boolean
    - `maxNum` integer
    - `id` integer, required
    - `name` string, required
    - `detail` string, required
    - `imageId` integer, required
    - `bgImageId` integer, required
    - `type` integer, required
    - `unit` string, required
    - `value` integer, required
    - `sellQp` integer, required
    - `isSell` boolean, required
    - `priority` integer, required
    - `dropPriority` integer, required
    - `startedAt` integer, required
    - `endedAt` integer, required
    - `useSkill` boolean
    - `useAppendSkill` boolean
    - `useAscension` boolean
    - `useCostume` boolean
    - `mstItemSelect` MstItemSelect[]
      - `itemId` integer, required
      - `idx` integer, required
      - `candidateGiftId` integer, required
      - `requireNum` integer, required
      - `detail` string, required
    - `mstGift` MstGift[]
      - `sort_id` integer
      - `id` integer, required
      - `type` integer, required
      - `objectId` integer, required
      - `priority` integer, required
      - `num` integer, required
      - `lv` integer, nullable
      - `limitCount` integer, nullable
    - `mstGiftAdd` MstGiftAdd[]
      - `priorGiftIconIds` integer[], required
      - `giftId` integer, required
      - `priority` integer, nullable
      - `condType` integer, required
      - `targetId` integer, required
      - `targetNum` integer, required
      - `priorGiftId` integer, required
      - `script` string, required
  - `mstGift` MstGift[], required
    - `sort_id` integer
    - `id` integer, required
    - `type` integer, required
    - `objectId` integer, required
    - `priority` integer, required
    - `num` integer, required
    - `lv` integer, nullable
    - `limitCount` integer, nullable
  - `mstGiftAdd` MstGiftAdd[], required
    - `priorGiftIconIds` integer[], required
    - `giftId` integer, required
    - `priority` integer, nullable
    - `condType` integer, required
    - `targetId` integer, required
    - `targetNum` integer, required
    - `priorGiftId` integer, required
    - `script` string, required
  - `mstCommonConsume` MstCommonConsume[], required
    - `id` integer, required
    - `priority` integer, required
    - `type` integer, required
    - `objectId` integer, required
    - `num` integer, required
  - `mstCommonRelease` MstCommonRelease[], required
    - `id` integer, required
    - `priority` integer, required
    - `condGroup` integer, required
    - `condType` integer, required
    - `condId` integer, required
    - `condNum` integer, required

## Other responses

- `400` — Insufficient query
- `403` — Response too big
- `422` — Validation Error

---

[API](https://skmtc.dev/atlasacademy/apis/fgo-game-data-api.md) · [All operations](https://skmtc.dev/atlasacademy/apis/fgo-game-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/atlasacademy/apis/fgo-game-data-api/revisions/188da1780d29?raw)