---
title: "Search every catalogue by name"
method: GET
path: "/search"
tags: ["Reference data"]
---

# Search every catalogue by name

`GET /search`

## Request

- Base URL: `https://michaelghelfistudios.com/api/v1`
- URL: `https://michaelghelfistudios.com/api/v1/search`
- Auth: none declared

One query across every catalogue: metals, minerals, ingredients, potions, gems, the milieux, animals, plants and creatures of Biomes, and the reference pages of Hearth, Passage and Bearer. Exact names first, then prefixes, then substrings (aliases and synonyms count). The go-to endpoint for a chat bot's `!lookup` command.

## Query parameters

- `q` string, required
- `kind` string
- `limit` integer
- `lang` 'en' | 'fr' | 'all'

## Response `200`

Best matches first.

- object
  - `success` true
  - `data` object[]
    - `kind` string
    - `id` string
    - `name` unknown
    - `summary` string
    - `url` string
    - `embed_url` string
    - `api_url` string: The entry's own endpoint.
  - `meta` object
    - `version` 'v1'
    - `lang` string
    - `q` string
    - `total` integer
    - `license` object
      - `name` string
      - `url` string
      - `attribution` string
  - `links` object
    - `self` string
    - `docs` string

---

[API](https://skmtc.dev/michaelghelfistudios/apis/mgs-toolbox-public-api.md) · [All operations](https://skmtc.dev/michaelghelfistudios/apis/mgs-toolbox-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/michaelghelfistudios/apis/mgs-toolbox-public-api/revisions/20d2b0932478?raw)