Clash of Clans

Overview

The "Get Clan Members" operation of this Clash of Clans node retrieves a list of members belonging to a specified clan. This is useful for scenarios where you want to analyze or display the roster of a clan, track member activity, or integrate clan member data into other workflows or dashboards.

Practical examples include:

• Displaying clan member details in a community website.
• Monitoring clan membership changes over time.
• Automating notifications or reports based on clan member statistics.

Properties

Output

The output JSON contains an object with the following structure:

{
  "operation": "getClanMembers",
  "url": "https://api.clashofclans.com/v1/clans/{encodedClanTag}/members?limit=...&after=...&before=...",
  "data": {
    "items": [
      {
        "tag": "#PLAYER_TAG",
        "name": "PlayerName",
        "role": "member/leader/coLeader/etc.",
        "expLevel": 100,
        "league": { /* league info */ },
        "trophies": 3000,
        "clanRank": 1,
        "previousClanRank": 2,
        "donations": 10,
        "donationsReceived": 5,
        // ... other player/member fields
      }
      // more members...
    ],
    "paging": {
      "cursors": {
        "after": "marker",
        "before": "marker"
      }
    }
  },
  "timestamp": "ISO8601 timestamp",
  "metadata": {
    "operationType": "clan",
    "apiVersion": "v1",
    "processedAt": "ISO8601 timestamp"
  }
}

• The data.items array holds the clan members' detailed information.
• Pagination cursors (after, before) help navigate through large member lists.
• No binary data is output by this operation.

Dependencies

• Requires an API authentication token credential for the Clash of Clans API.
• The node makes HTTP requests to the official Clash of Clans API endpoint at https://api.clashofclans.com/v1.
• Proper API key setup in n8n credentials is necessary.

Troubleshooting

• Invalid Clan Tag: If the clan tag does not start with # or is malformed, the API will reject the request. Ensure the clan tag is correctly formatted.
• API Rate Limits: Frequent requests may hit rate limits imposed by the Clash of Clans API. Implement pagination and limit parameters to reduce load.
• Pagination Markers: Using invalid or expired after or before markers can cause empty results or errors. Use markers returned from previous responses.
• Authentication Errors: Missing or invalid API tokens will result in authorization failures. Verify that the API token credential is correctly configured.
• Network Issues: Connectivity problems can cause request failures. Check network access and proxy settings if applicable.

Links and References

• Official Clash of Clans API documentation: https://developer.clashofclans.com/#/documentation
• API endpoint for clan members: https://developer.clashofclans.com/#/documentation/clans/get-clan-members