Querying The Xbox Live Game Marketplace – From Anywhere

How to get information from the undocumented Xbox Live API.

By Den Delimarsky in Hackery

May 18, 2011

I found out that the Xbox Live Game Marketplace content is syndicated via a web service tied to the Xbox Live CDN. The service returns enough information to build my own syndication client, which will be able to read game data about various titles that are currently available to be downloaded through the Xbox Live Marketplace. Here, I will explain some details on how exactly the queries can be built.

The base URL for the service is this

1
https://catalog-cdn.xboxlive.com/Catalog/Catalog.asmx/Query

This service will not be available as a service reference in Visual Studio, throwing a 403 Forbidden. However, the service can still be used if specific parameters are passed with the help of a standard WebClient and/or HttpWebRequest (either way it works fine).

What’s interesting is the way parameters are organized. There are no explicitly named parameters, but rather name/value parameter pairs, each of them based on two explicit parameters – Names an Values.

The entire Game Marketplace practically revolves around parameters passed to the same method to fetch various game data – every single entity can be obtained as long as correct parameter values are known. Genres and types are represented mostly by numerical identifiers and not by easily understandable names, which complicates the querying process quite a bit, but it is still fairly easy to implement and understand, as you will see from the ideas outlined below.

The service should have one method added to it, right after a question mark (?) following Query in the base URL. The method is called FindGames and it is the only method used in the marketplace to get content. I can safely assume that there are more methods out there, but this one seems to be the fundamental one. Here is the full URL:

1
https://catalog-cdn.xboxlive.com/Catalog/Catalog.asmx/Query?methodName=FindGames

The default set of parameters that need to be passed to the service includes the following:

  • Locale – will determine the language used to pass the game descriptions.
  • LegalLocale – doesn’t seem to directly affect the end result.
  • Store – apparently determines the store from which the data will be pulled. The default value is 1.
  • PageSize – number of results returned. The total number of items available is specified by the totalItems node in the root of the returned documents. Maximum number of results per page is 300.
  • PageNum – the page number, relative to the total number of items (in case the number of queried items is smaller than the number of total items).
  • DetailView – determines how much detailed information will be returned about each game entry. Default is set to 3 (returns box art). Can also be set to 4 (return slideshow images – large screenshots) or 5 (include rating descriptors and game capabilities – both online and offline).
  • AvatarBodyTypes – not entirely sure how it affects the results yet. Can be skipped in the query.
  • OrderDirection – defines the order in which informational nodes are arranged for each entry. Doesn’t affect the results unless the users looks at the raw XML file.
  • OfferFilterLevel – filters the offers by the ID (that determines offer types).
  • MediaTypes – defines the media types to be returned by the query.
  • OrderBy – defines the entity by which the results are ordered.
  • ImageFormats – defines image types that are returned. The default value is set to 4 and returns JPEG URLs.
  • ImageSizes – defines image sizes that are returned. Multiple parameters can be passed.
  • OfferTargetMediaTypes – apparently defines the target media types for returned offers. The offers themselves don’t seem to carry media information directly.
  • CategoryIds – defines the categories returned. The default value is set to 3027.
  • UserTypes – not sure what user types this influences yet.

Most of the parameters here are required and are passed in the URL by following this pattern (as I mentioned above):

1
Names=NAME&Values=VALUE

So, for example, passing some parameters in the URL can look like this:

1
https://catalog-cdn.xboxlive.com/Catalog/Catalog.asmx/Query?methodName=FindGames?Names=UserTypes&Values=1&Names=CategoryIds&Values=3027

This is not a valid query because it misses most of the required parameters, but you should get the idea behind it. Here is a valid list of parameters that you can use to return a result similar to the one described later in this post (this is the list of parameters to return the feed with new games):

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
Name = “Locale”, Value = “en-us”
Name = “LegalLocale”, Value = “en-us”
Name = “Store”, Value = “1″
Name = “PageSize”, Value = “30″
Name = “PageNum”, Value = “1″
Name = “DetailView”, Value = “5″
Name = “AvatarBodyTypes”, Value = “3″
Name = “AvatarBodyTypes”, Value = “1″
Name = “OrderDirection”, Value = “2″
Name = “OfferFilterLevel”, Value = “2″
Name = “MediaTypes”, Value = “1″
Name = “MediaTypes”, Value = “21″
Name = “MediaTypes”, Value = “23″
Name = “OrderBy”, Value = “21″
Name = “ImageFormats”, Value = “4″
Name = “ImageSizes”, Value = “23″
Name = “ImageSizes”, Value = “30″
Name = “OfferTargetMediaTypes”, Value = “1″
Name = “OfferTargetMediaTypes”, Value = “21″
Name = “OfferTargetMediaTypes”, Value = “23″
Name = “CategoryIds”, Value = “3027″
Name = “UserTypes”, Value = “2″
Name = “UserTypes”, Value = “3″

The end result (in XML format – for a single title):

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
<feed xmlns:live="https://www.live.com/marketplace" xmlns="https://www.w3.org/2005/Atom">
  <live:totalItems>596</live:totalItems>
  <live:numItems>100</live:numItems>
  <title>FindGames Results</title>
  <updated>2011-04-07T15:27:06.953Z</updated>
  <entry live:itemNum="101" live:detailView="5">
    <id>urn:uuid:66ACD000-77FE-1000-9115-D80258410A78</id>
    <updated>2011-02-09T00:10:57.37Z</updated>
    <title>Guwange</title>
    <content type="text">game content</content>
    <live:media>
      <live:mediaType>23</live:mediaType>
      <live:gameTitleMediaId>urn:uuid:66ACD000-77FE-1000-9115-D80258410A78</live:gameTitleMediaId>
      <live:reducedTitle>Guwange</live:reducedTitle>
      <live:reducedDescription>At the far reaches of the Eastern kingdom, in the age of Muromachi...
this is the tale of those who wielded the power of the Shikigami.
In ages past, when men worshipped nature, believed in spirits and
feared the darkness of night, they would also become envoys of a
mysterious power.

A unique shooting game set in the late Muromachi age of Japan,
Guwange includes 3 fully-featured game modes.
Challenge the online leaderboards in Score Attack mode!
Play with a friend in online CO-OP pla…</live:reducedDescription>
      <live:availabilityDate>2010-08-31T00:00:00</live:availabilityDate>
      <live:releaseDate>2010-11-10T00:00:00</live:releaseDate>
      <live:ratingId>30</live:ratingId>
      <live:ratingDescriptors>
        <live:ratingDescriptor>
          <live:ratingDescriptorId>3</live:ratingDescriptorId>
          <live:ratingDescriptorLevel>1.0000</live:ratingDescriptorLevel>
        </live:ratingDescriptor>
        <live:ratingDescriptor>
          <live:ratingDescriptorId>31</live:ratingDescriptorId>
          <live:ratingDescriptorLevel>1.0000</live:ratingDescriptorLevel>
        </live:ratingDescriptor>
        <live:ratingDescriptor>
          <live:ratingDescriptorId>42</live:ratingDescriptorId>
          <live:ratingDescriptorLevel>1.0000</live:ratingDescriptorLevel>
        </live:ratingDescriptor>
      </live:ratingDescriptors>
      <live:developer>CAVE</live:developer>
      <live:publisher>CAVE</live:publisher>
      <live:newestOfferStartDate>2010-11-10T09:00:00Z</live:newestOfferStartDate>
      <live:totalOfferCount>1</live:totalOfferCount>
      <live:titleId>1480657528</live:titleId>
      <live:effectiveTitleId>1480657528</live:effectiveTitleId>
      <live:gameReducedTitle>Guwange</live:gameReducedTitle>
      <live:fullTitle>Full Game - Guwange</live:fullTitle>
      <live:description>At the far reaches of the Eastern kingdom, in the age of Muromachi...
this is the tale of those who wielded the power of the Shikigami.
In ages past, when men worshipped nature, believed in spirits and
feared the darkness of night, they would also become envoys of a
mysterious power.

A unique shooting game set in the late Muromachi age of Japan,
Guwange includes 3 fully-featured game modes.
Challenge the online leaderboards in Score Attack mode!
Play with a friend in online CO-OP play!
The shooter classic "Guwange" is reborn for a new generation!</live:description>
      <live:gameCapabilities>
        <live:offlinePlayersMin>2</live:offlinePlayersMin>
        <live:offlinePlayersMax>2</live:offlinePlayersMax>
        <live:offlineCoopPlayersMin>2</live:offlineCoopPlayersMin>
        <live:offlineCoopPlayersMax>2</live:offlineCoopPlayersMax>
        <live:onlineMultiplayerMin>2</live:onlineMultiplayerMin>
        <live:onlineMultiplayerMax>2</live:onlineMultiplayerMax>
        <live:onlineCoopPlayersMin>2</live:onlineCoopPlayersMin>
        <live:onlineCoopPlayersMax>2</live:onlineCoopPlayersMax>
        <live:onlineLeaderboards>1</live:onlineLeaderboards>
      </live:gameCapabilities>
      <live:offerCounts>
        <live:offerCount>
          <live:targetMediaType>23</live:targetMediaType>
          <live:totalOfferCount>1</live:totalOfferCount>
          <live:userCounts>
            <live:userCount>
              <live:userType>2</live:userType>
              <live:offerCount>1</live:offerCount>
            </live:userCount>
            <live:userCount>
              <live:userType>3</live:userType>
              <live:offerCount>1</live:offerCount>
            </live:userCount>
          </live:userCounts>
        </live:offerCount>
      </live:offerCounts>
      <live:ratingAggregate>3.75</live:ratingAggregate>
      <live:numberOfRatings>1567</live:numberOfRatings>
    </live:media>
    <live:categories>
      <live:category>
        <live:categoryId>3000</live:categoryId>
        <live:system>3000</live:system>
        <live:name>Game Genres</live:name>
      </live:category>
      <live:category>
        <live:categoryId>3011</live:categoryId>
        <live:system>3000</live:system>
        <live:name>Shooter</live:name>
      </live:category>
      <live:category>
        <live:categoryId>3019</live:categoryId>
        <live:system>3000</live:system>
        <live:name>Classics</live:name>
      </live:category>
      <live:category>
        <live:categoryId>3027</live:categoryId>
        <live:system>3000</live:system>
        <live:name>Xbox LIVE Games</live:name>
      </live:category>
    </live:categories>
    <live:slideShows>
      <live:slideShow>
        <live:image>
          <live:imageMediaId>urn:uuid:B9042203-201B-40E4-AA02-03E1BF4EDB30</live:imageMediaId>
          <live:imageMediaInstanceId>urn:uuid:4942CE57-28AD-4D78-A73C-F98D9AD04761</live:imageMediaInstanceId>
          <live:imageMediaType>14</live:imageMediaType>
          <live:format>4</live:format>
          <live:size>27</live:size>
          <live:fileUrl>https://download.xbox.com/content/images/66acd000-77fe-1000-9115-d80258410a78/1033/screenlg1.jpg</live:fileUrl>
        </live:image>
        <live:image>
          <live:imageMediaId>urn:uuid:8C77A339-AFE8-4BE2-8BD9-E7A5F6D9B555</live:imageMediaId>
          <live:imageMediaInstanceId>urn:uuid:9A642CA6-C60D-46DD-AFAF-699FA3532CE4</live:imageMediaInstanceId>
          <live:imageMediaType>14</live:imageMediaType>
          <live:format>4</live:format>
          <live:size>27</live:size>
          <live:fileUrl>https://download.xbox.com/content/images/66acd000-77fe-1000-9115-d80258410a78/1033/screenlg2.jpg</live:fileUrl>
        </live:image>
        <live:image>
          <live:imageMediaId>urn:uuid:E1C72F77-2653-431B-A8D5-6350F951F83E</live:imageMediaId>
          <live:imageMediaInstanceId>urn:uuid:966DE45D-3807-44D7-8F00-EF50F2B87EED</live:imageMediaInstanceId>
          <live:imageMediaType>14</live:imageMediaType>
          <live:format>4</live:format>
          <live:size>27</live:size>
          <live:fileUrl>https://download.xbox.com/content/images/66acd000-77fe-1000-9115-d80258410a78/1033/screenlg3.jpg</live:fileUrl>
        </live:image>
        <live:image>
          <live:imageMediaId>urn:uuid:D2322AEA-5BAA-401D-B45C-0E92BD5EEA9B</live:imageMediaId>
          <live:imageMediaInstanceId>urn:uuid:EB22A3B7-3F03-4BBC-BFAC-A9F81EBBFB45</live:imageMediaInstanceId>
          <live:imageMediaType>14</live:imageMediaType>
          <live:format>4</live:format>
          <live:size>27</live:size>
          <live:fileUrl>https://download.xbox.com/content/images/66acd000-77fe-1000-9115-d80258410a78/1033/screenlg4.jpg</live:fileUrl>
        </live:image>
        <live:image>
          <live:imageMediaId>urn:uuid:ED6CDA8A-D1C3-415C-81BD-543A387AC81D</live:imageMediaId>
          <live:imageMediaInstanceId>urn:uuid:91BE41A7-BBF7-4F61-84C1-0D314D14994B</live:imageMediaInstanceId>
          <live:imageMediaType>14</live:imageMediaType>
          <live:format>4</live:format>
          <live:size>27</live:size>
          <live:fileUrl>https://download.xbox.com/content/images/66acd000-77fe-1000-9115-d80258410a78/1033/screenlg5.jpg</live:fileUrl>
        </live:image>
        <live:image>
          <live:imageMediaId>urn:uuid:0A4FE2A7-5B03-402E-A2B4-7536B26D5736</live:imageMediaId>
          <live:imageMediaInstanceId>urn:uuid:3487FCF8-EA75-4C60-BE0E-B54D57E60CD3</live:imageMediaInstanceId>
          <live:imageMediaType>14</live:imageMediaType>
          <live:format>4</live:format>
          <live:size>27</live:size>
          <live:fileUrl>https://download.xbox.com/content/images/66acd000-77fe-1000-9115-d80258410a78/1033/screenlg6.jpg</live:fileUrl>
        </live:image>
        <live:image>
          <live:imageMediaId>urn:uuid:8356EC3C-D571-4611-B51E-AACBCD0F2893</live:imageMediaId>
          <live:imageMediaInstanceId>urn:uuid:D2779990-CD75-45D1-A756-33BBC58ED260</live:imageMediaInstanceId>
          <live:imageMediaType>14</live:imageMediaType>
          <live:format>4</live:format>
          <live:size>27</live:size>
          <live:fileUrl>https://download.xbox.com/content/images/66acd000-77fe-1000-9115-d80258410a78/1033/screenlg7.jpg</live:fileUrl>
        </live:image>
      </live:slideShow>
    </live:slideShows>
  </entry>
  </feed>

For testing purposes, I build an extremely raw WPF-based testing client where I am able to set the parameters and execute various queries with altered values.

Image lost since old blog migration.

Because of its unfinished state, I am not publishing it right now but you can see that I can get a lot of game-related data if I form the query correctly. This data includes:

  • Total number of items in the Game Marketplace that can be queried.
  • Total items on the current page
  • Last time the game data (per single title) was updated
  • The game title
  • Short description
  • Availability date
  • Release date
  • Rating information
  • Developer
  • Publisher
  • Offers related to the title
  • Full description
  • Game capabilities, that include number of players in offline, online and coop modes (if present)
  • Genres, under which the title falls
  • Images (box art)
  • Images (screenshots, also known as slideshow entities)

But let’s say you don’t want to query the entire service data on all games, and you only need titles that follow a specific criteria. Here is a list of service endpoints that might be suitable for various needs:

By Type

New Games:

1
2
3
4
5
6
7
8
https://catalog-cdn.xboxlive.com/Catalog/Catalog.asmx/Query?methodName=FindGames&Names=Locale&Values=en-US&Names=LegalLocale&Values=en-US&
Names=Store&Values=1&Names=PageSize&Values=30&Names=PageNum&Values=1&Names=DetailView&Values=3&
Names=AvatarBodyTypes&Values=3&Names=AvatarBodyTypes&Values=1&Names=OrderDirection&Values=2&
Names=OfferFilterLevel&Values=2&Names=MediaTypes&Values=1&Names=MediaTypes&Values=21&
Names=MediaTypes&Values=23&Names=OrderBy&Values=21&Names=ImageFormats&Values=4&
Names=ImageSizes&Values=23&Names=ImageSizes&Values=30&Names=OfferTargetMediaTypes&
Values=1&Names=OfferTargetMediaTypes&Values=21&Names=OfferTargetMediaTypes&Values=23&
Names=CategoryIds&Values=3027&Names=UserTypes&Values=2&Names=UserTypes&Values=3

Demos:

1
2
3
4
5
6
https://catalog-cdn.xboxlive.com/Catalog/Catalog.asmx/Query?methodName=FindGames&Names=Locale&Values=en-US&Names=LegalLocale&Values=en-US&
Names=Store&Values=1&Names=PageSize&Values=100&Names=PageNum&Values=1&Names=DetailView&Values=3&
Names=AvatarBodyTypes&Values=3&Names=AvatarBodyTypes&Values=1&Names=OrderDirection&Values=2&
Names=MediaTypes&Values=19&Names=OrderBy&Values=21&Names=ImageFormats&Values=4&
Names=OfferFilterLevel&Values=2&Names=ImageSizes&Values=23&Names=OfferTargetMediaTypes&Values=19&
Names=UserTypes&Values=2&Names=UserTypes&Values=3

Arcade Games:

1
2
3
4
5
6
https://catalog-cdn.xboxlive.com/Catalog/Catalog.asmx/Query?methodName=FindGames&Names=Locale&Values=en-US&Names=LegalLocale&Values=en-US&
Names=Store&Values=1&Names=PageSize&Values=100&Names=PageNum&Values=1&Names=DetailView&Values=3&
Names=AvatarBodyTypes&Values=3&Names=AvatarBodyTypes&Values=1&Names=OrderDirection&Values=2&
Names=CategoryIDs&Values=3027&Names=MediaTypes&Values=23&Names=OrderBy&Values=21&
Names=ImageFormats&Values=4&Names=OfferFilterLevel&Values=2&Names=ImageSizes&Values=23&
Names=OfferTargetMediaTypes&Values=23&Names=UserTypes&Values=2&Names=UserTypes&Values=3

Games on Demand:

1
2
3
4
5
6
7
https://catalog-cdn.xboxlive.com/Catalog/Catalog.asmx/Query?methodName=FindGames&Names=Locale&Values=en-US&Names=LegalLocale&Values=en-US&
Names=Store&Values=1&Names=PageSize&Values=100&Names=PageNum&Values=1&Names=DetailView&Values=3&
Names=AvatarBodyTypes&Values=3&Names=AvatarBodyTypes&Values=1&Names=OrderDirection&Values=2&
Names=CategoryIDs&Values=3027&Names=MediaTypes&Values=1&Names=MediaTypes&Values=21&
Names=OrderBy&Values=21&Names=ImageFormats&Values=4&Names=OfferFilterLevel&Values=2&
Names=ImageSizes&Values=23&Names=OfferTargetMediaTypes&Values=1&Names=OfferTargetMediaTypes&
Values=21&Names=UserTypes&Values=2&Names=UserTypes&Values=3

Indie Games:

1
2
3
4
5
6
https://catalog-cdn.xboxlive.com/Catalog/Catalog.asmx/Query?methodName=FindGames&Names=Locale&Values=en-US&Names=LegalLocale&Values=en-US&
Names=Store&Values=1&Names=PageSize&Values=100&Names=PageNum&Values=1&Names=DetailView&Values=3&
Names=AvatarBodyTypes&Values=3&Names=AvatarBodyTypes&Values=1&Names=OrderDirection&Values=2&
Names=MediaTypes&Values=37&Names=OrderBy&Values=21&Names=ImageFormats&Values=4&
Names=OfferFilterLevel&Values=2&Names=ImageSizes&Values=23&
Names=OfferTargetMediaTypes&Values=37&Names=UserTypes&Values=2&Names=UserTypes&Values=3

Videos:

1
2
3
4
5
6
7
https://catalog-cdn.xboxlive.com/Catalog/Catalog.asmx/Query?methodName=FindGames&Names=Locale&Values=en-US&Names=LegalLocale&Values=en-US&
Names=Store&Values=1&Names=PageSize&Values=100&Names=PageNum&Values=1&Names=DetailView&Values=3&
Names=AvatarBodyTypes&Values=3&Names=AvatarBodyTypes&Values=1&Names=OrderDirection&Values=2&
Names=MediaTypes&Values=30&Names=MediaTypes&Values=34&Names=OrderBy&Values=21&
Names=ImageFormats&Values=4&Names=OfferFilterLevel&Values=2&Names=ImageSizes&Values=23&
Names=OfferTargetMediaTypes&Values=30&Names=OfferTargetMediaTypes&Values=34&
Names=UserTypes&Values=2&Names=UserTypes&Values=3

Add-Ons:

1
2
3
4
5
6
https://catalog-cdn.xboxlive.com/Catalog/Catalog.asmx/Query?methodName=FindGames&Names=Locale&Values=en-US&Names=LegalLocale&Values=en-US&
Names=Store&Values=1&Names=PageSize&Values=100&Names=PageNum&Values=1&Names=DetailView&Values=3&
Names=AvatarBodyTypes&Values=3&Names=AvatarBodyTypes&Values=1&Names=OrderDirection&Values=2&
Names=MediaTypes&Values=18&Names=OrderBy&Values=21&Names=ImageFormats&Values=4&
Names=OfferFilterLevel&Values=2&Names=ImageSizes&Values=23&Names=OfferTargetMediaTypes&Values=18&
Names=UserTypes&Values=2&Names=UserTypes&Values=3

Themes:

1
2
3
4
5
6
https://catalog-cdn.xboxlive.com/Catalog/Catalog.asmx/Query?methodName=FindGames&Names=Locale&Values=en-US&Names=LegalLocale&Values=en-US&
Names=Store&Values=1&Names=PageSize&Values=100&Names=PageNum&Values=1&Names=DetailView&Values=3&
Names=AvatarBodyTypes&Values=3&Names=AvatarBodyTypes&Values=1&Names=OrderDirection&Values=2&
Names=MediaTypes&Values=20&Names=OrderBy&Values=21&Names=ImageFormats&Values=4&
Names=OfferFilterLevel&Values=2&Names=ImageSizes&Values=23&Names=OfferTargetMediaTypes&Values=20&
Names=UserTypes&Values=2&Names=UserTypes&Values=3

Gamerpics:

1
2
3
4
5
6
https://catalog-cdn.xboxlive.com/Catalog/Catalog.asmx/Query?methodName=FindGames&Names=Locale&Values=en-US&Names=LegalLocale&Values=en-US&
Names=Store&Values=1&Names=PageSize&Values=100&Names=PageNum&Values=1&Names=DetailView&Values=3&
Names=AvatarBodyTypes&Values=3&Names=AvatarBodyTypes&Values=1&Names=OrderDirection&Values=2&
Names=MediaTypes&Values=22&Names=OrderBy&Values=21&Names=ImageFormats&Values=4&
Names=OfferFilterLevel&Values=2&Names=ImageSizes&Values=23&
Names=OfferTargetMediaTypes&Values=22&Names=UserTypes&Values=2&Names=UserTypes&Values=3

By Genre

Arcade Games:

1
2
3
4
5
6
7
https://catalog-cdn.xboxlive.com/Catalog/Catalog.asmx/Query?methodName=FindGames&Names=Locale&Values=en-US&Names=LegalLocale&Values=en-US&
Names=Store&Values=1&Names=PageSize&Values=100&Names=PageNum&Values=1&Names=DetailView&Values=3&
Names=AvatarBodyTypes&Values=3&Names=AvatarBodyTypes&Values=1&Names=OrderDirection&Values=2&
Names=MediaTypes&Values=1&Names=MediaTypes&Values=21&Names=MediaTypes&Values=23&
Names=OrderBy&Values=21&Names=CategoryIds&Values=3002&Names=OfferFilterLevel&Values=2&
Names=ImageSizes&Values=23&Names=ImageFormats&Values=4&Names=UserTypes&Values=2&
Names=UserTypes&Values=3

Card & Board:

1
2
3
4
5
6
7
https://catalog-cdn.xboxlive.com/Catalog/Catalog.asmx/Query?methodName=FindGames&Names=Locale&Values=en-US&Names=LegalLocale&Values=en-US&
Names=Store&Values=1&Names=PageSize&Values=100&Names=PageNum&Values=1&Names=DetailView&Values=3&
Names=AvatarBodyTypes&Values=3&Names=AvatarBodyTypes&Values=1&Names=OrderDirection&Values=2&
Names=MediaTypes&Values=1&Names=MediaTypes&Values=21&Names=MediaTypes&Values=23&
Names=OrderBy&Values=21&Names=CategoryIds&Values=3018&Names=OfferFilterLevel&Values=2&
Names=ImageSizes&Values=23&Names=ImageFormats&Values=4&
Names=UserTypes&Values=2&Names=UserTypes&Values=3

Classics:

1
2
3
4
5
6
7
https://catalog-cdn.xboxlive.com/Catalog/Catalog.asmx/Query?methodName=FindGames&Names=Locale&Values=en-US&Names=LegalLocale&Values=en-US&
Names=Store&Values=1&Names=PageSize&Values=100&Names=PageNum&Values=1&Names=DetailView&Values=3&
Names=AvatarBodyTypes&Values=3&Names=AvatarBodyTypes&Values=1&Names=OrderDirection&Values=2&
Names=MediaTypes&Values=1&Names=MediaTypes&Values=21&Names=MediaTypes&Values=23&
Names=OrderBy&Values=21&Names=CategoryIds&Values=3019&Names=OfferFilterLevel&Values=2&
Names=ImageSizes&Values=23&Names=ImageFormats&Values=4&Names=UserTypes&Values=2&
Names=UserTypes&Values=3

Family:

1
2
3
4
5
6
7
https://catalog-cdn.xboxlive.com/Catalog/Catalog.asmx/Query?methodName=FindGames&Names=Locale&Values=en-US&Names=LegalLocale&Values=en-US&
Names=Store&Values=1&Names=PageSize&Values=100&Names=PageNum&Values=1&
Names=DetailView&Values=3&Names=AvatarBodyTypes&Values=3&Names=AvatarBodyTypes&Values=1&
Names=OrderDirection&Values=2&Names=MediaTypes&Values=1&Names=MediaTypes&Values=21&
Names=MediaTypes&Values=23&Names=OrderBy&Values=21&Names=CategoryIds&Values=3005&
Names=OfferFilterLevel&Values=2&Names=ImageSizes&Values=23&Names=ImageFormats&Values=4&
Names=UserTypes&Values=2&Names=UserTypes&Values=3

Fighting:

1
2
3
4
5
6
7
https://catalog-cdn.xboxlive.com/Catalog/Catalog.asmx/Query?methodName=FindGames&Names=Locale&Values=en-US&Names=LegalLocale&Values=en-US&
Names=Store&Values=1&Names=PageSize&Values=100&Names=PageNum&Values=1&Names=DetailView&Values=3&
Names=AvatarBodyTypes&Values=3&Names=AvatarBodyTypes&Values=1&Names=OrderDirection&Values=2&
Names=MediaTypes&Values=1&Names=MediaTypes&Values=21&Names=MediaTypes&Values=23&
Names=OrderBy&Values=21&Names=CategoryIds&Values=3006&Names=OfferFilterLevel&Values=2&
Names=ImageSizes&Values=23&Names=ImageFormats&Values=4&Names=UserTypes&Values=2&
Names=UserTypes&Values=3

Music:

1
2
3
4
5
6
7
https://catalog-cdn.xboxlive.com/Catalog/Catalog.asmx/Query?methodName=FindGames&Names=Locale&Values=en-US&Names=LegalLocale&Values=en-US&
Names=Store&Values=1&Names=PageSize&Values=100&Names=PageNum&Values=1&Names=DetailView&Values=3&
Names=AvatarBodyTypes&Values=3&Names=AvatarBodyTypes&Values=1&
Names=OrderDirection&Values=2&Names=MediaTypes&Values=1&Names=MediaTypes&Values=21&
Names=MediaTypes&Values=23&Names=OrderBy&Values=21&Names=CategoryIds&Values=3007&
Names=OfferFilterLevel&Values=2&Names=ImageSizes&Values=23&Names=ImageFormats&Values=4&
Names=UserTypes&Values=2&Names=UserTypes&Values=3

Platformer:

1
2
3
4
5
6
https://catalog-cdn.xboxlive.com/Catalog/Catalog.asmx/Query?methodName=FindGames&Names=Locale&Values=en-US&Names=LegalLocale&Values=en-US&
Names=Store&Values=1&Names=PageSize&Values=100&Names=PageNum&Values=1&Names=DetailView&Values=3&
Names=AvatarBodyTypes&Values=3&Names=AvatarBodyTypes&Values=1&Names=OrderDirection&Values=2&
Names=MediaTypes&Values=1&Names=MediaTypes&Values=21&Names=MediaTypes&Values=23&Names=OrderBy&Values=21
Names=CategoryIds&Values=3008&Names=OfferFilterLevel&Values=2&Names=ImageSizes&Values=23&
Names=ImageFormats&Values=4&Names=UserTypes&Values=2&Names=UserTypes&Values=3

Puzzle & Trivia:

1
2
3
4
5
6
7
8
https://catalog-cdn.xboxlive.com/Catalog/Catalog.asmx/Query?methodName=FindGames&Names=Locale&Values=en-US&Names=LegalLocale&Values=en-US&
Names=Store&Values=1&Names=PageSize&Values=100&Names=PageNum&Values=1&
Names=DetailView&Values=3&Names=AvatarBodyTypes&Values=3&
Names=AvatarBodyTypes&Values=1&Names=OrderDirection&Values=2&
Names=MediaTypes&Values=1&Names=MediaTypes&Values=21&
Names=MediaTypes&Values=23&Names=OrderBy&Values=21&Names=CategoryIds&Values=3022&
Names=OfferFilterLevel&Values=2&Names=ImageSizes&Values=23&Names=ImageFormats&Values=4&
Names=UserTypes&Values=2&Names=UserTypes&Values=3

Racing & Flying:

1
2
3
4
5
6
7
https://catalog-cdn.xboxlive.com/Catalog/Catalog.asmx/Query?methodName=FindGames&Names=Locale&Values=en-US&Names=LegalLocale&Values=en-US&
Names=Store&Values=1&Names=PageSize&Values=100&Names=PageNum&Values=1&Names=DetailView&Values=3&
Names=AvatarBodyTypes&Values=3&Names=AvatarBodyTypes&Values=1&Names=OrderDirection&Values=2&
Names=MediaTypes&Values=1&Names=MediaTypes&Values=21&Names=MediaTypes&Values=23&
Names=OrderBy&Values=21&Names=CategoryIds&Values=3009&Names=OfferFilterLevel&Values=2&
Names=ImageSizes&Values=23&Names=ImageFormats&Values=4&
Names=UserTypes&Values=2&Names=UserTypes&Values=3

Role Playing:

1
2
3
4
5
6
7
https://catalog-cdn.xboxlive.com/Catalog/Catalog.asmx/Query?methodName=FindGames&Names=Locale&Values=en-US&Names=LegalLocale&Values=en-US&
Names=Store&Values=1&Names=PageSize&Values=100&Names=PageNum&Values=1&Names=DetailView&Values=3&
Names=AvatarBodyTypes&Values=3&Names=AvatarBodyTypes&Values=1&Names=OrderDirection&Values=2&
Names=MediaTypes&Values=1&Names=MediaTypes&Values=21&Names=MediaTypes&Values=23&
Names=OrderBy&Values=21&Names=CategoryIds&Values=3010&Names=OfferFilterLevel&Values=2&
Names=ImageSizes&Values=23&Names=ImageFormats&Values=4&
Names=UserTypes&Values=2&Names=UserTypes&Values=3

Shooter:

1
2
3
4
5
6
7
https://catalog-cdn.xboxlive.com/Catalog/Catalog.asmx/Query?methodName=FindGames&Names=Locale&Values=en-US&Names=LegalLocale&Values=en-US&
Names=Store&Values=1&Names=PageSize&Values=100&Names=PageNum&Values=1&
Names=DetailView&Values=3&Names=AvatarBodyTypes&Values=3&Names=AvatarBodyTypes&Values=1&
Names=OrderDirection&Values=2&Names=MediaTypes&Values=1&Names=MediaTypes&Values=21&
Names=MediaTypes&Values=23&Names=OrderBy&Values=21&Names=CategoryIds&Values=3011&
Names=OfferFilterLevel&Values=2&Names=ImageSizes&Values=23&Names=ImageFormats&Values=4&
Names=UserTypes&Values=2&Names=UserTypes&Values=3

Sports & Recreation:

1
2
3
4
5
6
7
https://catalog-cdn.xboxlive.com/Catalog/Catalog.asmx/Query?methodName=FindGames&Names=Locale&Values=en-US&Names=LegalLocale&Values=en-US&
Names=Store&Values=1&Names=PageSize&Values=100&Names=PageNum&Values=1&
Names=DetailView&Values=3&Names=AvatarBodyTypes&Values=3&Names=AvatarBodyTypes&Values=1&
Names=OrderDirection&Values=2&Names=MediaTypes&Values=1&Names=MediaTypes&Values=21&
Names=MediaTypes&Values=23&Names=OrderBy&Values=21&Names=CategoryIds&Values=3013&
Names=OfferFilterLevel&Values=2&Names=ImageSizes&Values=23&Names=ImageFormats&Values=4&
Names=UserTypes&Values=2&Names=UserTypes&Values=3

Strategy & Simulation:

1
2
3
4
5
6
7
https://catalog-cdn.xboxlive.com/Catalog/Catalog.asmx/Query?methodName=FindGames&Names=Locale&Values=en-US&Names=LegalLocale&Values=en-US&
Names=Store&Values=1&Names=PageSize&Values=100&Names=PageNum&Values=1&Names=DetailView&Values=3&
Names=AvatarBodyTypes&Values=3&Names=AvatarBodyTypes&Values=1&Names=OrderDirection&Values=2&
Names=MediaTypes&Values=1&Names=MediaTypes&Values=21&Names=MediaTypes&Values=23&
Names=OrderBy&Values=21&Names=CategoryIds&Values=3012&Names=OfferFilterLevel&Values=2&
Names=ImageSizes&Values=23&Names=ImageFormats&Values=4&
Names=UserTypes&Values=2&Names=UserTypes&Values=3

Other:

1
2
3
4
5
6
https://catalog-cdn.xboxlive.com/Catalog/Catalog.asmx/Query?methodName=FindGames&Names=Locale&Values=en-US&Names=LegalLocale&Values=en-US&Names=Store&Values=1&Names=PageSize&Values=100&Names=PageNum&Values=1&
Names=DetailView&Values=3&Names=AvatarBodyTypes&Values=3&Names=AvatarBodyTypes&Values=1&
Names=OrderDirection&Values=2&Names=MediaTypes&Values=1&Names=MediaTypes&Values=21&
Names=MediaTypes&Values=23&Names=OrderBy&Values=21&Names=CategoryIds&Values=3001&
Names=OfferFilterLevel&Values=2&Names=ImageSizes&Values=23&Names=ImageFormats&Values=4&
Names=UserTypes&Values=2&Names=UserTypes&Values=3

By Title (Alphabetical)

Service URL:

1
2
3
4
5
6
https://catalog-cdn.xboxlive.com/Catalog/Catalog.asmx/Query?methodName=FindGames&Names=Locale&Values=en-US&Names=LegalLocale&Values=en-US&Names=Store&Values=1&Names=PageSize&Values=100&Names=PageNum&Values=1&Names=DetailView&Values=3&
Names=AvatarBodyTypes&Values=3&Names=AvatarBodyTypes&Values=1&Names=UserTypes&Values=2&Names=UserTypes&Values=3&
Names=MediaTypes&Values=1&Names=MediaTypes&Values=21&Names=MediaTypes&Values=23&Names=ImageFormats&Values=4&
Names=ImageFormats&Values=5&Names=ImageSizes&Values=14&Names=ImageSizes&Values=15&Names=ImageSizes&Values=23&
Names=OrderBy&Values=1&Names=OrderDirection&Values=1&Names=OfferFilterLevel&Values=2&Names=CategoryIds&Values=3027&
Names=TitleFilters&Values=A

Notice the TitleFilters parameter at the end. Its value is the letter you want to filter by.

For all the service queries I listed above the page size (represented by the PageSize parameter) is set to 100. You can change that parameter according to your own needs.

Remember that all endpoints listed here are used as a catalog and a download service. You cannot download any of the listed content by knowing the information returned by respective feeds. You should not even attempt to do so, by the way, since it is illegal.

Stay tuned for the release of the XBL Game Marketplace query client!

Subscribe to The Den:

A monthly newsletter about technology, machine learning, security, and just tinkering with code.

Feedback

Have any thoughts? Let me know on Twitter!