gamercard 0

A Simple & Straightforward XBox Live Gamercard parser.

4 years after MIT


Retrieves and parses an Xbox Live Gamercard for a player, providing a hash of the relevant data about the player or the raw HTML.

Build Status


Add this line to your application's Gemfile:

gem 'gamercard'

And then execute:

$ bundle

Or install it yourself as:

$ gem install gamercard


Returns a hash suitable for JSON serialization.

resp = Gamercard.get('laikal1')
pp resp
# =>
 "location"=>"Ann Arbor, MI",
 "name"=>"Nyarlathotep (1 bucket)",
 "bio"=>"Design is how it works.",
    "title"=>"KoA: Reckoning",
    "title"=>"Mass Effect 3",


Gamercard uses Faraday, so you can use any http backend that Faraday supports. It assumes Typhoeus by default. Tell Gamercard what http library you are using by:

Gamercard.adapter = :excon # (or :typhoeus, w/e)

A block-style configurator is also available:

Gamercard.configure do |c|
  c.adapter = :typhoeus
  c.user_agent = "My Awesome Client"


  • v0.0.1 Hello World
    • Returns all the basic gamercard data, sans status. Status can be had from a public site, though, so that is next!

Thanks to

This project builds on work done by the following people and projects:

  • barisbalic's gamertag, which depends on unfortunately unreliable 3rd-party proxies to Microsoft's service. This gem provides less data, but scrapes it directly from – Straight from the horse's mouth, if you will.

So: thanks a ton to him.

Note on Patches/Pull Requests

  • Fork the project.
  • Make your feature addition or bug fix.
  • Add tests for it. This is important so I don't break it in a future version unintentionally.
  • Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
  • Send me a pull request. Bonus points for topic branches.


Copyright (c) 2011 Matt Wilson. See LICENSE for details.

Related Repositories



:video_game: Python API for Xbox gamercard information, built to run on the Goog ...



An API wrapper for ...



A Wordpress sidebar widget which can display the gamerscores of authors on your ...



Generates graphical forum signatures using Xbox Live Gamercard data ...

Top Contributors