FilterLists

About FilterLists

FilterLists is a REST API (OpenAPI v1, ASP.NET Core) that serves information about filter lists — text files containing rules for blocking or manipulating internet traffic, such as those used by ad blockers and similar software. It exposes endpoints for retrieving filter lists and related metadata, including languages, licenses, maintainers, software, syntaxes, and tags.

The API covers entities such as the languages of sites a filter list targets, the license governing a list's use or redistribution, the maintainers responsible for a list, the software that consumes filter lists, the syntax formats lists follow, and tags describing a list's content or purpose. Endpoints include GET /lists, GET /lists/{id}, GET /languages, GET /licenses, GET /maintainers, GET /software, GET /syntaxes, and GET /tags.

It is intended for developers building or integrating tools that consume filter list data, such as ad-blocking or traffic-filtering software. The project is licensed under the MIT License.

Key features

• Provides a directory API for filter lists used to block or manipulate internet traffic
• Endpoints for querying filter lists by language, license, maintainer, software, syntax, and tags
• Returns detailed information for a single filter list via /lists/{id}
• OpenAPI 3.0 specification available at /v1/openapi.json

Frequently asked questions