AutomatedGamer API

We're pleased to offer a free API allowing access to the game information AutomatedGamer aggregates automatically. All we ask in return is that each page or application screen that uses AutomatedGamer supplied data include one of the following small logos with a link back to our site.

Use the code below to add to your site.


<!-- small banner --> 
<a href="http://www.automatedgamer.com"><img src="/images/ag_sm.png" style="border:none;" /></a>

<!-- med banner --> 
<a href="http://www.automatedgamer.com"><img src="/images/ag_med.png" style="border:none;" /></a>

<!-- large banner --> 
<a href="http://www.automatedgamer.com"><img src="/images/ag_lg.png" style="border:none;" /></a>

It's easy to get started! Simply use the form below to generate a developer key, and follow the instructions below to get started.

Request a List of Games

Our API is very simple to use, and based on GET requests and XML. Using your developer key, make the following request:


  http://www.automatedgamer.com/api/gameslist_request?devkey=000000000000000000000

This request will result in the following XML resultset, containing a list of all games tracked by AutomatedGamer.


<?xml version="1.0" encoding="UTF-8"?>
<games>
 <version>2009-07-12T13:52:08-07:00</version>
 
  <game id="1">
    <url>http://www.automatedgamer.com/game/1/silent-hill-homecoming</url>
    <name>Silent Hill: Homecoming</name>
    <release_date>2008-09-30</release_date>
    <ag_score>7.8</ag_score>
    <platforms>
      <platform>Xbox 360</platform>
      <platform>PlayStation 3</platform>
      <platform>Microsoft Windows</platform>
    </platforms>
  </game>
  
  <game id="2">
    <url>http://www.automatedgamer.com/game/2/duke-nukem-3d</url>
    <name>Duke Nukem 3D</name>
    <release_date></release_date>
    <ag_score>8.0</ag_score>
    <platforms>
    </platforms>
  </game>
  
</games>

Request Detailed Information on a Single Game

Using your developer key and the ID of the game you wish to fetch details for, make the following request:


  http://www.automatedgamer.com/api/game_request/234?devkey=000000000000000000000

In this case, we used the ID 234, which is Tomb Raider Underworld. This request will result in the following XML resultset, containing all the information aggregated by AutomatedGamer on that game.


  <?xml version="1.0" encoding="UTF-8"?>
<game id="234">
  <version>2009-07-12T13:45:59-07:00</version>
  <url>http://www.automatedgamer.com//game/234/tomb-raider-underworld</url>
  <name>Tomb Raider: Underworld</name>
  <synopsys>Lara Croft has her dual pistols prepped for an all-new adventure, and the Tomb Raider has never looked better. Lara takes off in search of a South American relic and instead stumbles across a piece of her own history: a dangerous figure from her own past. Now she's in a race to see who'll be first to find one of history's legendary treasures. Legend offers the best presentation of any Tomb Raider title, with the heroine rendered more vibrantly than ever. The cinematic environments she explores are equally dynamic. Move through them and handle objects with a new level of seamless interaction as you improvise solutions as only Croft can.</synopsys>
  <release_date>2008-11-18</release_date>
  <ag_score>6.9</ag_score>
  <amazon_url>AMAZON URL HERE</amazon_url>
  <gamefly_url>GAMEFLY URL HERE</gamefly_url>
  <created_by>Eidos</created_by>
  
  <platforms>
    <platform>PlayStation 2</platform>
    ...  
  </platforms>
  
  <reviews>
    <review>
      <score>8</score>
      <url>http://www.gamedaily.com/games/tomb-raider-underworld/xbox-360/game-reviews/review/6857/2204/</url>
      <publisher_name>GameDaily Big Games</publisher_name>
      <synopsys>In Tomb Raider Underworld, Lara Croft must overcome dangers across the globe while solving a mythological mystery that ties in with her parents' disappearance. Unfortunately, the in-game camera is a hassle, especially when enemies get too close. The open-world exploration is fun, but a lack of hints of where to go next may frustrate you. Overcome these problems, however, and you'll be handsomely rewarded with outstanding visuals, fun shoot-em-up gameplay, excellent puzzles and hours of maneuvering the sexy Ms. Croft. Like her previous two games, Underworld is a welcome, if slightly flawed, addition to the franchise.</synopsys>
    </review>
    ...
  </reviews>
  
  <newsitems>
    <newsitem>
      <type>news</type>
      <url>http://www.1up.com/do/newsStory?cId=3174349</url>
      <publisher_name>1UP</publisher_name>
      <title>PS3 Tomb Raider Underworld Trophies Coming May 28 </title>
    </newsitem>
    ...
  </newsitems>
  
  </game>