---
title: "Search the piece set gallery by name, style, or game type"
method: POST
path: "/api/tools/piece_gallery_search"
---

# Search the piece set gallery by name, style, or game type

`POST /api/tools/piece_gallery_search`

## Request

- Base URL: `https://tools.moddable.games`
- URL: `https://tools.moddable.games/api/tools/piece_gallery_search`
- Auth: none declared

## Request body

- object
  - `query` string, required: Search term (e.g. "staunton", "pixel", "shogi")
  - `family` string: Filter by game family (chess, shogi, xiangqi, draughts, go, etc)
  - `limit` number: Max results (default 10)

## Response `200`

Tool result

---

[API](https://skmtc.dev/moddable/apis/moddable-games-tools.md) · [All operations](https://skmtc.dev/moddable/apis/moddable-games-tools/llms.txt) · [OpenAPI document](https://skmtc.dev/moddable/apis/moddable-games-tools/revisions/637a0b62cb9a?raw)