---
title: "Match supplied text against the glossary"
method: POST
path: "/rest/glossary/match"
tags: ["glossary"]
---

# Match supplied text against the glossary

`POST /rest/glossary/match`

## Request

- Base URL: `https://api.seer.cancer.gov`
- URL: `https://api.seer.cancer.gov/rest/glossary/match`
- Auth: API key in header `X-SEERAPI-Key`
- TypeScript: <https://skmtc.dev/cancer/apis/seer-api/docs/rest/glossary/match/post.ts> (a function with typed inputs; its response is checked against the schema)

Given text input, return a list of all glossary matches.

## Query parameters

- `category` string[]
- `wholeWordsOnly` boolean

## Request body `text/plain`

- string: Text

## Response `201`

Success

- ApiKeywordMatch[]
  - `id` string
  - `name` string
  - `keyword` string
  - `category` string[]
  - `start` integer
  - `end` integer

## Other responses

- `415`: Unsupported Media Type

---

[API](https://skmtc.dev/cancer/apis/seer-api.md) - [All operations](https://skmtc.dev/cancer/apis/seer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cancer/apis/seer-api/revisions/f6634f7497ad?raw)