<p>
<a href="https://github.com/tonybenoy/cocapi/actions">
<img src="https://github.com/tonybenoy/cocapi/workflows/mypy/badge.svg" alt="Test Status" height="20">
</a>
<a href="https://pypi.org/project/cocapi/"><img src="https://img.shields.io/pypi/v/cocapi" alt="Pypi version" height="21"></a>
</p>
<p>
<a href="https://www.python.org/downloads/"><img src="https://img.shields.io/badge/python-3.6+-blue.svg" alt="Python version" height="17"></a>
<a href="https://github.com/tonybenoy/cocapi/blob/master/LICENSE"><img src="https://img.shields.io/github/license/tonybenoy/cocapi" alt="License" height="17"></a>
<a href="https://github.com/psf/black">
<img src="https://img.shields.io/badge/code%20style-black-000000.svg" alt="Codestyle Black" height="17">
</a>
</p>
# ClashOfClansAPI
Python Wrapper for SuperCells Clash Of Clans API
Get Token from https://developer.clashofclans.com/
# Install
> pip install cocapi
# Features and usage examples
### Initialize
Required to set up the class. Versions post 6.1.0 also support getting the status code of the API call. This is useful for debugging. To use it pass `status_code=True` to the `CocApi`.
```python
from cocapi import CocApi
token = 'YOUR_API_TOKEN'
timeout=60 #requests timeout
api=CocApi(token,timeout)
```
## Clans
### Information about a Clan
```python
api.clan_tag(tag) #example tag "#9UOVJJ9J"
```
<details>
<summary>Click to view output</summary>
```text
{
"warLeague": {
"name": {},
"id": 0
},
"memberList": [
{
"league": {
"name": {},
"id": 0,
"iconUrls": {}
},
"tag": "string",
"name": "string",
"role": "string",
"expLevel": 0,
"clanRank": 0,
"previousClanRank": 0,
"donations": 0,
"donationsReceived": 0,
"trophies": 0,
"versusTrophies": 0
}
],
"isWarLogPublic": true,
"tag": "string",
"warFrequency": "string",
"clanLevel": 0,
"warWinStreak": 0,
"warWins": 0,
"warTies": 0,
"warLosses": 0,
"clanPoints": 0,
"clanVersusPoints": 0,
"requiredTrophies": 0,
"name": "string",
"location": {
"localizedName": "string",
"id": 0,
"name": "string",
"isCountry": true,
"countryCode": "string"
},
"type": "string",
"members": 0,
"labels": [
{
"name": {},
"id": 0,
"iconUrls": {}
}
],
"description": "string",
"badgeUrls": {}
}
```
</details>
#### Members Only
```python
api.clan_members(tag)
```
returns membersList information from api.clan_tag(tag) under "items" in dict
### War Log Information
```python
api.clan_war_log(tag)
```
<details>
<summary>Click to view output</summary>
```text
{items:
[
{
"clan": {
"destructionPercentage": {},
"tag": "string",
"name": "string",
"badgeUrls": {},
"clanLevel": 0,
"attacks": 0,
"stars": 0,
"expEarned": 0,
"members": [
{
"tag": "string",
"name": "string",
"mapPosition": 0,
"townhallLevel": 0,
"opponentAttacks": 0,
"bestOpponentAttack": {
"order": 0,
"attackerTag": "string",
"defenderTag": "string",
"stars": 0,
"destructionPercentage": 0
},
"attacks": [
{
"order": 0,
"attackerTag": "string",
"defenderTag": "string",
"stars": 0,
"destructionPercentage": 0
}
]
}
]
},
"teamSize": 0,
"opponent": {
"destructionPercentage": {},
"tag": "string",
"name": "string",
"badgeUrls": {},
"clanLevel": 0,
"attacks": 0,
"stars": 0,
"expEarned": 0,
"members": [
{
"tag": "string",
"name": "string",
"mapPosition": 0,
"townhallLevel": 0,
"opponentAttacks": 0,
"bestOpponentAttack": {
"order": 0,
"attackerTag": "string",
"defenderTag": "string",
"stars": 0,
"destructionPercentage": 0
},
"attacks": [
{
"order": 0,
"attackerTag": "string",
"defenderTag": "string",
"stars": 0,
"destructionPercentage": 0
}
]
}
]
},
"endTime": "string",
"result": "string"
}
],
"paging": {'cursors': {}}
}
```
</details>
### Current War Information
```python
api.clan_current_war(tag)
```
<details>
<summary>Click to view output</summary>
```text
{
"clan": {
"destructionPercentage": {},
"tag": "string",
"name": "string",
"badgeUrls": {},
"clanLevel": 0,
"attacks": 0,
"stars": 0,
"expEarned": 0,
"members": [
{
"tag": "string",
"name": "string",
"mapPosition": 0,
"townhallLevel": 0,
"opponentAttacks": 0,
"bestOpponentAttack": {
"order": 0,
"attackerTag": "string",
"defenderTag": "string",
"stars": 0,
"destructionPercentage": 0
},
"attacks": [
{
"order": 0,
"attackerTag": "string",
"defenderTag": "string",
"stars": 0,
"destructionPercentage": 0
}
]
}
]
},
"teamSize": 0,
"opponent": {
"destructionPercentage": {},
"tag": "string",
"name": "string",
"badgeUrls": {},
"clanLevel": 0,
"attacks": 0,
"stars": 0,
"expEarned": 0,
"members": [
{
"tag": "string",
"name": "string",
"mapPosition": 0,
"townhallLevel": 0,
"opponentAttacks": 0,
"bestOpponentAttack": {
"order": 0,
"attackerTag": "string",
"defenderTag": "string",
"stars": 0,
"destructionPercentage": 0
},
"attacks": [
{
"order": 0,
"attackerTag": "string",
"defenderTag": "string",
"stars": 0,
"destructionPercentage": 0
}
]
}
]
},
"startTime": "string",
"state": "string",
"endTime": "string",
"preparationStartTime": "string"
}
```
</details>
### Clan League Group Information
```python
api.clan_leaguegroup(tag)
```
<details>
<summary>Click to view output</summary>
```text
{
"tag": "string",
"state": "string",
"season": "string",
"clans": [
{
"tag": "string",
"clanLevel": 0,
"name": "string",
"members": [
{
"tag": "string",
"townHallLevel": 0,
"name": "string"
}
],
"badgeUrls": {}
}
],
"rounds": [
{
"warTags": [
"string"
]
}
]
}
```
</details>
### Warleague Information
```python
api.warleague(war_tag)
```
<details>
<summary>Click to view output</summary>
```text
{
"tag": "string",
"state": "string",
"season": "string",
"clans": [
{
"tag": "string",
"clanLevel": 0,
"name": "string",
"members": [
{
"tag": "string",
"townHallLevel": 0,
"name": "string"
}
],
"badgeUrls": {}
}
],
"rounds": [
{
"warTags": [
"string"
]
}
]
}
```
</details>
## Player
### Player information
```python
api.players(player_tag) #for example "#900PUCPV"
```
<details>
<summary>Click to view output</summary>
```text
{
"clan": {
"tag": "string",
"clanLevel": 0,
"name": "string",
"badgeUrls": {}
},
"league": {
"name": {},
"id": 0,
"iconUrls": {}
},
"townHallWeaponLevel": 0,
"versusBattleWins": 0,
"legendStatistics": {
"previousSeason": {
"trophies": 0,
"id": "string",
"rank": 0
},
"previousVersusSeason": {
"trophies": 0,
"id": "string",
"rank": 0
},
"bestVersusSeason": {
"trophies": 0,
"id": "string",
"rank": 0
},
"legendTrophies": 0,
"currentSeason": {
"trophies": 0,
"id": "string",
"rank": 0
},
"bestSeason": {
"trophies": 0,
"id": "string",
"rank": 0
}
},
"troops": [
{
"level": 0,
"name": {},
"maxLevel": 0,
"village": "string"
}
],
"heroes": [
{
"level": 0,
"name": {},
"maxLevel": 0,
"village": "string"
}
],
"spells": [
{
"level": 0,
"name": {},
"maxLevel": 0,
"village": "string"
}
],
"role": "string",
"attackWins": 0,
"defenseWins": 0,
"townHallLevel": 0,
"labels": [
{
"name": {},
"id": 0,
"iconUrls": {}
}
],
"tag": "string",
"name": "string",
"expLevel": 0,
"trophies": 0,
"bestTrophies": 0,
"donations": 0,
"donationsReceived": 0,
"builderHallLevel": 0,
"versusTrophies": 0,
"bestVersusTrophies": 0,
"warStars": 0,
"achievements": [
{
"stars": 0,
"value": 0,
"name": {},
"target": 0,
"info": {},
"completionInfo": {},
"village": "string"
}
],
"versusBattleWinCount": 0
}
```
</details>
## Locations
### All Locations Information
```python
api.location()
```
<details>
<summary>Click to view output</summary>
```text
{"items":
[
{
"localizedName": "string",
"id": 0,
"name": "string",
"isCountry": true,
"countryCode": "string"
}
],
"paging": {'cursors': {}}
}
```
</details>
### Information for a Single Location
```python
api.location_id(location_tag) #for example "32000047"
```
returns the above information for a single location
### Top Clans in a Location
```python
api.location_id_clan_rank(location_tag)
```
Top 200 clans in a given location
<details>
<summary>Click to view output</summary>
```text
{"items":
[
{
"clanLevel": 0,
"clanPoints": 0,
"location": {
"localizedName": "string",
"id": 0,
"name": "string",
"isCountry": true,
"countryCode": "string"
},
"members": 0,
"tag": "string",
"name": "string",
"rank": 0,
"previousRank": 0,
"badgeUrls": {}
}
],
"paging": {'cursors': {}}
}
```
</details>
### Top Players in a Location
```python
api.clan_leaguegroup(location_tag)
```
Top 200 players in a given location
<details>
<summary>Click to view output</summary>
```text
{"items":
[
{
"clan": {
"tag": "string",
"name": "string",
"badgeUrls": {}
},
"league": {
"name": {},
"id": 0,
"iconUrls": {}
},
"attackWins": 0,
"defenseWins": 0,
"tag": "string",
"name": "string",
"expLevel": 0,
"rank": 0,
"previousRank": 0,
"trophies": 0
}
],
"paging": {'cursors': {}}
}
```
</details>
### Top Versus Clans in a Location
```python
api.location_clan_versus(location_tag)
```
Top 200 versus clans in a given location
<details>
<summary>Click to view output</summary>
```text
{"items":
[
{
"clanPoints": 0,
"clanVersusPoints": 0
}
],
"paging": {'cursors': {}}
}
```
</details>
### Top Versus Players in a Location
```python
api.location_player_versus(location_tag)
```
Top 200 versus players in a given location
<details>
<summary>Click to view output</summary>
```text
{"items":
[
{
"clan": {
"tag": "string",
"name": "string",
"badgeUrls": {}
},
"versusBattleWins": 0,
"tag": "string",
"name": "string",
"expLevel": 0,
"rank": 0,
"previousRank": 0,
"versusTrophies": 0
}
],
"paging": {'cursors': {}}
}
```
</details>
## Leagues
### List leagues
```python
api.league()
```
<details>
<summary>Click to view output</summary>
```text
{"items":
[
{
"name": {},
"id": 0,
"iconUrls": {}
}
],
"paging": {'cursors': {}}
}
```
</details>
### League Information
```python
api.league_id(league_tag)
```
<details>
<summary>Click to view output</summary>
```text
{
"name": {},
"id": 0,
"iconUrls": {}
}
```
</details>
### List Season Leagues
```python
api.league_season(league_tag)
```
Information is available only for Legend League
<details>
<summary>Click to view output</summary>
```text
{"items":
[
{
"id": "string"
}
],
"paging": {'cursors': {}}
}
```
</details>
### League Season Ranking
```python
api.league_season_id(league_tag, season_tag)
```
Information is available only for Legend League
<details>
<summary>Click to view output</summary>
```text
{"items":
[
{
"clan": {
"tag": "string",
"name": "string",
"badgeUrls": {}
},
"league": {
"name": {},
"id": 0,
"iconUrls": {}
},
"attackWins": 0,
"defenseWins": 0,
"tag": "string",
"name": "string",
"expLevel": 0,
"rank": 0,
"previousRank": 0,
"trophies": 0
}
],
"paging": {'cursors': {}}
}
```
</details>
## Labels
### List Clan Labels
```python
api.clan_leaguegroup(tag)
```
<details>
<summary>Click to view output</summary>
```text
{"items":
[
{
"name": {},
"id": 0,
"iconUrls": {}
}
],
"paging": {'cursors': {}}
}
```
</details>
### List Player Labels
```python
api.labels_players()
```
<details>
<summary>Click to view output</summary>
```text
{"items":
[
{
"name": {},
"id": 0,
"iconUrls": {}
}
],
"paging": {'cursors': {}}
}
```
</details>
## Credits
- [All Contributors](../../contributors)
*Note versions below 2.0.0 are not supported anymore*
*DISCLAIMER: cocapi is not affiliated with SuperCell©.
Raw data
{
"_id": null,
"home_page": "https://github.com/tonybenoy/cocapi",
"name": "cocapi",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "Clash of Clans SuperCell API COC",
"author": "Tony Benoy",
"author_email": "me@tonybenoy.com",
"download_url": "https://files.pythonhosted.org/packages/c8/5f/029a1a530b4b1fed7787ac7a938bc42f46f4f045b4d94ea238b47578b577/cocapi-2.1.0.tar.gz",
"platform": null,
"description": "<p>\n <a href=\"https://github.com/tonybenoy/cocapi/actions\">\n <img src=\"https://github.com/tonybenoy/cocapi/workflows/mypy/badge.svg\" alt=\"Test Status\" height=\"20\">\n </a>\n <a href=\"https://pypi.org/project/cocapi/\"><img src=\"https://img.shields.io/pypi/v/cocapi\" alt=\"Pypi version\" height=\"21\"></a>\n</p>\n<p>\n <a href=\"https://www.python.org/downloads/\"><img src=\"https://img.shields.io/badge/python-3.6+-blue.svg\" alt=\"Python version\" height=\"17\"></a>\n <a href=\"https://github.com/tonybenoy/cocapi/blob/master/LICENSE\"><img src=\"https://img.shields.io/github/license/tonybenoy/cocapi\" alt=\"License\" height=\"17\"></a>\n <a href=\"https://github.com/psf/black\">\n <img src=\"https://img.shields.io/badge/code%20style-black-000000.svg\" alt=\"Codestyle Black\" height=\"17\">\n </a>\n</p>\n\n# ClashOfClansAPI\n\nPython Wrapper for SuperCells Clash Of Clans API\n\nGet Token from https://developer.clashofclans.com/\n\n# Install\n\n> pip install cocapi\n\n\n# Features and usage examples\n\n### Initialize\n\nRequired to set up the class. Versions post 6.1.0 also support getting the status code of the API call. This is useful for debugging. To use it pass `status_code=True` to the `CocApi`.\n\n```python\nfrom cocapi import CocApi\n\ntoken = 'YOUR_API_TOKEN'\ntimeout=60 #requests timeout\n\napi=CocApi(token,timeout)\n```\n\n\n\n\n## Clans\n\n### Information about a Clan\n```python\napi.clan_tag(tag) #example tag \"#9UOVJJ9J\"\n```\n<details>\n <summary>Click to view output</summary>\n\n```text\n{\n \"warLeague\": {\n \"name\": {},\n \"id\": 0\n },\n \"memberList\": [\n {\n \"league\": {\n \"name\": {},\n \"id\": 0,\n \"iconUrls\": {}\n },\n \"tag\": \"string\",\n \"name\": \"string\",\n \"role\": \"string\",\n \"expLevel\": 0,\n \"clanRank\": 0,\n \"previousClanRank\": 0,\n \"donations\": 0,\n \"donationsReceived\": 0,\n \"trophies\": 0,\n \"versusTrophies\": 0\n }\n ],\n \"isWarLogPublic\": true,\n \"tag\": \"string\",\n \"warFrequency\": \"string\",\n \"clanLevel\": 0,\n \"warWinStreak\": 0,\n \"warWins\": 0,\n \"warTies\": 0,\n \"warLosses\": 0,\n \"clanPoints\": 0,\n \"clanVersusPoints\": 0,\n \"requiredTrophies\": 0,\n \"name\": \"string\",\n \"location\": {\n \"localizedName\": \"string\",\n \"id\": 0,\n \"name\": \"string\",\n \"isCountry\": true,\n \"countryCode\": \"string\"\n },\n \"type\": \"string\",\n \"members\": 0,\n \"labels\": [\n {\n \"name\": {},\n \"id\": 0,\n \"iconUrls\": {}\n }\n ],\n \"description\": \"string\",\n \"badgeUrls\": {}\n}\n```\n</details>\n\n#### Members Only\n```python\napi.clan_members(tag)\n```\nreturns membersList information from api.clan_tag(tag) under \"items\" in dict\n\n### War Log Information\n```python\napi.clan_war_log(tag)\n```\n<details>\n <summary>Click to view output</summary>\n\n```text\n{items:\n[\n {\n \"clan\": {\n \"destructionPercentage\": {},\n \"tag\": \"string\",\n \"name\": \"string\",\n \"badgeUrls\": {},\n \"clanLevel\": 0,\n \"attacks\": 0,\n \"stars\": 0,\n \"expEarned\": 0,\n \"members\": [\n {\n \"tag\": \"string\",\n \"name\": \"string\",\n \"mapPosition\": 0,\n \"townhallLevel\": 0,\n \"opponentAttacks\": 0,\n \"bestOpponentAttack\": {\n \"order\": 0,\n \"attackerTag\": \"string\",\n \"defenderTag\": \"string\",\n \"stars\": 0,\n \"destructionPercentage\": 0\n },\n \"attacks\": [\n {\n \"order\": 0,\n \"attackerTag\": \"string\",\n \"defenderTag\": \"string\",\n \"stars\": 0,\n \"destructionPercentage\": 0\n }\n ]\n }\n ]\n },\n \"teamSize\": 0,\n \"opponent\": {\n \"destructionPercentage\": {},\n \"tag\": \"string\",\n \"name\": \"string\",\n \"badgeUrls\": {},\n \"clanLevel\": 0,\n \"attacks\": 0,\n \"stars\": 0,\n \"expEarned\": 0,\n \"members\": [\n {\n \"tag\": \"string\",\n \"name\": \"string\",\n \"mapPosition\": 0,\n \"townhallLevel\": 0,\n \"opponentAttacks\": 0,\n \"bestOpponentAttack\": {\n \"order\": 0,\n \"attackerTag\": \"string\",\n \"defenderTag\": \"string\",\n \"stars\": 0,\n \"destructionPercentage\": 0\n },\n \"attacks\": [\n {\n \"order\": 0,\n \"attackerTag\": \"string\",\n \"defenderTag\": \"string\",\n \"stars\": 0,\n \"destructionPercentage\": 0\n }\n ]\n }\n ]\n },\n \"endTime\": \"string\",\n \"result\": \"string\"\n }\n],\n\"paging\": {'cursors': {}}\n}\n```\n</details>\n\n### Current War Information\n```python\napi.clan_current_war(tag)\n```\n<details>\n <summary>Click to view output</summary>\n\n```text\n{\n \"clan\": {\n \"destructionPercentage\": {},\n \"tag\": \"string\",\n \"name\": \"string\",\n \"badgeUrls\": {},\n \"clanLevel\": 0,\n \"attacks\": 0,\n \"stars\": 0,\n \"expEarned\": 0,\n \"members\": [\n {\n \"tag\": \"string\",\n \"name\": \"string\",\n \"mapPosition\": 0,\n \"townhallLevel\": 0,\n \"opponentAttacks\": 0,\n \"bestOpponentAttack\": {\n \"order\": 0,\n \"attackerTag\": \"string\",\n \"defenderTag\": \"string\",\n \"stars\": 0,\n \"destructionPercentage\": 0\n },\n \"attacks\": [\n {\n \"order\": 0,\n \"attackerTag\": \"string\",\n \"defenderTag\": \"string\",\n \"stars\": 0,\n \"destructionPercentage\": 0\n }\n ]\n }\n ]\n },\n \"teamSize\": 0,\n \"opponent\": {\n \"destructionPercentage\": {},\n \"tag\": \"string\",\n \"name\": \"string\",\n \"badgeUrls\": {},\n \"clanLevel\": 0,\n \"attacks\": 0,\n \"stars\": 0,\n \"expEarned\": 0,\n \"members\": [\n {\n \"tag\": \"string\",\n \"name\": \"string\",\n \"mapPosition\": 0,\n \"townhallLevel\": 0,\n \"opponentAttacks\": 0,\n \"bestOpponentAttack\": {\n \"order\": 0,\n \"attackerTag\": \"string\",\n \"defenderTag\": \"string\",\n \"stars\": 0,\n \"destructionPercentage\": 0\n },\n \"attacks\": [\n {\n \"order\": 0,\n \"attackerTag\": \"string\",\n \"defenderTag\": \"string\",\n \"stars\": 0,\n \"destructionPercentage\": 0\n }\n ]\n }\n ]\n },\n \"startTime\": \"string\",\n \"state\": \"string\",\n \"endTime\": \"string\",\n \"preparationStartTime\": \"string\"\n}\n```\n</details>\n\n### Clan League Group Information\n```python\napi.clan_leaguegroup(tag)\n```\n<details>\n <summary>Click to view output</summary>\n\n```text\n{\n \"tag\": \"string\",\n \"state\": \"string\",\n \"season\": \"string\",\n \"clans\": [\n {\n \"tag\": \"string\",\n \"clanLevel\": 0,\n \"name\": \"string\",\n \"members\": [\n {\n \"tag\": \"string\",\n \"townHallLevel\": 0,\n \"name\": \"string\"\n }\n ],\n \"badgeUrls\": {}\n }\n ],\n \"rounds\": [\n {\n \"warTags\": [\n \"string\"\n ]\n }\n ]\n}\n```\n</details>\n\n### Warleague Information\n```python\napi.warleague(war_tag)\n```\n<details>\n <summary>Click to view output</summary>\n\n```text\n{\n \"tag\": \"string\",\n \"state\": \"string\",\n \"season\": \"string\",\n \"clans\": [\n {\n \"tag\": \"string\",\n \"clanLevel\": 0,\n \"name\": \"string\",\n \"members\": [\n {\n \"tag\": \"string\",\n \"townHallLevel\": 0,\n \"name\": \"string\"\n }\n ],\n \"badgeUrls\": {}\n }\n ],\n \"rounds\": [\n {\n \"warTags\": [\n \"string\"\n ]\n }\n ]\n}\n```\n</details>\n\n\n\n\n## Player\n\n### Player information\n```python\napi.players(player_tag) #for example \"#900PUCPV\"\n```\n<details>\n <summary>Click to view output</summary>\n\n```text\n{\n \"clan\": {\n \"tag\": \"string\",\n \"clanLevel\": 0,\n \"name\": \"string\",\n \"badgeUrls\": {}\n },\n \"league\": {\n \"name\": {},\n \"id\": 0,\n \"iconUrls\": {}\n },\n \"townHallWeaponLevel\": 0,\n \"versusBattleWins\": 0,\n \"legendStatistics\": {\n \"previousSeason\": {\n \"trophies\": 0,\n \"id\": \"string\",\n \"rank\": 0\n },\n \"previousVersusSeason\": {\n \"trophies\": 0,\n \"id\": \"string\",\n \"rank\": 0\n },\n \"bestVersusSeason\": {\n \"trophies\": 0,\n \"id\": \"string\",\n \"rank\": 0\n },\n \"legendTrophies\": 0,\n \"currentSeason\": {\n \"trophies\": 0,\n \"id\": \"string\",\n \"rank\": 0\n },\n \"bestSeason\": {\n \"trophies\": 0,\n \"id\": \"string\",\n \"rank\": 0\n }\n },\n \"troops\": [\n {\n \"level\": 0,\n \"name\": {},\n \"maxLevel\": 0,\n \"village\": \"string\"\n }\n ],\n \"heroes\": [\n {\n \"level\": 0,\n \"name\": {},\n \"maxLevel\": 0,\n \"village\": \"string\"\n }\n ],\n \"spells\": [\n {\n \"level\": 0,\n \"name\": {},\n \"maxLevel\": 0,\n \"village\": \"string\"\n }\n ],\n \"role\": \"string\",\n \"attackWins\": 0,\n \"defenseWins\": 0,\n \"townHallLevel\": 0,\n \"labels\": [\n {\n \"name\": {},\n \"id\": 0,\n \"iconUrls\": {}\n }\n ],\n \"tag\": \"string\",\n \"name\": \"string\",\n \"expLevel\": 0,\n \"trophies\": 0,\n \"bestTrophies\": 0,\n \"donations\": 0,\n \"donationsReceived\": 0,\n \"builderHallLevel\": 0,\n \"versusTrophies\": 0,\n \"bestVersusTrophies\": 0,\n \"warStars\": 0,\n \"achievements\": [\n {\n \"stars\": 0,\n \"value\": 0,\n \"name\": {},\n \"target\": 0,\n \"info\": {},\n \"completionInfo\": {},\n \"village\": \"string\"\n }\n ],\n \"versusBattleWinCount\": 0\n}\n```\n</details>\n\n\n\n\n## Locations\n\n### All Locations Information\n```python\napi.location()\n```\n<details>\n <summary>Click to view output</summary>\n\n```text\n{\"items\":\n[\n {\n \"localizedName\": \"string\",\n \"id\": 0,\n \"name\": \"string\",\n \"isCountry\": true,\n \"countryCode\": \"string\"\n }\n],\n\"paging\": {'cursors': {}}\n}\n```\n</details>\n\n### Information for a Single Location\n```python\napi.location_id(location_tag) #for example \"32000047\"\n```\n\nreturns the above information for a single location\n\n### Top Clans in a Location\n```python\napi.location_id_clan_rank(location_tag)\n```\nTop 200 clans in a given location\n<details>\n <summary>Click to view output</summary>\n\n```text\n{\"items\":\n[\n {\n \"clanLevel\": 0,\n \"clanPoints\": 0,\n \"location\": {\n \"localizedName\": \"string\",\n \"id\": 0,\n \"name\": \"string\",\n \"isCountry\": true,\n \"countryCode\": \"string\"\n },\n \"members\": 0,\n \"tag\": \"string\",\n \"name\": \"string\",\n \"rank\": 0,\n \"previousRank\": 0,\n \"badgeUrls\": {}\n }\n],\n\"paging\": {'cursors': {}}\n}\n```\n</details>\n\n### Top Players in a Location\n```python\napi.clan_leaguegroup(location_tag)\n```\nTop 200 players in a given location\n<details>\n <summary>Click to view output</summary>\n\n```text\n{\"items\":\n[\n {\n \"clan\": {\n \"tag\": \"string\",\n \"name\": \"string\",\n \"badgeUrls\": {}\n },\n \"league\": {\n \"name\": {},\n \"id\": 0,\n \"iconUrls\": {}\n },\n \"attackWins\": 0,\n \"defenseWins\": 0,\n \"tag\": \"string\",\n \"name\": \"string\",\n \"expLevel\": 0,\n \"rank\": 0,\n \"previousRank\": 0,\n \"trophies\": 0\n }\n],\n\"paging\": {'cursors': {}}\n}\n```\n</details>\n\n\n### Top Versus Clans in a Location\n```python\napi.location_clan_versus(location_tag)\n```\nTop 200 versus clans in a given location\n<details>\n <summary>Click to view output</summary>\n\n```text\n{\"items\":\n[\n {\n \"clanPoints\": 0,\n \"clanVersusPoints\": 0\n }\n],\n\"paging\": {'cursors': {}}\n}\n```\n</details>\n\n\n### Top Versus Players in a Location\n```python\napi.location_player_versus(location_tag)\n```\nTop 200 versus players in a given location\n<details>\n <summary>Click to view output</summary>\n\n```text\n{\"items\":\n[\n {\n \"clan\": {\n \"tag\": \"string\",\n \"name\": \"string\",\n \"badgeUrls\": {}\n },\n \"versusBattleWins\": 0,\n \"tag\": \"string\",\n \"name\": \"string\",\n \"expLevel\": 0,\n \"rank\": 0,\n \"previousRank\": 0,\n \"versusTrophies\": 0\n }\n],\n\"paging\": {'cursors': {}}\n}\n```\n</details>\n\n\n\n\n## Leagues\n\n### List leagues\n```python\napi.league()\n```\n<details>\n <summary>Click to view output</summary>\n\n```text\n{\"items\":\n[\n {\n \"name\": {},\n \"id\": 0,\n \"iconUrls\": {}\n }\n],\n\"paging\": {'cursors': {}}\n}\n```\n</details>\n\n\n### League Information\n```python\napi.league_id(league_tag)\n```\n<details>\n <summary>Click to view output</summary>\n\n```text\n{\n \"name\": {},\n \"id\": 0,\n \"iconUrls\": {}\n}\n```\n</details>\n\n\n### List Season Leagues\n```python\napi.league_season(league_tag)\n```\nInformation is available only for Legend League\n<details>\n <summary>Click to view output</summary>\n\n```text\n{\"items\":\n[\n {\n \"id\": \"string\"\n }\n],\n\"paging\": {'cursors': {}}\n}\n```\n</details>\n\n\n### League Season Ranking\n```python\napi.league_season_id(league_tag, season_tag)\n```\nInformation is available only for Legend League\n<details>\n <summary>Click to view output</summary>\n\n```text\n{\"items\":\n[\n {\n \"clan\": {\n \"tag\": \"string\",\n \"name\": \"string\",\n \"badgeUrls\": {}\n },\n \"league\": {\n \"name\": {},\n \"id\": 0,\n \"iconUrls\": {}\n },\n \"attackWins\": 0,\n \"defenseWins\": 0,\n \"tag\": \"string\",\n \"name\": \"string\",\n \"expLevel\": 0,\n \"rank\": 0,\n \"previousRank\": 0,\n \"trophies\": 0\n }\n],\n\"paging\": {'cursors': {}}\n}\n```\n</details>\n\n\n\n\n## Labels\n\n### List Clan Labels\n```python\napi.clan_leaguegroup(tag)\n```\n<details>\n <summary>Click to view output</summary>\n\n```text\n{\"items\":\n[\n {\n \"name\": {},\n \"id\": 0,\n \"iconUrls\": {}\n }\n],\n\"paging\": {'cursors': {}}\n}\n```\n</details>\n\n\n### List Player Labels\n```python\napi.labels_players()\n```\n<details>\n <summary>Click to view output</summary>\n\n```text\n{\"items\":\n[\n {\n \"name\": {},\n \"id\": 0,\n \"iconUrls\": {}\n }\n],\n\"paging\": {'cursors': {}}\n}\n```\n</details>\n\n\n## Credits\n- [All Contributors](../../contributors)\n\n*Note versions below 2.0.0 are not supported anymore*\n\n*DISCLAIMER: cocapi is not affiliated with SuperCell\u00a9.\n",
"bugtrack_url": null,
"license": "",
"summary": "A python wrapper around clash of clans api",
"version": "2.1.0",
"project_urls": {
"Homepage": "https://github.com/tonybenoy/cocapi"
},
"split_keywords": [
"clash",
"of",
"clans",
"supercell",
"api",
"coc"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "0597a5fca9631d1e999e6306493bd4426f14b190117ed8d8aba3e9fbafd64f20",
"md5": "afafd963e6df2efa35211cb2c90356b4",
"sha256": "84d9a464d330e079ab8b10bd34e1048553d4d90656b617d24243ca5a67088d31"
},
"downloads": -1,
"filename": "cocapi-2.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "afafd963e6df2efa35211cb2c90356b4",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 18800,
"upload_time": "2023-07-08T12:45:52",
"upload_time_iso_8601": "2023-07-08T12:45:52.600659Z",
"url": "https://files.pythonhosted.org/packages/05/97/a5fca9631d1e999e6306493bd4426f14b190117ed8d8aba3e9fbafd64f20/cocapi-2.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c85f029a1a530b4b1fed7787ac7a938bc42f46f4f045b4d94ea238b47578b577",
"md5": "167c6492198d2bf0338bc97a6ddce9ad",
"sha256": "22fa802838cf22f97fd667adbae8dda008515e4a1ab9f96709d6b2e713de1100"
},
"downloads": -1,
"filename": "cocapi-2.1.0.tar.gz",
"has_sig": false,
"md5_digest": "167c6492198d2bf0338bc97a6ddce9ad",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 21357,
"upload_time": "2023-07-08T12:45:54",
"upload_time_iso_8601": "2023-07-08T12:45:54.147632Z",
"url": "https://files.pythonhosted.org/packages/c8/5f/029a1a530b4b1fed7787ac7a938bc42f46f4f045b4d94ea238b47578b577/cocapi-2.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-07-08 12:45:54",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "tonybenoy",
"github_project": "cocapi",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "cocapi"
}