Clash of Clans API for clan leaders/managers

This is a huge ask, and there may be a lot that's impractical about it, but I thought I'd bring it up in case it catches on. It would be great to have a web-based API for CoC where a clan leader can automatically query clan members and their statistics/role. Our clan has a website and membership on the website has to be maintained independently of the game, so someone always has to be watching for people leaving the clan so that their account can be blocked on the website. When someone gets promoted to elder in game, it would be nice to be able to automatically give them elder status on the website, etc.. It would also make it easier to run in-clan contests if we could devise a program to query the (for example) troop donation counts for each member, their trophies lost and won, etc...

Anyone at Supercell feel like taking on this monumental task? :o

Yeah, i agree and our forum accounts can be linked to our gaming account.

I'll echo this API request.


Our adult-only Clan, "The ever living", has a strong culture of mutuality, i.e. heavy donation rates.
We also feel strongly about loyalty, so operate on the presumptive basis that All Bootings Are Forever.


Naturally, when we take the Ultimate Sanction of booting someone for being "too much of a Taker, and not enough of a Giver", our Leader & Elders want to be as sure as reasonably possible that the case against the member is supported by objective data. Since the weekly donation tracking was added a couple Updates ago, this is much easier to assess than it was, which we do appreciate!


However, we still must manually capture the weekly donation counts just prior to Reset, via the somewhat tedious method of taking screenshots - at the last possible moment before Reset - manually; then transcribing the donation data manually into a spreadsheet; then finding a (necessarily out-of-band) way to make the breakdown visible to at least the Leader & Elders, if not the entire Member list.


Aside from the obvious improvement in convenience & accuracy of replacing that method with either a pull or push API call, this behavioral data is incomplete, so does not help us with another key part of the ongoing "parasite detection and pruning" analysis as much as we'd like: tracking Members' Requests to Donations ratio.


It would sure be nice to be able to a) see the Requests Fulfilled//Troops Received values (in whichever units Supercell might prefer: actual Unit lists; simple Request counts; Castle spaces filled, etc), and b) be able to get that info directly either as a Push to the Clan Leader [via Notifications, email, API dequeueing, whatever], or pulled via explicit polling API.


An API will enable a brand-enhancing ecosystem of value-added CoC tools to be developed by third parties. These will add further stickiness and positive UX value without having to be built or maintained by the Supercell dev team, preserving their vital mission focus.


I firmly believe it would be perfectly reasonable for Supercell to change the API as frequently as they wish, leaving third-party devs to either do the work to adapt as necessary, or accept that their tools will quickly be obsoleted - given the admirable rate of significant, rapid enhancement for the player experience which has already been established via Update for the game itself.


Would love to discuss this further with any other interested parties.


Adrian

Italian programmer ask for API too!
I'm coding a troops manager to evaluate best price/damage set of troops.
We need API :P

I registered just to respond with my support. I don't know this forum well enough to know if employees at SuperCell monitor this at all but exposing an API, focused on Clan management, would be a huge boost to the platform.

I'm looking to use it as a better source for clan discovery. Trying to find a clan of mature adults who actually donate troops regularly is VERY difficult with the current game UI. Even a simple API would make it easier for 3rd party developers to create tools that improve the game's experience.

Right now, we can only search by name. That's nuts. It would be nice to be able to query clans by:
- keywords in clan description
- average experience level
- average trophies
- current average troops donated
- activity level (total donations/requests/conversations)

I could personally write this API in a day or two. If supercell just exposed some basic functionality, people could build on top of it and create awesomeness.

Very nice idea. An CoC api can be used in lots of ways, not only for clan leaders. ;)

Quote:

---

Originally Posted by adrianrf

Naturally, when we take the Ultimate Sanction of booting someone for being "too much of a Taker, and not enough of a Giver", our Leader & Elders want to be as sure as reasonably possible that the case against the member is supported by objective data. Since the weekly donation tracking was added a couple Updates ago, this is much easier to assess than it was, which we do appreciate!

---

You are aware if everyone gave and no one asked for troops for their castle . . well no one could give as you need to give to someone who asks. So that's a flawed system you have . . . but your clan not mine. Feel free to do it however you want.

About the API. Big task to do this but I think it's a good idea.

Somehow linking your game account to this forum would be pretty cool. I'm a clan leader, and I won't use this feature. I'm active enough in my clan to not really need it. You code crunchers might have a different clan management system than me so I'm not hating on it. I'm just not sure it will be heavily used by the masses.

This would be extremely helpful, as the only alternative for capturing data has us taking photo snapshots and hand-jamming the data into whatever db you have. It is time-consuming, error-prone, and depends entirely on remembering to take the snapshots at the right time.

There are quite a few clans with websites, and I for one would welcome this addition. There might even be dancing. :)

Yeah! Just a CSV or XML of the clan member list with membername, trophies, rank, donations and lvl would be amazing.

This is already publicly available data in CoC so no authentication would be required either.

A simple query to the DB that CoC runs on should be enough so implementation should take only in a timeframe of hours.

The only thing that would require work is documentation on this functionality.