marketplace

Get game details

Returns detailed information for specified product IDs (comma-separated).

Response Structure:

content: Product details from Microsoft's catalog API
code: HTTP status code from upstream (200 = success, 400 = invalid IDs, 500 = upstream error)

Finding the Xbox Title ID

Each product includes an AlternateIds array, and the Xbox title ID is the entry with IdType: "XboxTitleId":

"AlternateIds": [
  { "IdType": "LegacyWindowsStoreProductId", "Value": "d9c4f2f1-b701-4456-881b-4a434dcc8c3a" },
  { "IdType": "XboxTitleId", "Value": "2083118773" },
  { "IdType": "LegacyXboxProductId", "Value": "33564e39-324c-3033-c034-564758442e00" }
]

That Value is what the achievements, stats and title history endpoints expect.

Responses are large (roughly 45 KB per product). For just the title ID, use GET /v2/marketplace/titleid/{productId}, or GET /v2/marketplace/search?q=...&enrich=titleid to resolve a whole result set at once.

Not every product has one. Add-ons, bundles and PC-only listings have no XboxTitleId entry. Note also that a game and its demo are separate products with different title IDs, and that some games have both a PC and an Xbox listing where only the Xbox one carries a title ID.

post/v2/marketplace/details

Request body

productsstring required

Response

Game details

{"stackTrail":"components:schemas:ApiResponse:properties:content","oasType":"schema","type":"unknown","description":"The response payload from the upstream Xbox/Microsoft API. The structure varies by endpoint - can be an object, array, or string."}

codeinteger required

HTTP status code from the upstream API. Common values: 200 (success), 400 (bad request), 401 (unauthorized), 404 (not found), 410 (deprecated/gone), 429 (rate limited), 500 (server error)

Example response

{
  "code": 200
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.