Actions24
- Get Capital District Info
- Get Clan
- Get Clan Capital Info
- Get Clan Capital Raid Log
- Get Clan Members
- Get Clan Rankings
- Get Clan War Log
- Get Current War
- Get CWL Group
- Get CWL War
- Get League Info
- Get League Season Rankings
- Get League Seasons
- Get Location Info
- Get Location Rankings
- Get Locations
- Get Player
- Get Player Achievement Progress
- Get Player Battle Log
- Get Player Rankings
- Get Player Upcoming Chests
- Get War Leagues
- Search Clans
- Verify Player Token
Overview
This node integrates with the Clash of Clans API to retrieve various game-related data. Specifically, the "Get Location Rankings" operation fetches rankings for players or clans within a specified geographic location or region in the game. This is useful for tracking competitive standings, analyzing player or clan performance by region, and building leaderboards.
Practical examples include:
- Displaying top-ranked players or clans in a global or country-specific leaderboard.
- Monitoring rankings for different game modes such as Builder Base or Capital.
- Integrating ranking data into dashboards or reports for gaming communities or esports analytics.
Properties
| Name | Meaning |
|---|---|
| Location ID | The identifier of the location to retrieve rankings for. Examples: 32000006 (Global), 32000007 (USA), etc. |
| Ranking Type | The category of rankings to retrieve. Options are: - Clans - Clans Builder Base - Clans Capital - Players - Players Builder Base |
Output
The node outputs JSON data containing the ranking information retrieved from the Clash of Clans API for the specified location and ranking type. The output structure includes:
operation: The operation performed ("getLocationRankings").url: The full API endpoint URL used for the request.data: The raw response data from the API, which contains the ranking details such as player or clan ranks, names, scores, and other relevant statistics.timestamp: The time when the data was processed.metadata: Additional metadata including the operation type ("discovery"), API version, and processing timestamp.
The node does not output binary data.
Dependencies
- Requires an API key credential for authenticating with the Clash of Clans API.
- The node makes HTTP requests to the official Clash of Clans API endpoint (
https://api.clashofclans.com/v1). - Proper configuration of the API token credential in n8n is necessary.
Troubleshooting
Common issues:
- Invalid or missing API token will cause authentication errors.
- Incorrect Location ID or Ranking Type may result in empty or error responses.
- Network connectivity problems can prevent successful API calls.
Error messages:
- Authentication failures typically indicate invalid or expired API tokens; ensure the API key is valid and has required permissions.
- "Operation not supported" error occurs if an unsupported operation name is provided.
- Rate limiting errors from the API may require implementing retry logic or reducing request frequency.
Links and References
- Clash of Clans Official API Documentation
- Clash of Clans Locations and IDs Reference (for valid Location IDs)
- n8n Documentation on HTTP Request Node (for understanding underlying HTTP calls)