GetGamesList

From TheGamesDB Wiki
Jump to: navigation, search

The GetGamesList API search returns a listing of games matched up with loose search terms.


Note: We have implemented special character stripping and loose word order searching in an attempt to provide better matching and a return a greater number of relevant hits.


Changelog:

7-17-11: Added Genre Filtering Support.


Contents

Parameters:

name (required)

platform (optional): filters results by platform (See this wiki article for a list of valid platforms ValidPlatformsList)

genre (optional): filters results by genre (See this wiki article for a list of valid genres ValidGenresList)


Response Items:

> id - The unique ID number of the game returned in the item.

> GameTitle - The non-unique name of the game returned in the item.

> ReleaseDate - The release date of the game returned in the item.

> Platform - The associated games platform of the game returned in the item.


Example Request:

http://thegamesdb.net/api/GetGamesList.php?name=x-men


Example Response:

<Data>
  <Game>
    <id>699</id>
    <GameTitle>Spider-Man/X-Men: Arcade's Revenge</GameTitle>
    <ReleaseDate>08/19/1993</ReleaseDate>
    <Platform>Sega Genesis</Platform>
  </Game>
  <Game>
    <id>1386</id>
    <GameTitle>The Uncanny X-Men</GameTitle>
    <Platform>Nintendo Entertainment System (NES)</Platform>
  </Game>
  <Game>
    <id>665</id>
    <GameTitle>X-Men</GameTitle>
    <ReleaseDate>1993</ReleaseDate>
    <Platform>Sega Genesis</Platform>
  </Game>
  <Game>
     <id>3123</id>
     <GameTitle>X-Men - Mojo World</GameTitle>
     <Platform>Sega Master System</Platform>
  </Game>
  <Game>
    <id>972</id>
    <GameTitle>X-Men 2: Clone Wars</GameTitle>
    <Platform>Sega Genesis</Platform>
  </Game>
  <Game>
    <id>628</id>
    <GameTitle>X-Men vs. Street Fighter</GameTitle>
    <ReleaseDate>09/09/1996</ReleaseDate>
    <Platform>Sony Playstation</Platform>
  </Game>
  <Game>
    <id>2468</id>
    <GameTitle>X-Men: Children Of The Atom</GameTitle>
    <ReleaseDate>1994</ReleaseDate>
    <Platform>Arcade</Platform>
  </Game>
</Data>
Personal tools
Namespaces

Variants
Actions
Navigation
Contents
Toolbox