---
title: "Filter glossary terms for source content"
method: POST
path: "/api/v1/filter"
tags: ["Filter"]
---

# Filter glossary terms for source content

`POST /api/v1/filter`

## Request

- Base URL: `https://glossary.ethereum.org`
- URL: `https://glossary.ethereum.org/api/v1/filter`
- Auth: none declared
- TypeScript: <https://skmtc.dev/ethereum/apis/ethglossary-api/docs/api/v1/filter/post.ts> (a function with typed inputs; its response is checked against the schema)

Send source text and get back the glossary terms relevant to that content. Strips code blocks, inline code, and URLs before matching. Max 1MB content size.

## Request body

- FilterRequest
  - `content` string, required: Source text to filter against (max 1MB)
  - `language` string, required: Target language code
  - `fileType` 'markdown' | 'json': Source content type (affects text extraction)
  - `includeExamples` boolean: Include example sentences for high-frequency terms (2+ occurrences)

## Response `200`

Matching glossary terms

- FilterResponse
  - `language` string, required
  - `matchedTerms` number, required
  - `totalScanned` number, required
  - `terms` object[], required
    - `english` string, required
    - `translation` string, required
    - `note` string
    - `example` string
    - `occurrences` number, required

## Other responses

- `400`: Invalid request

---

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