marketplace

Search games (strict title match)

Strict title search. Returns only genuine matches, with none of the recommendation padding that GET /v2/marketplace/search produces.

Searching REPLACED here returns exactly two products - the game and its demo - where the standard search returns 20 results, 18 of which are unrelated.

When to use this instead of /marketplace/search

Use autosuggest when you know the title and want the product ID for it. Use search when you want browsing-style results with prices, ratings, images and pagination.

This is a different upstream endpoint, not a flag on the existing search, so the response shape differs: results are grouped under Results[].Products[] rather than Payload.SearchResults. Matching is on the start of the title.

Getting a title ID

Results carry a ProductId. To turn that into an Xbox title ID use GET /v2/marketplace/titleid/{productId}.

get/v2/marketplace/autosuggest

Query parameters

qstring required

Title to match

marketstring

Two-letter market code. Defaults to US.

productFamilyNamesstring

Comma-separated families, e.g. Games,Apps. Defaults to Games.

Response

Matching products

{"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.