Supercell

Look up Clash of Clans clans, players, members, and wars from Supercell's official game API.

Actions

Action	What it does
Get a clan	Get a Clash of Clans clan's full details by tag, including its war record and member list.
Get a player	Get a Clash of Clans player's profile by tag.
Get clan capital raids	List a clan's past Clan Capital raid weekends.
Get clan members	List the members of a Clash of Clans clan.
Get clan rankings	List the top-ranked clans for a location (or worldwide).
Get clan war log	List a clan's past wars.
Get current war	Get a clan's current war.
Get Gold Pass season	Get the current Gold Pass season's start and end times.
Get leagues	List the game's trophy leagues.
Get locations	List the locations (countries/regions) used for rankings.
Get player rankings	List the top-ranked players for a location (or worldwide).
Search clans	Search for Clash of Clans clans by name.

Get a clan

Get a Clash of Clans clan's full details by tag, including its war record and member list.

Inputs

Clan tagclan_tagtextRequired: The clan's tag (e.g. '#2PP'), from Search clans.

Outputs

badge_urltext: Clan badge image URL.
clan_levelnumber: Clan level.
clan_pointsnumber: Clan points.
descriptiontext: Clan description.
is_war_log_publictrue/false: Whether the war log is public.
locationtext: Clan location name.
member_listlist: The clan's members.
membersnumber: Current member count.
nametext: Clan name.
required_trophiesnumber: Trophies required to join.
tagtext: Clan tag.
typetext: open, inviteOnly, or closed.
war_frequencytext: How often the clan wars.
war_lossesnumber: Total war losses (if public).
war_tiesnumber: Total war ties (if public).
war_win_streaknumber: Current war win streak.
war_winsnumber: Total war wins.

Example output

{
  "badge_url": "https://api-assets.clashofclans.com/badges/512/abc.png",
  "clan_level": 20,
  "clan_points": 45123,
  "description": "Top war clan. English only.",
  "is_war_log_public": true,
  "location": "International",
  "member_list": [
    {
      "clan_rank": 1,
      "donations": 1200,
      "donations_received": 800,
      "exp_level": 234,
      "league": "Legend League",
      "name": "Alice",
      "role": "leader",
      "tag": "#V0LUP",
      "town_hall_level": 16,
      "trophies": 5400
    }
  ],
  "members": 2,
  "name": "Reddit Alpha",
  "required_trophies": 3000,
  "tag": "#2PP",
  "type": "inviteOnly",
  "war_frequency": "always",
  "war_losses": 88,
  "war_ties": 3,
  "war_win_streak": 4,
  "war_wins": 412
}

Get a player

Get a Clash of Clans player's profile by tag.

Inputs

Player tagplayer_tagtextRequired: The player's tag (e.g. '#V0LUP').

Outputs

attack_winsnumber: Attack wins this season.
best_trophiesnumber: All-time best trophies.
clan_nametext: Current clan name, if any.
clan_tagtext: Current clan tag, if any.
defense_winsnumber: Defense wins this season.
donationsnumber: Troops donated this season.
donations_receivednumber: Troops received this season.
exp_levelnumber: Experience level.
leaguetext: Current league name.
nametext: Player name.
roletext: Clan role, if in a clan.
tagtext: Player tag.
town_hall_levelnumber: Town Hall level.
trophiesnumber: Current trophies.
war_starsnumber: Total war stars earned.

Example output

{
  "attack_wins": 152,
  "best_trophies": 5723,
  "clan_name": "Reddit Alpha",
  "clan_tag": "#2PP",
  "defense_wins": 41,
  "donations": 1200,
  "donations_received": 800,
  "exp_level": 234,
  "league": "Legend League",
  "name": "Alice",
  "role": "leader",
  "tag": "#V0LUP",
  "town_hall_level": 16,
  "trophies": 5400,
  "war_stars": 1487
}

Get clan capital raids

List a clan's past Clan Capital raid weekends.

Inputs

Clan tagclan_tagtextRequired: The clan's tag (e.g. '#2PP'), from Search clans.
How many seasonslimitnumber: How many raid weekends to return (1–50).From 1 to 50. Default: 10.

Outputs

countnumber: Number of seasons returned.
seasonslist: Past raid weekends, most recent first.

Example output

{
  "count": 1,
  "seasons": [
    {
      "capital_total_loot": 185000,
      "defensive_reward": 190,
      "end_time": "20260811T070000.000Z",
      "offensive_reward": 1620,
      "raids_completed": 6,
      "start_time": "20260808T070000.000Z",
      "state": "ended",
      "total_attacks": 245
    }
  ]
}

Get clan members

List the members of a Clash of Clans clan.

Inputs

Clan tagclan_tagtextRequired: The clan's tag (e.g. '#2PP'), from Search clans.
How many memberslimitnumber: How many members to return (1–50).From 1 to 50. Default: 50.

Outputs

memberslist: The clan's members.

Example output

{
  "members": [
    {
      "clan_rank": 1,
      "donations": 1200,
      "donations_received": 800,
      "exp_level": 234,
      "league": "Legend League",
      "name": "Alice",
      "role": "leader",
      "tag": "#V0LUP",
      "town_hall_level": 16,
      "trophies": 5400
    }
  ]
}

Get clan rankings

List the top-ranked clans for a location (or worldwide).

Inputs

Locationlocation_idtextRequired: Which location's rankings to fetch.
How many clanslimitnumber: How many clans to return (1–50).From 1 to 50. Default: 20.

Outputs

clanslist: Ranked clans, best first.
countnumber: Number of clans returned.

Example output

{
  "clans": [
    {
      "clan_level": 30,
      "clan_points": 62000,
      "location": "International",
      "members": 50,
      "name": "Reddit Alpha",
      "rank": 1,
      "tag": "#2PP"
    }
  ],
  "count": 1
}

Get clan war log

List a clan's past wars. The clan's war log must be public.

Inputs

Clan tagclan_tagtextRequired: The clan's tag (e.g. '#2PP'), from Search clans.
How many warslimitnumber: How many past wars to return (1–50).From 1 to 50. Default: 10.

Outputs

countnumber: Number of wars returned.
warslist: Past wars, most recent first.

Example output

{
  "count": 1,
  "wars": [
    {
      "clan_destruction_percentage": 98.5,
      "clan_stars": 42,
      "end_time": "20260810T120000.000Z",
      "opponent_destruction_percentage": 90.1,
      "opponent_name": "War Machine",
      "opponent_stars": 35,
      "opponent_tag": "#8GQPJG2",
      "result": "win",
      "team_size": 15
    }
  ]
}

Get current war

Get a clan's current war. The clan's war log must be public.

Inputs

Clan tagclan_tagtextRequired: The clan's tag (e.g. '#2PP'), from Search clans.

Outputs

clanobject: This clan's war performance.
end_timetext: When the war ends.
opponentobject: The opposing clan's war performance.
preparation_start_timetext: When prep began.
start_timetext: When the war started.
statetext: notInWar, preparation, inWar, or warEnded.
team_sizenumber: Players per side.

Example output

{
  "clan": {
    "attacks": 25,
    "clan_level": 20,
    "destruction_percentage": 94.5,
    "name": "Reddit Alpha",
    "stars": 28,
    "tag": "#2PP"
  },
  "end_time": "20260812T120000.000Z",
  "opponent": {
    "attacks": 27,
    "clan_level": 18,
    "destruction_percentage": 88.2,
    "name": "War Machine",
    "stars": 24,
    "tag": "#8GQPJG2"
  },
  "preparation_start_time": "20260810T120000.000Z",
  "start_time": "20260811T120000.000Z",
  "state": "inWar",
  "team_size": 15
}

Get Gold Pass season

Get the current Gold Pass season's start and end times.

Inputs

None.

Outputs

end_timetext: When the season ends.
start_timetext: When the season started.

Example output

{
  "end_time": "20260901T080000.000Z",
  "start_time": "20260801T080000.000Z"
}

Get leagues

List the game's trophy leagues.

Inputs

How many leagueslimitnumber: How many leagues to return (1–50).From 1 to 50. Default: 50.

Outputs

countnumber: Number of leagues returned.
leagueslist: The trophy leagues.

Example output

{
  "count": 1,
  "leagues": [
    {
      "id": 29000022,
      "name": "Legend League"
    }
  ]
}

Get locations

List the locations (countries/regions) used for rankings.

Inputs

How many locationslimitnumber: How many locations to return (1–50).From 1 to 50. Default: 50.

Outputs

countnumber: Number of locations returned.
locationslist: The available locations.

Example output

{
  "count": 1,
  "locations": [
    {
      "country_code": null,
      "id": 32000006,
      "is_country": false,
      "name": "International"
    }
  ]
}

Get player rankings

List the top-ranked players for a location (or worldwide).

Inputs

Locationlocation_idtextRequired: Which location's rankings to fetch.
How many playerslimitnumber: How many players to return (1–50).From 1 to 50. Default: 20.

Outputs

countnumber: Number of players returned.
playerslist: Ranked players, best first.

Example output

{
  "count": 1,
  "players": [
    {
      "attack_wins": 480,
      "clan_name": "Reddit Alpha",
      "defense_wins": 120,
      "exp_level": 260,
      "name": "Alice",
      "rank": 1,
      "tag": "#V0LUP",
      "trophies": 6100
    }
  ]
}

Search clans

Search for Clash of Clans clans by name.

Inputs

Clan namenametextRequired: The clan name to search for (at least 3 characters).
Minimum membersmin_membersnumber: Only include clans with at least this many members.From 0 to 50.
Maximum membersmax_membersnumber: Only include clans with at most this many members.From 0 to 50.
How many clanslimitnumber: How many clans to return (1–50).From 1 to 50. Default: 10.

Outputs

clanslist: The matching clans.

Example output

{
  "clans": [
    {
      "badge_url": "https://api-assets.clashofclans.com/badges/512/abc.png",
      "clan_level": 20,
      "clan_points": 45123,
      "location": "International",
      "members": 2,
      "name": "Reddit Alpha",
      "required_trophies": 3000,
      "tag": "#2PP",
      "type": "inviteOnly"
    }
  ]
}

ActionsCopy Anchor Link

Get a clanCopy Anchor Link

Inputs

Outputs

Get a playerCopy Anchor Link

Inputs

Outputs

Get clan capital raidsCopy Anchor Link

Inputs

Outputs

Get clan membersCopy Anchor Link

Inputs

Outputs

Get clan rankingsCopy Anchor Link

Inputs

Outputs

Get clan war logCopy Anchor Link

Inputs

Outputs

Get current warCopy Anchor Link

Inputs

Outputs

Get Gold Pass seasonCopy Anchor Link

Inputs

Outputs

Get leaguesCopy Anchor Link

Inputs

Outputs

Get locationsCopy Anchor Link

Inputs

Outputs

Get player rankingsCopy Anchor Link

Inputs

Outputs

Search clansCopy Anchor Link

Inputs

Outputs

On this page

Actions

Get a clan

Get a player

Get clan capital raids

Get clan members

Get clan rankings

Get clan war log

Get current war

Get Gold Pass season

Get leagues

Get locations

Get player rankings

Search clans