Microsoft Store API

The XBXprices Microsoft Store API gives developers programmatic access to Xbox game data in clean, easy-to-use JSON: current Xbox Series X|S and Xbox One prices, full price history, live sales and discounts, and detailed achievement information – across 47 Microsoft Store regions. It returns exactly the same data shown throughout XBXprices, so it is always kept up to date.

• Microsoft Store API
• Xbox Series X|S & Xbox One prices
• Price history
• Sales & discounts
• Achievement & Gamerscore data
• 47 regions
• JSON

What the Microsoft Store API provides

Start free with 1,000 requests a month – no card required. Upgrade any time as your usage grows; limits are counted per calendar month (UTC), and every response includes your live quota in the X-RateLimit-Remaining header and meta.rate_limit. List endpoints (/games, /deals) return up to your plan’s page size per request — 25 on Free, up to 200 on Business — so a single request can fetch many titles at once.

Need more than 500,000 requests a month, a full multi-region mirror, or a custom price-history export? Talk to us – we’re happy to tailor a plan. After subscribing, your API key is emailed to you – see the welcome note for how to claim it.

API Terms of Use. Use the API in your apps, sites, dashboards, analytics and user-facing alerts. Commercial use requires a paid plan — the Free plan is for evaluation and non-commercial projects only. You may not use the API to build a directly competing price-tracking service, resell or redistribute the raw data, bulk-archive data beyond your plan’s limits and history window, or scrape platprices.com to get around those limits. Plans where attribution is required must show “Powered by XBXprices” with a link wherever the data is displayed publicly. Keys that violate these terms may be throttled or revoked. Questions about a use case? Just ask.

1. Apply for a key  ·  2. Send it in the X-API-Key header  ·  3. Read JSON. That’s it – no SDK required.

# A game's price & achievement data (US store)
curl -H "X-API-Key: $PP_KEY" "/api/v2/games/7704?region=us"

# Everything discounted in the UK in the last 48 hours, biggest first
curl -H "X-API-Key: $PP_KEY" "/api/v2/deals?region=gb&sort=discount&order=desc"

No key yet? Open the keyless /api/v2/demo straight in your browser to see the exact data shape. To get a key, fill in the short request form – tell us about your project and which data you need, and we’ll set you up (usually within 1–2 business days).

The full v2 reference documents every endpoint, query parameter, response field and error code, with copy-paste examples in curl, JavaScript, Python and PHP. → Read the v2 reference.

The v2 API is REST + JSON. The base URL is /api/v2, and every request carries your key in the X-API-Key header. These are the endpoints most integrations start with — the full reference documents every parameter and field for each.

What a response looks like

Every response uses the same envelope — a success flag, the data payload, a meta block (region, pagination, live quota) and an error object. A single game from GET /api/v2/games/7704?region=us looks like this (trimmed):

{
  "success": true,
  "data": {
    "PPID": 7704,
    "XboxAccountID": "9NKX70BBCDRN",
    "ProductName": "Forza Horizon 5 - Premium Edition",
    "region": "US",
    "IsXboxSeriesXS": 1,
    "IsXboxOne": 1,
    "IsDLC": 0,
    "BasePrice": 9999,
    "SalePrice": 4999,
    "GamePassPrice": 4999,
    "DiscPerc": 50,
    "formattedBasePrice": "$99.99",
    "formattedSalePrice": "$49.99",
    "formattedGamePassPrice": "$49.99",
    "LowestEverPrice": 4499,
    "Bronze": 24, "Silver": 12, "Gold": 3, "Platinum": 1,
    "Difficulty": 5,
    "HoursLow": 30, "HoursHigh": 60,
    "OpenCriticID": 11423,
    "XBXpricesURL": "/en-us/game/7704-forza-horizon-5-premium-edition"
  },
  "meta": {
    "region": "US",
    "rate_limit": { "limit": 20000, "used": 12, "remaining": 19988 },
    "response_ms": 9
  },
  "error": null
}

Prices are integers in the region’s minor units — pair each with its matching formatted… string for display. List endpoints return an array of these objects in data, with meta.pagination. See the full game-object reference for every field, and the error reference for the error.code values to branch on.

Still have a question? Email [email protected] and we’ll be glad to help.