What is the Global Blacklist API?
The Global Blacklist API is a service provided by witness @themarkymark. The API enables products and services to query multiple blacklists to reduce spam and abuse.
The API is free to use and is in use by many large projects on Steem like SteemHunt & SteemPress.
Global Blacklist API 2.0 was released a few days ago with major performance improvements and additional endpoints.
Actifit Blacklist now available
All three endpoints now support dynamically reporting Actifit blacklisted users. You can check an individual user using the /user
call, or the Actifit list specifically using /blacklist/actifit
, or just pull all lists from the /blacklists
call.
Dynamic Blacklists Supported
- BuildAWhale
- SteemCleaners
- Utopian-IO
- Redeemer
- MinnowBooster
- Actifit (New)
The Global Blacklist API is a dynamic real-time API. There can be up to a 30-minute delay before our API exposes changes to one of the above blacklists.
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/lpsapkota
Sample Response:
{"user":"lpsapkota","blacklisted":["buildawhale","actifit"]}
/blacklist/{blacklist}/
Method: GET
Description: Query for Specific Blacklist
Example: http://blacklist.usesteem.com/blacklist/actifit
Sample Response:
[Full actifit 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]
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.
Future Improvements: Whitelisting
I will be releasing a whitelist version of this API to expose whitelists across multiple projects on the Steem blockchain. If you maintain a whitelist for your project or service, please contact me so we can discuss making your whitelist available.
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.
Licensing
The Global Blacklist API is completely free to use for any Steem project. No fees will be charged for its use.
Contribution
If you maintain a blacklist, please contact me on Steem.chat or Discord to be added. There are no fees to be listed.