![image.png](https://cdn.steemitimages.com/DQmeKmc86Q3fcPFoaA7vF5ozadtGeFyAAa7DbzQ67WGfT6M/image.png)

**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 **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 offer 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**
* **SmartSteem** [REMOVED]
* **D-Tube**
* **Plenty of Phish**
* **Irredeemables**
* **Spaminator**
* **3Speak** [NEW]
* **All Steem Engine Tribes**

# Recent changes

3Speak's blacklist has been integrated into the Global Blacklist API as "`threespeak`".

SmartSteem has been removed from the Global Blacklist API at the request of SmartSteem.

Steemit.com now uses the Global Blacklist API.

# 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)

# 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.

The Chrome extension is becoming less important part of the Global Blacklist API as front ends integrate to the API directly.

# 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]

# 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)