{"id":13659633,"url":"https://github.com/martincarrera/clash-royale-api","last_synced_at":"2025-09-29T10:31:01.627Z","repository":{"id":43833704,"uuid":"58175508","full_name":"martincarrera/clash-royale-api","owner":"martincarrera","description":":crown: Clash Royale API that provides information about the game.","archived":true,"fork":false,"pushed_at":"2018-08-16T13:25:06.000Z","size":63893,"stargazers_count":353,"open_issues_count":14,"forks_count":83,"subscribers_count":36,"default_branch":"master","last_synced_at":"2024-09-27T09:01:21.538Z","etag":null,"topics":["api","clash","clash-royale","clash-royale-api","game","royale","supercell","unofficial"],"latest_commit_sha":null,"homepage":"http://www.clashapi.xyz/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/martincarrera.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-05-06T02:40:37.000Z","updated_at":"2024-09-13T13:14:05.000Z","dependencies_parsed_at":"2022-08-19T14:42:17.495Z","dependency_job_id":null,"html_url":"https://github.com/martincarrera/clash-royale-api","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/martincarrera%2Fclash-royale-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/martincarrera%2Fclash-royale-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/martincarrera%2Fclash-royale-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/martincarrera%2Fclash-royale-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/martincarrera","download_url":"https://codeload.github.com/martincarrera/clash-royale-api/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234609323,"owners_count":18859849,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","clash","clash-royale","clash-royale-api","game","royale","supercell","unofficial"],"created_at":"2024-08-02T05:01:10.748Z","updated_at":"2025-09-29T10:30:55.095Z","avatar_url":"https://github.com/martincarrera.png","language":"JavaScript","funding_links":["https://www.paypal.me/MartinCarrera","https://www.paypal.me/MartinCarrera)!"],"categories":["Public APIs","JavaScript","APIs"],"sub_categories":["Videogames"],"readme":"# [Clash Royale API](http://www.clashapi.xyz/)\n\n[![Codeship Status for martincarrera/clash-royale-api](https://codeship.com/projects/4f412dd0-0006-0134-4d8c-1e95689fe79f/status?branch=master)](https://codeship.com/projects/153028) [![Coverage Status](https://coveralls.io/repos/github/martincarrera/clash-royale-api/badge.svg?branch=master)](https://coveralls.io/github/martincarrera/clash-royale-api?branch=master)\n[![donate paypal](https://img.shields.io/badge/donate-paypal-blue.svg)](https://www.paypal.me/MartinCarrera)\n\nA [Clash Royale](http://supercell.com/en/games/clashroyale/) API that provides information about the game.\n\n\u003e If you develop an app using this API, please submit a pull request adding it to the [apps table](#apps-that-use-this-api).\n\n## Content\n\n1. [How to use](#how-to-use)\n    1. [Endpoints](#endpoints)\n    2. [Images](#images)\n2. [Want to help](#want-to-help)\n3. [Development](#development)\n    1. [Install](#install)\n    2. [Run](#run)\n    3. [Test](#test)\n4. [Apps that use this API](#apps-that-use-this-api)\n\n## How to use\n\nConsume the API to get all the information you need from these routes.\n\n### Endpoints\n\n[Base route](http://www.clashapi.xyz).\n\n| Route | HTTP Verb | Description |\n|---|---|---|\n| [`/api/arenas`][1] | `GET` | All Arenas information |\n| `/api/arenas/:id` | `GET` | Single Arena information |\n| `/api/arenas/:idName` | `GET` | Single Arena information |\n| [`/api/cards`][2] | `GET` | All Cards information |\n| `/api/cards/:id` | `GET` | Single Card information |\n| `/api/cards/:idName` | `GET` | Single Card information |\n| [`/api/chests`][3] | `GET` | All Chests information |\n| `/api/chests/:id` | `GET` | Single Chest information |\n| `/api/chests/:idName` | `GET` | Single Chest information |\n| [`/api/leagues`][4] | `GET` | All Leagues information |\n| `/api/leagues/:id` | `GET` | Single League information |\n| `/api/leagues/:idName` | `GET` | Single League information |\n| [`/api/players`][5] | `GET` | All Players levels information |\n| `/api/players/:id` | `GET` | Player level information |\n| `/api/players/:idName` | `GET` | Player level information |\n| [`/api/random-deck`][6] | `GET` | Get a Random deck! |\n\n[1]: http://www.clashapi.xyz/api/arenas\n[2]: http://www.clashapi.xyz/api/cards\n[3]: http://www.clashapi.xyz/api/chests\n[4]: http://www.clashapi.xyz/api/leagues\n[5]: http://www.clashapi.xyz/api/players\n[6]: http://www.clashapi.xyz/api/random-deck\n\n### Images\n\nYou can get the images too! Thank you [MaherFa](https://github.com/MaherFa)!\n\n| Route | Description |\n|---|---|\n| [`/images/arenas/${idName}.png`][7] | Arenas images |\n| [`/images/cards/${idName}.png`][8] | Cards images |\n| [`/images/chests/${idName}.png`][9] | Chests images |\n| [`/images/leagues/${idName}.png`][10] | Leagues images |\n\n[7]: http://www.clashapi.xyz/images/arenas/royal-arena.png\n[8]: http://www.clashapi.xyz/images/cards/arrows.png\n[9]: http://www.clashapi.xyz/images/chests/super-magical-chest.png\n[10]: http://www.clashapi.xyz/images/leagues/ultimate-champion.png\n\n## Want to help\n\nIf you like the API, please star this repository.\n\nIf you create an app using the API, please mention this repository and add it in the table below.\n\nIf you want to contribute to the API, feel free to create a pull request.\n\nIf you :heart: the API, [help me pay the hosting](https://www.paypal.me/MartinCarrera)!\n\n## Development\n\nMake sure you have installed all these prerequisites on your development machine.\n\n* [Node.js](https://nodejs.org/en/download/)\n* [MongoDB](https://www.mongodb.org/)\n* [Nodemon](https://nodemon.io/)\n\n### Install\n\n```bash\n\u003e git clone https://github.com/martincarrera/clash-royale-api.git\n\u003e cd clash-royale-api\n\u003e npm install\n```\n\n### Run\n\n```bash\n\u003e mongod\n\u003e cd clash-royale-api\n\u003e npm run dev\n```\n\nIf you don't have `Nodemon` installed\n\n```bash\n\u003e mongod\n\u003e cd clash-royale-api\n\u003e npm i -g nodemon\n\u003e npm run dev\n```\n\n### Test\n\n```bash\n\u003e npm test\n```\n\n## Apps that use this API\n\n| APP | DESCRIPTION | LINK |\n|:---:|:---:|:---:|\n| Randeck | Simple web app that generates random decks. | [Go!](http://randeck.xyz) |\n| Royale Plus | Facebook for Clash Royale players. | [Git!](https://github.com/AmirSavand/royale-plus) [Go!](http://royplus.herokuapp.com/)|\n| BarrePolice | A Telegram Bot based on plugins written in Lua |[Go!](https://t.me/BarrePolice_Bot) _\u0026 send /cr_ |\n| Clashapi | NPM package to consume this API | [Go!](https://www.npmjs.com/package/clashapi) |\n| Deck it | Deck builder app designed for Android | [Go!](https://play.google.com/store/apps/details?id=com.oryginal.deckit) |\n| Deck Generator for Echo Devices | Alexa skill to suggest a deck for clash royale for Amazon's Echo devices | [Go!](https://alexa.amazon.in/spa/index.html#skills/dp/B078WSRZWV/?ref=skill_dsk_skb_ca_24) |\n| Clash Royale Discord Bot | A Discord bot that displays informations depending of commands | [Go!](https://github.com/TorzuoliH/clash-royale-discord-bot) |\n| Deck Royale | A SPA using Vue that generates random decks. | [Git!](https://github.com/ikenami/Deck-Royale) [Go!](http://deck-royale-ultimate.herokuapp.com/) |\n| ClashElite | Simple app that gives info on chest cycles and generates random decks with copy and share feature. | [Go!](https://play.google.com/store/apps/details?id=com.wordpress.redmanandroid.clashelite) |\n\nMade with :heart: by clash fans.\n\n----------\nThis 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](http://www.supercell.com/fan-content-policy).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmartincarrera%2Fclash-royale-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmartincarrera%2Fclash-royale-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmartincarrera%2Fclash-royale-api/lists"}