![ApplicationFrameHost_2018-08-16_10-54-18.png](https://ipfs.busy.org/ipfs/QmabqiuLdnWrZst649Q5wpBjZSoaeUUuFReVi6Cznqc7hs)

The Global Blacklist API is a personal project I work on to provide a consumable API interface to my blacklist as well as other blacklist projects.

Projects can choose which blacklists they want to use and are not limited to just my blacklist. For example SteemCleaner's real-time list available as well.

[Global Blacklist API 2.0](https://steemit.com/utopian-io/@themarkymark/global-blacklist-api-2-0-released) added major performance changes as I received better endpoints for the blacklists I support.

This update adds **dynamic** support Tribes and renames Oracle-D to Yoodoo.

# Dynamic Blacklists Supported
* BuildAWhale
* SteemCleaners
* Redeemer
* MinnowBooster
* Actifit
* Yoodoo
* Smartsteem 
* D-Tube
* All Tribes (**New**)

The Global Blacklist API is a dynamic real-time API that exposes the above **8 blacklists** & **Tribes** via an easy to use interface. There may be up to a 30-minute delay before our API exposes changes to one of the above blacklists.  More blacklists for well-known projects are being integrated and will be announced when available.  

**Over 50% of Steem dApps use the Global Blacklist API in some form.**

# How to use Global Blacklist API

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

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

#### /blacklist/{blacklist}/
Method: GET
Description: Query for Specific Blacklist
Example: http://blacklist.usesteem.com/blacklist/dtube
Sample Response:
[Full D-Tube blacklist]

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

#### /tribe (**New**)
Method: GET
Description: Query for Tribe muted users
Example: http://blacklist.usesteem.com/tribe/pal
Sample Response:
[All users muted users on PalNet]


# 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://chrome.google.com/webstore/detail/steem-blacklist-notifier/mpdhebkniabfjiobchnbkbcbimafablb/related?hl=en) 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/rqA79IE.png

The Chrome extension supports the following Steem front ends:

* Steemit.com
* SteemPeak
* Steeve.app
* Pariko
* Busy.org
* Actifit
* PALNet
* SteemLEO
* StemGeeks
* Creative Coin
* WeedCash
* SplinterTalk

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

# Do you use the Global Blacklist API?

If you use the Global Blacklist API in your product or service, please reach out and let me know so I can gather a comprehensive list of projects supporting it.  Last time I checked over **50% of popular dApps** used the Global Blacklist API in some form.

# Licensing

The Global Blacklist API is completely free to use for any Steem project. No fees are charged for its use.

# Contribution

If you maintain a blacklist, please contact me on Steem.chat or Discord to be added.  I will develop support for your blacklist and list it without charge.