Role members

1. Home
2. Role members /

---

Get all users with a role

Get all users with a specific role

GET /api/discord/get-role-members

https://api.cookie-api.com/api/discord/get-role-members

Authentication Learn how to get your API Key and use it in your requests!

Body

{
    "bot_token": "Your Bot's Token"
}

URL Parameters
guild_id	Guild ID
role_id	Discord Role ID

Note

Learn more about why Cookie API needs your Bot’s Token here.

cURL

curl --location 'https://api.cookie-api.com/api/discord/get-role-members?guild_id=1194719044096491642&role_id=1251872586804232276' \
--header 'Authorization: API_Key' \
--header 'bot-token: Bot_Token'

Python

import requests

url = 'https://api.cookie-api.com/api/discord/get-role-members'
headers = {
    'Authorization': 'API_Key',
    'bot-token': 'Bot_Token'
}

params = {
    'guild_id': '1194719044096491642',
    'role_id': '1251872586804232276'
}

response = requests.get(url, headers=headers, params=params)
print(response.json())

JavaScript

const fetch = require('node-fetch');

const url = 'https://api.cookie-api.com/api/discord/get-role-members';
const headers = {
    'Authorization': 'API_Key',
    'bot-token': 'Bot_Token'
};

const params = new URLSearchParams({
    guild_id: '1194719044096491642',
    role_id: '1251872586804232276'
});

fetch(`${url}?${params}`, {
    method: 'GET',
    headers: headers
})
.then(res => res.json())
.then(data => console.log(data))
.catch(err => console.error(err));

Go

package main

import (
    "fmt"
    "log"
    "net/http"
    "net/url"
    "io/ioutil"
)

func main() {
    baseUrl := "https://api.cookie-api.com/api/discord/get-role-members"
    guildID := "1194719044096491642"
    roleID := "1251872586804232276"
    apiKey := "API_Key"
    botToken := "Bot_Token"

    reqUrl := fmt.Sprintf("%s?guild_id=%s&role_id=%s", baseUrl, guildID, roleID)

    req, err := http.NewRequest("GET", reqUrl, nil)
    if err != nil {
        log.Fatal(err)
    }

    req.Header.Set("Authorization", apiKey)
    req.Header.Set("bot-token", botToken)

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        log.Fatal(err)
    }
    defer resp.Body.Close()

    body, _ := ioutil.ReadAll(resp.Body)
    fmt.Println(string(body))
}

Node.js

const https = require('https');

const options = {
    hostname: 'api.cookie-api.com',
    path: '/api/discord/get-role-members?guild_id=1194719044096491642&role_id=1251872586804232276',
    method: 'GET',
    headers: {
        'Authorization': 'API_Key',
        'bot-token': 'Bot_Token'
    }
};

const req = https.request(options, res => {
    let data = '';

    res.on('data', chunk => {
        data += chunk;
    });

    res.on('end', () => {
        console.log(JSON.parse(data));
    });
});

req.on('error', error => {
    console.error(error);
});

req.end();

Ruby

require 'net/http'
require 'uri'
require 'json'

uri = URI.parse('https://api.cookie-api.com/api/discord/get-role-members')

headers = {
  'Authorization' => 'API_Key',
  'bot-token' => 'Bot_Token'
}

uri.query = URI.encode_www_form({
  'guild_id' => '1194719044096491642',
  'role_id' => '1251872586804232276'
})

request = Net::HTTP::Get.new(uri, headers)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts response.body

Rust

use reqwest::blocking::Client;
use reqwest::header::HeaderMap;
use serde_json::json;

fn main() {
    let url = "https://api.cookie-api.com/api/discord/get-role-members";

    let params = [
        ("guild_id", "1194719044096491642"),
        ("role_id", "1251872586804232276")
    ];

    let client = Client::new();
    let mut headers = HeaderMap::new();
    headers.insert("Authorization", "API_Key".parse().unwrap());
    headers.insert("bot-token", "Bot_Token".parse().unwrap());

    let res = client
        .get(url)
        .query(&params)
        .headers(headers)
        .send()
        .unwrap();

    println!("{}", res.text().unwrap());
}

Responses

200

{
    "members": [
        "the_cookie123",
        "redxxxkiller"
    ],
    "members_count": 2,
    "user_ids": [
        "1025427725021872158",
        "820655401518235669"
    ],
    "user_info": {
        "1025427725021872158": {
            "display_name": "The_Cookie",
            "joined_at": "2024-01-10T19:06:57.033000+00:00",
            "status": "offline",
            "user_id": 1025427725021872158,
            "username": "the_cookie123"
        },
        "820655401518235669": {
            "display_name": "Cookie Red",
            "joined_at": "2024-04-09T17:08:40.316000+00:00",
            "status": "offline",
            "user_id": 820655401518235669,
            "username": "redxxxkiller"
        }
    }
}