Select Language

WarcraftRealms World of Warcraft Census Data Export

If you run a World of Warcraft web site or are developing a World of Warcraft application then this is a feature of the site that you might be interested in. All of the current realm data from this site is now available in CSV format.

Every night the current realm data from this site is dumped out to CSV files, which are available for download. If you run a WoW web site and want to show realm information or if you are developing a WoW application based on realm information then you can grab a copy of the files and incorporate the data in to your site or application.

Guild Exports are also now available. You can find the specific link for the guild data on the Guild Display page. When you find your guild, the link for your guild will be available at the top of the page.

There is quite a bit of information available on how to use the exports here:

Here are the rules that must be adhered to if you make use of any of these features:

  1. You must place the following text and link in a prominent place on your web site or application:

        Census data provided by

    Anyone found not displaying this text and link may be banned from the site.
  2. You are not allowed to charge a user for access to this data, either real money or in-game gold. Using the data to support a premium service is fine as long as the user is only paying for access to data other than the realm data provided in the export files. If you are using it to support a premium service then the data provided in the export files must be viewable by all users on your site, not just the premium members.

  3. Please use this static data rather than screen scraping the data on the site. Screen scraping puts extra load on our database, this feature doesn't.
  4. I cannot guarantee that this feature will be available at all times (server downtime etc.).
  5. You must code your web site or application to only download the CSV file when there is a new one available. There is no advantage to be gained from downloading every time you need to access the data and it will keep our bandwidth usage figures down. You can use the status files (see below) to find out if a new version of the file is available.
  6. To preserve bandwidth the CSV files are supplied in gzip format. Your web site or application must be able to decode gzip files. See the links at the bottom of this page for help with this.

If you are found to be breaking any of these rules then your IP address will be permanently banned from this site.

So, what do you need to know to take advantage of this feature?

Server composite information containing Server, Timezone, ServerType, HordePop, AlliancePop :

The link to all realms combined is here:

The links to the realm files are: Peak.csv.gz of Storms.csv.gz Mountains.csv.gz'thul.csv.gz'arak.csv.gz 52.csv.gz Dawn.csv.gz Dragonflight.csv.gz Raiders.csv.gz Lair.csv.gz's Edge.csv.gz Hollow.csv.gz Furnace.csv.gz Tundra.csv.gz Blade.csv.gz Legion.csv.gz Circle.csv.gz'gall.csv.gz Iron.csv.gz'Remar.csv.gz Soul.csv.gz'Tharon.csv.gz'thul.csv.gz Ring.csv.gz Isles.csv.gz'Thalas.csv.gz Dream.csv.gz Peak.csv.gz'Qiraj.csv.gz'Akir.csv.gz'Thul.csv.gz'arak.csv.gz 52.csv.gz Dawn.csv.gz's Edge.csv.gz Dragonflight.csv.gz Blade.csv.gz Legion.csv.gz Steppes.csv.gz'thun.csv.gz of Aspects.csv.gz éternels.csv.gz'gall.csv.gz Pardas.csv.gzérie du Thorium.csv.gz des Ombres.csv.gz de la Rive Noire.csv.gz Faire.csv.gz Konsortium.csv.gz Syndikat.csv.gz Brotherhood.csv.gz abyssische Rat.csv.gz Mithrilorden.csv.gz Rat von Dalaran.csv.gz Aldor.csv.gz Arguswacht.csv.gz ewige Wacht.csv.gz Nachtwache.csv.gz Silberne Hand.csv.gz Todeskrallen.csv.gz'thul.csv.gz'Thar.csv.gz Modr.csv.gz Morogh.csv.gz Ring.csv.gz'thalas.csv.gz Dream.csv.gz der Stürme.csv.gz Batol.csv.gz'dan.csv.gz'Thas.csv.gz'Thuzad.csv.gz Modan.csv.gz'goroth.csv.gz'Jaeden.csv.gz Tor.csv.gz'gall.csv.gz'jin.csv.gz Tiras.csv.gz der Verdammten.csv.gz Croisade écarlate.csv.gz Skull.csv.gz Clairvoyants.csv.gz Sentinelles.csv.gz's Blade.csv.gz Errantes.csv.gz'Ganis.csv.gzécage de Zangar.csv.gz Core.csv.gz'thol.csv.gz'zhul.csv.gz'thor.csv.gz dell'Eternitŕ.csv.gz'Thalas.csv.gz Legion.csv.gz'jin.csv.gz Halls.csv.gz Hand.csv.gz'dralar.csv.gz Cartel.csv.gz Mill.csv.gz noir.csv.gz Maelstrom.csv.gz Sha'tar.csv.gz Venture Co.csv.gz'Feroth.csv.gz's Hammer.csv.gz Nether.csv.gz'Goro.csv.gz'lor.csv.gz'nilash.csv.gz'jin.csv.gz des Cenarius.csv.gz'jin.csv.gz Hills.csv.gz'dan.csv.gz'Thos.csv.gz'Thas.csv.gz'Thuzad.csv.gz Modan.csv.gz'goroth.csv.gz'Jaeden.csv.gz Tor.csv.gz Tiras.csv.gz Skull.csv.gz's Blade.csv.gz'Ganis.csv.gz'Nathal.csv.gz Guard.csv.gz'thol.csv.gz'zhul.csv.gz'dorei.csv.gz'Thalas.csv.gz Crusade.csv.gz'jin.csv.gz Council.csv.gz Halls.csv.gz Hand.csv.gz'halo.csv.gz Hand.csv.gz of Elune.csv.gz Cartel.csv.gz Forgotten Coast.csv.gz Scryers.csv.gz Underbog.csv.gz Venture Co.csv.gz Brotherhood.csv.gz Barad.csv.gz Nether.csv.gz'nilash.csv.gz Accord.csv.gz'jin.csv.gz

There is also a status file available, that allows you to get the date when the files were last generated (in UNIX timestamp format):

The format of the CSV files are not final and may undergo some changes. It is also still in development mode, so I may make changes that will break functionality in your application.

Here are some links that you may find useful:

  • zlib Home Site
    Long list of links to info and versions of a free gzip capable library for just about any platform.
  • zlib in PHP
    Info on what you need to handle gzip files in PHP.

I will also be adding code examples here when I get the chance to put them together. If you have any good links or examples then please get in touch.

Please post all your questions and feedback in this thread.

Some text shamelessly lifted from

Advertise Here!