Skip to content
Blacklist using Akismet for Elixir
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Implementation for the API available in this site:

This uses Tesla library to make easier the access to the endpoint.

This is very useful to check if a message coming from a contact form is a ham or spam one.


If available in Hex, the package can be installed by adding blacklist to your list of dependencies in mix.exs:

def deps do
    {:blacklist, "~> 0.1"}

Documentation can be generated with ExDoc and published on HexDocs. Once published, the docs can be found at


Blacklist.check author, email, locale, user_agent, user_ip, content
# false

The information provided to check if the message is spam is as follow:

  • author: author name of the message.
  • email: email for the author of the message.
  • locale: language used for the message. It should be in ISO-639 (es, en, ...).
  • user_agent: the user agent of the browser used to send the message.
  • user_ip: the user IP where the message came from.
  • content: the content of the message.

The result of the function will be or a boolean indicating if it's spam or not, or an error in case something went wrong.

This depends on an external service and you should to configure the credentials to use it:

config :blacklist, api_key: "xxxxxxxxxxxx",
                   blog: "https://..."

The values are:

  • api_key: the API key provided by Akismet website.
  • blog: the URL of your website.

You can use also the configuration to use a custom blacklist. The configuration for the blacklist is as follow (you can merge both configurations to generate only one):

config :blacklist, name: [],
                   email: ["", "", ""]


You can’t perform that action at this time.