Get Started

Good to know: We ratelimit requests to our API, and they are limited to 10 requests a second. If you need this increasing, please join our support server. Link: https://discord.gg/FZxgNrwBS6​
Get your API key
Your API requests are authenticated using API keys. Any request that doesn't include an API key will return an error.
You can generate an API key from our Dashboard (SOON!) or by doing /apikey
Make your first request
get
https://api.blacklister.xyz
/<userid>
Check a user's blacklisted status
Take a look at how you might call this method using Axios or Requests
JavaScript
Python
C#
const axios = require("axios")
​
await axios.get(`https://api.blacklister.xyz/USERID`, { 
            "headers": { "Authorization":"API key" }
})
.then(async function (response) {
            if (response.data.blacklisted) {
              // User is blacklisted!
            }
            else {
              // User is not blacklisted!
            }
})
import requests
​
r = requests.get("https://api.blacklister.xyz/USERID", headers={ "Authorization":"Your API key"})
​
response = r.json()
​
if response["blacklisted"]:
    # User is blacklisted!
else:
    # User is not blacklisted!
using System;
using System.Net.Http;
using System.Text.Json;
using System.Text.Json.Serialization;
using System.Threading.Tasks;
​
namespace BigBun
{
    public class Blacklist
    {
        [JsonPropertyName("blacklisted")]
        public bool Blacklisted { get; set; }
​
        [JsonPropertyName("reason")]
        public string Reason { get; set; }
​
        [JsonPropertyName("moderator")]
        public string Moderator { get; set; }
​
        [JsonPropertyName("date")]
        public string Date { get; set; }
​
        [JsonPropertyName("evidence")]
        public string Evidence { get; set; }
​
        [JsonPropertyName("source")]
        public string Source { get; set; }
    }
​
    public static class Program
    {
        public static async Task Main()
        {
            string apiKey = "";
            ulong userId = 710912646433603615;
​
            HttpClient client = new();
​
            HttpRequestMessage request = new(HttpMethod.Get, $"https://api.blacklister.xyz/{userId}");
            request.Headers.Add("Authorization", apiKey);
            HttpResponseMessage response = await client.SendAsync(request);
​
            string json = await response.Content.ReadAsStringAsync();
            Blacklist data = JsonSerializer.Deserialize<Blacklist>(json);
​
            if (data.Blacklisted)
            {
                Console.WriteLine("User is blacklisted!");
                Console.WriteLine($"Reason: {data.Reason}");
                Console.WriteLine($"Moderator: {data.Moderator}");
                Console.WriteLine($"Date: {data.Date}");
                Console.WriteLine($"Evidence: {data.Evidence}");
                Console.WriteLine($"Source: {data.Source}");
            }
            else
            {
                Console.WriteLine("User isn't blacklisted!");
            }
​
            Console.ReadKey();
        }
    }
}
Welcome!
Last modified 6mo ago