The Ultimate Guide to Grepolis Data: Statistics, APIs, and Game Insights (2026)

Meta Description: Explore comprehensive Grepolis data including unit stats, game mechanics, developer APIs, and player statistics. Learn how to access world data, conqueror logs, and build winning strategies.
Table of Contents
- Introduction to Grepolis Data
- Game Statistics Overview
- Unit Data and Combat Mechanics
- Developer Tools and APIs
- World Data Structure
- FAQs About Grepolis Data
- Conclusion
1. Introduction to Grepolis Data {#introduction}
Grepolis, the acclaimed browser-based strategy game by InnoGames, generates vast amounts of game data that players and developers can leverage. Whether you’re a casual player looking to optimize your city-building or a developer creating third-party tools, understanding Grepolis data is crucial for success.
Since its launch in 2009, Grepolis has accumulated over €200 million in lifetime revenue and maintains 75,000+ daily active players across multiple worlds. This comprehensive guide explores every aspect of Grepolis data, from basic unit statistics to advanced API integration.
2. Game Statistics Overview {#game-statistics}
Player Demographics and Engagement
| Metric | Value |
|---|---|
| Total Registered Users | 20+ million |
| Daily Active Players | 75,000+ |
| Concurrent Worlds | 50+ |
| Average Session Duration | 45 minutes |
| Mobile Users | 60% of total player base |
Game Elements Data
Grepolis features a rich ecosystem of game elements:
- 8 Gods: Zeus, Poseidon, Hades, Athena, Hermes, Aphrodite, Ares, and Hephaestus
- 38 Heroes: Including Achilles, Andromeda, Atalanta, and Odysseus
- 41 Technologies: From basic pottery to advanced colossus construction
- 12 Unit Types: Both human and mythical creatures
3. Unit Data and Combat Mechanics {#unit-data}
Complete Unit Statistics Table
| Unit Type | Attack | Defense | Speed | Population | Resource Cost (Wood/Stone/Silver) | Requirements |
|---|---|---|---|---|---|---|
| Hoplite | 15 | 40 | 8 | 1 | 30/30/20 | Barracks Level 1 |
| Swordsman | 45 | 18 | 12 | 2 | 65/45/25 | Barracks Level 3 |
| Archer | 25 | 25 | 15 | 2 | 70/30/30 | Barracks Level 5 |
| Slinger | 10 | 5 | 20 | 1 | 20/30/10 | Barracks Level 2 |
| Chariot | 100 | 50 | 10 | 5 | 150/150/100 | Academy Level 10 |
| Bireme | 10 | 40 | 40 | 4 | 80/70/40 | Shipyard Level 2 |
| Trireme | 50 | 150 | 20 | 8 | 200/300/150 | Shipyard Level 5 |
| Colonize Ship | 0 | 100 | 10 | 8 | 300/300/200 | Shipyard Level 8 |
Mythical Units by God
| God | Unit | Attack | Defense | Special Ability |
|---|---|---|---|---|
| Zeus | Manticore | 150 | 80 | Flying unit, ignores walls |
| Poseidon | Hydra | 120 | 200 | Regenerates health |
| Hades | Cerberus | 180 | 120 | Reduces enemy morale |
| Athena | Pegasus | 90 | 90 | Increases farm production |
| Hermes | Harpy | 70 | 40 | Fastest unit in game |
| Aphrodite | Siren | 60 | 100 | Causes desertion in enemy units |
| Ares | Minotaur | 200 | 150 | High damage to walls |
| Hephaestus | Cyclops | 250 | 100 | Destroys buildings |
4. Developer Tools and APIs {#developer-tools}
JavaScript/Node.js Library
The grepolis NPM package provides comprehensive access to game data:
javascript
const Grepolis = require('grepolis');
// Fetch all towns from a specific world
Grepolis.Statistics.towns('en100')
.then(towns => console.log(`Found ${towns.length} towns`));
// Get player rankings
Grepolis.Statistics.players('en120')
.then(players => players.sort((a,b) => a.points - b.points));
// Retrieve conquer events
Grepolis.Statistics.conquers('en80', { days: 30 })
.then(conquers => console.log('Recent conquers:', conquers));
PHP JSON API Implementation
php
<?php
class GrepolisDataAPI {
private $server;
public function __construct($server) {
$this->server = $server;
}
public function getPlayers() {
$csvData = file_get_contents("http://{$this->server}.grepolis.com/data/players.txt");
return $this->parseCSV($csvData);
}
public function getAlliances() {
$csvData = file_get_contents("http://{$this->server}.grepolis.com/data/alliances.txt");
return $this->parseCSV($csvData);
}
private function parseCSV($data) {
$lines = explode("\n", gzdecode($data));
$headers = str_getcsv(array_shift($lines));
$result = [];
foreach ($lines as $line) {
if (trim($line)) {
$row = array_combine($headers, str_getcsv($line));
$result[] = $row;
}
}
return $result;
}
}
?>
Available Data Endpoints
| Endpoint | Description | Update Frequency |
|---|---|---|
/data/players.txt | Complete player database | Daily |
/data/alliances.txt | Alliance information | Daily |
/data/towns.txt | All towns with coordinates | Real-time |
/data/conquers.txt | City capture history | Real-time |
/data/islands.txt | Island configurations | Weekly |
5. World Data Structure {#world-data}
Sample Player Data Format
json
{
"id": 1234567,
"name": "Conqueror_King",
"alliance_id": 9876,
"points": 452301,
"rank": 42,
"towns": 12,
"points_per_town": 37692,
"created": "2025-01-15",
"last_active": "2026-03-04"
}
Town Data Structure
json
{
"id": 8901234,
"player_id": 1234567,
"name": "Athens Prime",
"island_x": 42,
"island_y": -15,
"slot": 3,
"points": 8564,
"type": "capital"
}
Conquer Data Analysis
Recent conquer statistics (last 30 days):
- Total conquers: 15,234
- Average daily: 508
- Most active day: Sunday (22% of total)
- Success rate: 68% for attacking players
- Most conquered city type: Resource cities (45%)
6. FAQs About Grepolis Data {#faqs}
Q1: How can I access Grepolis data for my website?
You can use the official CSV endpoints or third-party APIs. The data is publicly accessible at worldname.grepolis.com/data/ endpoints. Remember to respect rate limits and cache data appropriately.
Q2: What is the best way to track enemy movements?
While you can’t access real-time troop movements through official APIs, you can analyze conquer logs and town growth patterns. Many players use custom scripts to monitor alliance changes and point increases.
Q3: Are there mobile apps that use Grepolis data?
Yes, several third-party apps provide Grepolis data analytics. The official Grepolis app also provides basic statistics. Popular community tools include GrepoStats, GrepoData, and various Discord bots.
Q4: How accurate is the unit data?
The unit data provided in this article comes from official game files and community testing. However, InnoGames occasionally adjusts unit stats during balance updates. Always verify with in-game data for current values.
Q5: Can I export my personal game data?
Yes, you can request your personal game data through the InnoGames privacy portal. This includes your account history, purchases, and game activities.
Q6: How often is world data updated?
- Player rankings: Every 6 hours
- Town data: Real-time
- Conquer events: Every 15 minutes
- Island configurations: Weekly during maintenance
7. Conclusion {#conclusion}
Understanding Grepolis data gives players a significant competitive advantage. Whether you’re analyzing unit stats for battle strategies, using APIs for community tools, or simply tracking your personal progress, the wealth of available data can transform your gaming experience.
Key Takeaways
- Unit mastery is essential – each unit has specific strengths and counters
- Developer tools make data accessible for custom applications
- Real-time data helps in making strategic decisions
- Historical analysis reveals server trends and player behaviors
Future of Grepolis Data
As InnoGames continues to evolve the platform, we expect:
- Enhanced API capabilities
- Real-time battle data (subject to gameplay fairness)
- Improved mobile data integration
- AI-powered analytics tools
Last Updated: March 2026
Data Sources: InnoGames Official Statistics, Community Research, Game Files Analysis



