![image.png](https://ipfs.busy.org/ipfs/QmWvCfCU5MPhAVEp4838ojmUWVBfhV4w95R7o6MEkBCNmt)

**Please consider [supporting](https://beta.steemconnect.com/sign/update-proposal-votes?proposal_ids=[42]&approve=true) the Global Blacklist API proposal**.

# The Global Blacklist API

The Global Blacklist API is a project I started three days after I got access to the Steem Cleaners blacklist.  It has been running for almost two years and supports **ten (10) community blacklists** and all Steem Engine Tribes.

**The Global Blacklist API is used by over 50% of Steem dApps in one way or another.**

The Global Blacklist API has been a free service I have been providing for almost 2 years to provide a standard and easy to use interface to access multiple blacklists on the Steem blockchain.  dApps and services can choose to subscribe to one or more of the available blacklists and use them to minimize abuse.

Currently, the Global Blacklist API supports the following blacklists:

* **BuildAWhale**
* **SteemCleaners**
* **Redeemer**
* **MinnowBooster**
* **Actifit**
* **Yoodoo**
* **Smartsteem**
* **D-Tube**
* **Plenty of Phish**
* **Irredeemables**
* **All Steem Engine Tribes**

All of these unique blacklists can be accessed via a standard API interface.  

# BuildAWhale blacklist

The BuildAWhale blacklist is a blacklist I have maintained for almost 2 years by hand with over 45,000 entries.  The blacklist includes accounts that have been found spamming, plagiarizing, fraud, and scams.

# Steempeak integration

@steempeak recently integrated the Global Blacklist API into their front end.  You can read about the integration [here](https://steemit.com/steempeak/@steempeak/steempeak-v1-18-5-global-blacklist-api)

# How to use Global Blacklist API

#### Endpoint
https://blacklist.usesteem.com/

#### /user/{username}/
Method: GET
Description: Query user blacklist status
Example: https://blacklist.usesteem.com/user/scobra
Sample Response:
`{"user":"scobra","blacklisted":["steemcleaners","buildawhale","minnowbooster"]}`

#### /blacklist/{blacklist}/
Method: GET
Description: Query for Specific Blacklist
Example: https://blacklist.usesteem.com/blacklist/steemcleaners
Sample Response:
[Full steemcleaners blacklist]

#### /blacklists
Method: GET
Description: Query for All Unique Blacklisted Users
Example: https://blacklist.usesteem.com/blacklists
Sample Response:
[All users blacklisted across all blacklists]

# Choice

As a user of the Global Blacklist API, you can choose which blacklists you want to subscribe to. As other blacklists are added you only need to update your blacklist choices. I recommend using a configuration parameter that allows you to easily specify what lists you want to look for, or just check if the user is on any blacklist.

# Integration with Blacklist Notifier Chrome Extension

The [Blacklist Notifier Chrome Extension](https://steemit.com/utopian-io/@themarkymark/introducing-blacklist-notifier-chrome-extension) fully supports the Global Blacklist API and provides curators an easy way to know if a user is on a blacklist and which one.

https://i.imgur.com/3lhaC6k.png

The Blacklist Notifier is supported with Chrome & Brave browsers, Firefox support may come in the future.

# Support Global Blacklist API

I have a proposal on SPS to support the Global Blacklist API.  You can read about it [here](https://steemit.com/sps/@themarkymark/global-blacklist-api-proposal) and approve it [here](https://beta.steemconnect.com/sign/update-proposal-votes?proposal_ids=[42]&approve=true)

https://i.imgur.com/6rjAran.png

The Global Blacklist API Proposal has around **50% approval needed**.  Another 6.2M SP in votes is needed to approve the proposal.