GET (media/{marketplaceId}/singleMediaGroupSearch)
Allows search for items within a single media group.
The domain for these URIs is eds.xboxlive.com.
Remarks
Pages of data returned from this search can be accessed non-sequentially using the skipItems parameter instead of using the continuation token. This API accepts Query Refiners.
SandboxId is now retrieved from the claim in the XToken and enforced. If the SandboxId is not present, then Entertainment Discovery Services (EDS) will throw a 400 Bad request error.
URI parameters
| Parameter | Type | Description |
|---|---|---|
| marketplaceId | string | Required. String value obtained from the Windows.Xbox.ApplicationModel.Store.Configuration.MarketplaceId. |
Query string parameters
This API accepts the following query parameters: combinedContentRating, desiredMediaItemTypes, fields, maxItems, preferredProvider, q, queryRefiners, skipItems, firstPartyOnly, freeOnly, hasTrailer, latestOnly, subscriptionLevel, and topRatedOnly.
See EDS Parameters for more information on these parameters.
Response body
Sample response
The JSON code below is in response to the call /media/en-us/singleMediaGroupSearch?q=vector&desiredMediaItemTypes=DGame&fields=all.
{
"Items": [{
"MediaGroup": "GameType",
"MediaItemType": "DGame",
"ID": "fd16e2fb-eca4-4182-8f69-a98fdd6e57a1",
"Name": "Vector based massively multiplayer Tanks game.",
"ReducedName": "Tanks",
"ReleaseDate": "2013-03-15T00: 00: 00Z",
"TitleId": "69A60C76",
"VuiDisplayName": "Tanks",
"DeveloperName": "Microsoft Studios",
"Images": [{
"ID": "32ebd9fe-6a22-4111-954e-564ec69d802a",
"ResizeUrl": "http: //images-eds.dnet.xboxlive.com/image?url=RIJNAEIo6.u.tudW9rXJ2lWDOsMikqfNiHE2Sp4qbgNbH6_drY8Ek2cyHXEnnUKPUXAH_m8a3Oe4_wpV7CkKA0Snc9puIYOGxsIfyyncTBv.MIluDZX6UqAPsJYHE5go_J_BBfxNWW6yrK4.K75aMQ--",
"Purposes": ["Box_Art"],
"Purpose": "Box_Art",
"Height": 300,
"Width": 219,
"Order": 1
},
{
"ID": "32ebd9fe-6a22-4111-954e-564ec69d802a",
"ResizeUrl": "http: //images-eds.dnet.xboxlive.com/image?url=RIJNAEIo6.u.tudW9rXJ2lWDOsMikqfNiHE2Sp4qbgNbH6_drY8Ek2cyHXEnnUKPUXAH_m8a3Oe4_wpV7CkKA0Snc9puIYOGxsIfyyncTBv.MIluDZX6UqAPsJYHE5go_J_BBfxNWW6yrK4.K75aMQ--",
"Purposes": ["Box_Art"],
"Purpose": "Box_Art",
"Height": 120,
"Width": 85,
"Order": 1
},
{
"ID": "32ebd9fe-6a22-4111-954e-564ec69d802a",
"ResizeUrl": "http: //images-eds.dnet.xboxlive.com/image?url=RIJNAEIo6.u.tudW9rXJ2lWDOsMikqfNiHE2Sp4qbgNbH6_drY8Ek2cyHXEnnUKPUXAH_m8a3Oe4_wpV7CkKA0Snc9puIYOGxsIfyyncTBv.MIluDZX6UqAPsJYHE5go_J_BBfxNWW6yrK4.K75aMQ--",
"Purposes": ["Image"],
"Purpose": "Image",
"Height": 720,
"Width": 1280,
"Order": 1
}],
"PublisherName": "Microsoft Studios",
"RatingId": "10",
"ParentalRating": "E",
"ParentalRatingSystem": "ESRB",
"SortName": "\n Vector based massively multiplayer Tanks game.\n ",
"Capabilities": [{
"NonLocalizedName": "onlineMultiplayerMin",
"Value": "3"
},
{
"NonLocalizedName": "onelineMultiplayerMax",
"Value": "5"
}],
"KValue": "4",
"KValueNamespace": "bingbox",
"AllTimePlayCount": 30.0,
"SevenDaysPlayCount": 30.0,
"ThirtyDaysPlayCount": 30.0,
"AllTimeRatingCount": 12.0,
"ThirtyDaysRatingCount": 12.0,
"SevenDaysRatingCount": 12.0,
"AllTimeAverageRating": 0.8,
"ThirtyDaysAverageRating": 0.8,
"SevenDaysAverageRating": 0.8,
"LegacyIds": [{
"IdType": "TitleId",
"Value": "69A60C76"
}],
"Availabilities": [{
"AvailabilityID": "",
"ContentId": "7AE9DAB2-1162-488D-9F80-B804EC5AF879",
"Devices": [{
"Name": "Durango"
}]
}],
"Packages": [{
"CdnFileLocation": [{
"SortOrder": null,
"Uri": "https: //update.dnet.xboxlive.com/test_cdn/tanks-randomkey.xvc"
},
{
"SortOrder": null,
"Uri": "https: //update.dnet.xboxlive.com/test_cdn/tanks-randomkey.xvc"
},
{
"SortOrder": null,
"Uri": "https: //update.dnet.xboxlive.com/test_cdn/tanks-randomkey.xvc"
}],
"ContentId": "7AE9DAB2-1162-488D-9F80-B804EC5AF879",
"PackageType": "XVC",
"LicenseType": "Xbox Live Games Machine and User"
}],
"SandboxId": "PART.Dev1"
}],
"ImpressionGuid": "840bae05-776e-4429-b522-e64543ac3a35"
}
See also
Parent
/media/{marketplaceId}/singleMediaGroupSearch