Docs
Open Lodol
DocumentationIntegrationsAPI

FilterLists

App · Compliance & Security · 8 actions

Find the filter and host lists that ad blockers, DNS blockers and firewalls subscribe to, with the free, open-source FilterLists directory: more than 2,000 lists that block ads, trackers, malware, phishing and annoyances. Search them by words, tag, language, syntax, the software that can use them, license or maintainer, watch for lists added since a workflow last looked, and get a list's subscription URL and mirrors, home page, issue tracker and the lists it forks, includes or depends on. List the tags, languages, syntaxes, software, licenses and maintainers the directory uses too. Every action only reads. No account or API key required.

Actions

ActionWhat it does
Get a filter listGet one filter list by id, name or its filterlists.com link: the URL to subscribe to and its mirrors, what it blocks, its syntaxes, languages, license and maintainers, the software that can use it, its home page, issue tracker and forum, and the lists it was forked from, includes or depends on.
List languagesList the languages FilterLists has lists for, with each one's two letter code and how many lists are made for sites in it, optionally only those whose name or code holds some words.
List licensesList the licenses filter lists are released under, with whether FilterLists records that each allows changes and commercial use, and how many lists use it, optionally only those whose name holds some words.
List maintainersList the people, groups and companies that maintain filter lists, with their home pages, email addresses and X handles where FilterLists has them and how many lists each maintains, optionally only those whose name holds some words.
List softwareList the ad blockers, DNS blockers, firewalls and other programs that use filter lists, such as uBlock Origin, AdGuard Home and Pi-hole, each with its home and download pages, the syntaxes it reads and how many lists it can use, optionally only those whose name holds some words.
List syntaxesList the syntaxes filter lists are written in, such as Adblock Plus, Domains and hosts files, each with how many lists use it and the programs that read it, optionally only those whose name holds some words.
List tagsList the tags FilterLists sorts lists by, such as ads, privacy, malware, phishing, cookies and annoyances, each with what it means and how many lists have it, optionally only those whose name holds some words.
Search filter listsSearch the more than 2,000 filter and host lists in the FilterLists directory by words in their name or description, tag (such as ads, privacy or malware), language, syntax, the software that can use them (such as uBlock Origin or Pi-hole), license or maintainer, a page at a time with the real total.

Get a filter list

Get one filter list by id, name or its filterlists.com link: the URL to subscribe to and its mirrors, what it blocks, its syntaxes, languages, license and maintainers, the software that can use it, its home page, issue tracker and forum, and the lists it was forked from, includes or depends on. No API key required.

Inputs

Filter listfilter_listtextRequired
The list's id, such as 301, its name, such as EasyList, or its page link, such as https://filterlists.com/lists/easylist. A name is matched ignoring case and accents, whole or by its words, but must fit one list; otherwise the step fails naming those it fits.

Outputs

listobject
The list, with where it is published and how it relates to others.
Example output
{
  "list": {
    "chat_url": null,
    "dependents": [],
    "depends_on": [],
    "description": "EasyList is the primary filter list that removes most adverts from international web pages, including unwanted frames, images, and objects. It is the most popular list used by many ad blockers and forms the basis of over a dozen combination and supplementary filter lists.",
    "donate_url": null,
    "email_address": "easylist@protonmail.com",
    "forked_from": [],
    "forks": [
      {
        "id": 166,
        "name": "AdGuard Base filter + EasyList (AdGuard for Chromium)"
      },
      {
        "id": 565,
        "name": "EasyList - Lite"
      }
    ],
    "forum_url": "https://forums.lanik.us/viewforum.php?f=23",
    "home_url": "https://easylist.to/",
    "id": 301,
    "included_in": [
      {
        "id": 11,
        "name": "Liste FR + EasyList"
      },
      {
        "id": 13,
        "name": "Liste AR + Liste FR + EasyList"
      },
      {
        "id": 168,
        "name": "AdGuard DNS Filter"
      }
    ],
    "includes": [],
    "issues_url": "https://github.com/easylist/easylist/issues",
    "languages": [
      {
        "code": "cy",
        "id": 30,
        "name": "Welsh"
      },
      {
        "code": "en",
        "id": 37,
        "name": "English"
      }
    ],
    "license": {
      "id": 4,
      "name": "GPLv3",
      "permits_commercial_use": true,
      "permits_modification": true,
      "url": "https://www.gnu.org/licenses/gpl-3.0.en.html"
    },
    "maintainers": [
      {
        "email_address": null,
        "id": 7,
        "name": "The EasyList Authors",
        "twitter_handle": null,
        "url": "https://easylist.to/"
      }
    ],
    "name": "EasyList",
    "onion_url": null,
    "page_url": "https://filterlists.com/lists/easylist",
    "policy_url": null,
    "software": [
      {
        "id": 1,
        "name": "uBlock Origin"
      },
      {
        "id": 2,
        "name": "Adblock Plus"
      },
      {
        "id": 3,
        "name": "AdGuard (free versions)"
      },
      {
        "id": 6,
        "name": "AdBlock"
      },
      {
        "id": 32,
        "name": "AdNauseam"
      },
      {
        "id": 39,
        "name": "pfBlockerNG"
      },
      {
        "id": 40,
        "name": "Opera's built-in adblocker"
      },
      {
        "id": 44,
        "name": "AdGuard for Windows/macOS"
      },
      {
        "id": 45,
        "name": "AdGuard for Android"
      },
      {
        "id": 46,
        "name": "Vivaldi's Privacy settings"
      }
    ],
    "submission_url": null,
    "syntaxes": [
      {
        "id": 3,
        "name": "Adblock Plus"
      }
    ],
    "tags": [
      {
        "description": "Blocks advertisements",
        "id": 2,
        "name": "ads"
      }
    ],
    "view_url": "https://easylist.to/easylist/easylist.txt",
    "view_urls": [
      {
        "primariness": 1,
        "segment": 1,
        "url": "https://easylist.to/easylist/easylist.txt"
      },
      {
        "primariness": 2,
        "segment": 1,
        "url": "https://fanboy.co.nz/easylist.txt"
      },
      {
        "primariness": 3,
        "segment": 1,
        "url": "https://easylist-downloads.adblockplus.org/easylist.txt"
      },
      {
        "primariness": 4,
        "segment": 1,
        "url": "https://downloads.vivaldi.com/easylist/easylist-current.txt"
      }
    ]
  }
}

List languages

List the languages FilterLists has lists for, with each one's two letter code and how many lists are made for sites in it, optionally only those whose name or code holds some words. No API key required.

Inputs

Namenametext
Only languages whose name or two letter code holds every one of these words, ignoring case and accents (for example, german, or de for German and every language with de in its name). Leave empty for all of them.

Outputs

countnumber
How many languages are listed.
languageslist
The languages, in alphabetical order.
Example output
{
  "count": 1,
  "languages": [
    {
      "code": "de",
      "id": 32,
      "list_count": 3,
      "name": "German"
    }
  ]
}

List licenses

List the licenses filter lists are released under, with whether FilterLists records that each allows changes and commercial use, and how many lists use it, optionally only those whose name holds some words. No API key required.

Inputs

Namenametext
Only licenses whose name holds every one of these words, ignoring case and accents (for example, cc by finds the Creative Commons licenses). Leave empty for all of them.

Outputs

countnumber
How many licenses are listed.
licenseslist
The licenses, in alphabetical order.
Example output
{
  "count": 2,
  "licenses": [
    {
      "id": 12,
      "list_count": 7,
      "name": "CC BY-SA 3.0",
      "permits_commercial_use": true,
      "permits_modification": true,
      "url": "https://creativecommons.org/licenses/by-sa/3.0/"
    },
    {
      "id": 8,
      "list_count": 6,
      "name": "CC BY-SA 4.0",
      "permits_commercial_use": true,
      "permits_modification": true,
      "url": "https://creativecommons.org/licenses/by-sa/4.0/"
    }
  ]
}

List maintainers

List the people, groups and companies that maintain filter lists, with their home pages, email addresses and X handles where FilterLists has them and how many lists each maintains, optionally only those whose name holds some words. No API key required.

Inputs

Namenametext
Only maintainers whose name holds every one of these words, ignoring case and accents (for example, easylist finds The EasyList Authors). Leave empty for all of them.

Outputs

countnumber
How many maintainers are listed.
maintainerslist
The maintainers, in alphabetical order.
Example output
{
  "count": 1,
  "maintainers": [
    {
      "email_address": null,
      "id": 7,
      "list_count": 9,
      "name": "The EasyList Authors",
      "twitter_handle": null,
      "url": "https://easylist.to/"
    }
  ]
}

List software

List the ad blockers, DNS blockers, firewalls and other programs that use filter lists, such as uBlock Origin, AdGuard Home and Pi-hole, each with its home and download pages, the syntaxes it reads and how many lists it can use, optionally only those whose name holds some words. No API key required.

Inputs

Namenametext
Only programs whose name holds every one of these words, ignoring case and accents (for example, adguard finds the four AdGuard programs). Leave empty for all of them.

Outputs

countnumber
How many programs are listed.
softwarelist
The programs, in alphabetical order.
Example output
{
  "count": 1,
  "software": [
    {
      "description": null,
      "download_url": "https://github.com/AdguardTeam/AdGuardHome/releases",
      "home_url": "https://github.com/AdguardTeam/AdGuardHome",
      "id": 31,
      "list_count": 51,
      "name": "AdGuard Home",
      "supports_abp_links": false,
      "syntaxes": [
        {
          "id": 1,
          "name": "Hosts (localhost IPv4)"
        },
        {
          "id": 2,
          "name": "Domains"
        },
        {
          "id": 9,
          "name": "IPs (IPv4)"
        },
        {
          "id": 14,
          "name": "Non-localhost hosts (IPv4)"
        },
        {
          "id": 16,
          "name": "Domains with wildcards"
        },
        {
          "id": 22,
          "name": "DNS servers"
        },
        {
          "id": 28,
          "name": "Adblocker-syntax domains"
        },
        {
          "id": 34,
          "name": "CIDRs (IPv4)"
        },
        {
          "id": 36,
          "name": "Hosts (localhost IPv6)"
        },
        {
          "id": 47,
          "name": "Adblocker-syntax domains w/o ABP tag"
        }
      ]
    }
  ]
}

List syntaxes

List the syntaxes filter lists are written in, such as Adblock Plus, Domains and hosts files, each with how many lists use it and the programs that read it, optionally only those whose name holds some words. No API key required.

Inputs

Namenametext
Only syntaxes whose name holds every one of these words, ignoring case and accents (for example, hosts finds every kind of hosts file). Leave empty for all of them.

Outputs

countnumber
How many syntaxes are listed.
syntaxeslist
The syntaxes, in alphabetical order.
Example output
{
  "count": 3,
  "syntaxes": [
    {
      "description": null,
      "id": 1,
      "list_count": 23,
      "name": "Hosts (localhost IPv4)",
      "software": [
        {
          "id": 1,
          "name": "uBlock Origin"
        },
        {
          "id": 4,
          "name": "DNS66"
        },
        {
          "id": 7,
          "name": "AdAway"
        },
        {
          "id": 11,
          "name": "Hosts File Editor"
        },
        {
          "id": 12,
          "name": "Gas Mask"
        },
        {
          "id": 14,
          "name": "Pi-hole"
        },
        {
          "id": 22,
          "name": "Diversion"
        },
        {
          "id": 25,
          "name": "uMatrix"
        },
        {
          "id": 26,
          "name": "Blokada"
        },
        {
          "id": 28,
          "name": "personalDNSfilter"
        },
        {
          "id": 31,
          "name": "AdGuard Home"
        },
        {
          "id": 32,
          "name": "AdNauseam"
        },
        {
          "id": 39,
          "name": "pfBlockerNG"
        },
        {
          "id": 45,
          "name": "AdGuard for Android"
        },
        {
          "id": 46,
          "name": "Vivaldi's Privacy settings"
        }
      ],
      "url": "https://en.wikipedia.org/wiki/Hosts_(file)"
    },
    {
      "description": null,
      "id": 36,
      "list_count": 1,
      "name": "Hosts (localhost IPv6)",
      "software": [
        {
          "id": 1,
          "name": "uBlock Origin"
        },
        {
          "id": 7,
          "name": "AdAway"
        },
        {
          "id": 11,
          "name": "Hosts File Editor"
        },
        {
          "id": 12,
          "name": "Gas Mask"
        },
        {
          "id": 14,
          "name": "Pi-hole"
        },
        {
          "id": 22,
          "name": "Diversion"
        },
        {
          "id": 31,
          "name": "AdGuard Home"
        },
        {
          "id": 45,
          "name": "AdGuard for Android"
        }
      ],
      "url": "https://en.wikipedia.org/wiki/Hosts_(file)"
    },
    {
      "description": null,
      "id": 14,
      "list_count": 1,
      "name": "Non-localhost hosts (IPv4)",
      "software": [
        {
          "id": 7,
          "name": "AdAway"
        },
        {
          "id": 11,
          "name": "Hosts File Editor"
        },
        {
          "id": 12,
          "name": "Gas Mask"
        },
        {
          "id": 14,
          "name": "Pi-hole"
        },
        {
          "id": 31,
          "name": "AdGuard Home"
        },
        {
          "id": 45,
          "name": "AdGuard for Android"
        }
      ],
      "url": "https://en.wikipedia.org/wiki/Hosts_(file)"
    }
  ]
}

List tags

List the tags FilterLists sorts lists by, such as ads, privacy, malware, phishing, cookies and annoyances, each with what it means and how many lists have it, optionally only those whose name holds some words. No API key required.

Inputs

Namenametext
Only tags whose name holds every one of these words, ignoring case and accents (for example, anti finds anti-adblock and anti-corp). Leave empty for all of them.

Outputs

countnumber
How many tags are listed.
tagslist
The tags, in alphabetical order.
Example output
{
  "count": 2,
  "tags": [
    {
      "description": "Blocks adblock detection scripts",
      "id": 5,
      "list_count": 2,
      "name": "anti-adblock"
    },
    {
      "description": "Blocks resources from certain companies",
      "id": 19,
      "list_count": 2,
      "name": "anti-corp"
    }
  ]
}

Search filter lists

Search the more than 2,000 filter and host lists in the FilterLists directory by words in their name or description, tag (such as ads, privacy or malware), language, syntax, the software that can use them (such as uBlock Origin or Pi-hole), license or maintainer, a page at a time with the real total. Newest first, with Added after list ID, finds the lists added since a workflow last looked. No API key required.

Inputs

Queryquerytext
Only lists with every one of these words somewhere in their name or description, ignoring case and accents, such as easylist, cookie or japanese ads. Leave it empty to search by the other filters alone.
Tagtagtext
Only lists with this tag, such as ads, privacy, malware, phishing, cookies or annoyances. Pick it from the list, which is read from FilterLists itself, or type its name or id.
Languagelanguagetext
Only lists made for sites in this language, by name, two letter code (en, de, ja) or id. Most lists name no language, as they work on sites in any, and those are left out when this is set.
Syntaxsyntaxtext
Only lists written in this syntax, such as Adblock Plus, Domains or Hosts (localhost IPv4). Pick it from the list or type its name or id.
Softwaresoftwaretext
Only lists this program can use, such as uBlock Origin, Pi-hole or AdGuard Home: those written in at least one syntax it reads, as the FilterLists site works it out. Pick it from the list or type its name or id.
Licenselicensetext
Only lists released under this license, such as The MIT License or GPLv3. A list whose license is not known is recorded as All Rights Reserved.
Maintainermaintainertext
Only lists this person, group or company maintains, such as The EasyList Authors, HaGeZi or Steven Black.
Commercial use allowedcommercial_usetrue/false
Only lists whose license, as FilterLists records it, allows commercial use. Read the license itself before relying on it.Default: false.
Added after list IDadded_after_idnumber
Only lists added to FilterLists after the list with this id. Ids only grow, so a workflow that runs on a schedule can save the latest list id a search returns and pass it here next time, to hear only about lists added since.At least 0.
Sortsorttext
How to order the lists found. Best match, the default, puts a list named exactly as the query first, then lists whose name starts with it, then those whose name holds every word, then those found by their description, each group A to Z; with no query it is A to Z. Name (A to Z) ignores the query, and Newest first puts the most recently added list first.One of: best_match (Best match), name (Name (A to Z)), newest (Newest first). Default: best_match.
Pagepagenumber
Which page of results to return, starting at 1. Leave empty for the first page. A page past the last one returns no lists, but still gives the real total.At least 1.
Page sizepage_sizenumber
How many lists a page holds, from 1 to 100. Defaults to 20.From 1 to 100. Default: 20.

Outputs

latest_list_idnumber
The id of the list added to FilterLists most recently, whatever the filters. Save it and pass it as Added after list ID next time to find only lists added since.
listslist
This page of the lists found. Empty when nothing matches or the page is past the last one.
pagenumber
The page this is, from 1.
page_sizenumber
How many lists a page holds.
pagesnumber
How many pages the matches fill; 0 when none match.
totalnumber
How many lists match, across every page.
Example output
{
  "latest_list_id": 2866,
  "lists": [
    {
      "description": "EasyList is the primary filter list that removes most adverts from international web pages, including unwanted frames, images, and objects. It is the most popular list used by many ad blockers and forms the basis of over a dozen combination and supplementary filter lists.",
      "id": 301,
      "languages": [
        {
          "code": "cy",
          "id": 30,
          "name": "Welsh"
        },
        {
          "code": "en",
          "id": 37,
          "name": "English"
        }
      ],
      "license": {
        "id": 4,
        "name": "GPLv3",
        "permits_commercial_use": true,
        "permits_modification": true,
        "url": "https://www.gnu.org/licenses/gpl-3.0.en.html"
      },
      "maintainers": [
        {
          "email_address": null,
          "id": 7,
          "name": "The EasyList Authors",
          "twitter_handle": null,
          "url": "https://easylist.to/"
        }
      ],
      "name": "EasyList",
      "page_url": "https://filterlists.com/lists/easylist",
      "software": [
        {
          "id": 1,
          "name": "uBlock Origin"
        },
        {
          "id": 2,
          "name": "Adblock Plus"
        },
        {
          "id": 3,
          "name": "AdGuard (free versions)"
        },
        {
          "id": 6,
          "name": "AdBlock"
        },
        {
          "id": 32,
          "name": "AdNauseam"
        },
        {
          "id": 39,
          "name": "pfBlockerNG"
        },
        {
          "id": 40,
          "name": "Opera's built-in adblocker"
        },
        {
          "id": 44,
          "name": "AdGuard for Windows/macOS"
        },
        {
          "id": 45,
          "name": "AdGuard for Android"
        },
        {
          "id": 46,
          "name": "Vivaldi's Privacy settings"
        }
      ],
      "syntaxes": [
        {
          "id": 3,
          "name": "Adblock Plus"
        }
      ],
      "tags": [
        {
          "description": "Blocks advertisements",
          "id": 2,
          "name": "ads"
        }
      ]
    },
    {
      "description": "EasyList Germany is a filter list written by the EasyList authors MonztA, Famlam, and Khrin that specifically removes adverts on German language websites.",
      "id": 293,
      "languages": [
        {
          "code": "de",
          "id": 32,
          "name": "German"
        }
      ],
      "license": {
        "id": 4,
        "name": "GPLv3",
        "permits_commercial_use": true,
        "permits_modification": true,
        "url": "https://www.gnu.org/licenses/gpl-3.0.en.html"
      },
      "maintainers": [
        {
          "email_address": null,
          "id": 7,
          "name": "The EasyList Authors",
          "twitter_handle": null,
          "url": "https://easylist.to/"
        }
      ],
      "name": "EasyList Germany",
      "page_url": "https://filterlists.com/lists/easylist-germany",
      "software": [
        {
          "id": 1,
          "name": "uBlock Origin"
        },
        {
          "id": 2,
          "name": "Adblock Plus"
        },
        {
          "id": 3,
          "name": "AdGuard (free versions)"
        },
        {
          "id": 6,
          "name": "AdBlock"
        },
        {
          "id": 32,
          "name": "AdNauseam"
        },
        {
          "id": 39,
          "name": "pfBlockerNG"
        },
        {
          "id": 40,
          "name": "Opera's built-in adblocker"
        },
        {
          "id": 44,
          "name": "AdGuard for Windows/macOS"
        },
        {
          "id": 45,
          "name": "AdGuard for Android"
        },
        {
          "id": 46,
          "name": "Vivaldi's Privacy settings"
        }
      ],
      "syntaxes": [
        {
          "id": 3,
          "name": "Adblock Plus"
        }
      ],
      "tags": [
        {
          "description": "Blocks advertisements",
          "id": 2,
          "name": "ads"
        }
      ]
    }
  ],
  "page": 1,
  "page_size": 2,
  "pages": 6,
  "total": 12
}

Fillout

Previous Page

Final Space API

Next Page

On this page

ActionsGet a filter listList languagesList licensesList maintainersList softwareList syntaxesList tagsSearch filter lists