apiroyale

apiroyale is a Node.js library to interact with the Clash Royale API.

Installation

You can install this package using a package manager like npm:

npm install apiroyale

Note: Node.js 16.9.0 or higher is required.

Description

This library helps you to interact with the Clash Royale API.

All fetched structures are cached for a short time to prevent unnecessary API calls. You can use cache and cacheNested options to disable caching and save memory.

Usage

To start interacting with the API, create a new client:

import ClientRoyale from "apiroyale";

const client = new ClientRoyale({ token: "<your-token>" });

// Request a clan by tag
client.clans.fetch("<clan-tag>").then((clan) => {
	console.log(clan.name);
});
// You can disable caching by passing `cache: false`
client.clans.fetch("<clan-tag>", { cache: false }).then((clan) => {
	console.log(clan.name);
});
// Note that you can also pass default cache/cacheNested options to the client constructor
const client = new ClientRoyale({
	token: "<your-token>",
	cache: false,
	cacheNested: false,
});

// Search for a clan by name
client.clans
	.search({ name: "clan name", limit: 10 })
	.then((clans) => {
		console.log(clans.items[0].name);
		// You can also use pagination
		return client.clans.search({
			name: "clan name",
			limit: 10,
			after: clans.paging.cursors.after,
		});
	})
	.then((clans) => {
		console.log(clans.items[0].name);
	});

You can also do a raw request without using the client:

import { Rest } from "apiroyale";

const rest = new Rest();

rest.get("/clans/<clan-tag>").then((response) => {
	console.log(response); // { maxAge: 1650906957599, data: { ... } }
});

This content is not affiliated with, endorsed, sponsored, or specifically approved by Supercell and Supercell is not responsible for it. For more information see Supercell’s Fan Content Policy.