Market Data

REST Overview

Base URL, authentication, response format, and errors for the Marketplace Data REST API.

Overview

The Marketplace Data REST API provides access to item listings, buy orders, price history, and sales data from third-party Steam marketplaces. It is a separate service from the main Steam API and lives on its own host.

This API documents the REST transport. For the real-time stream, see WebSocket. Both transports share the same marketplaces — see Reference.

Base URL

All REST endpoints are served from a single host.

https://marketplaceapi.steamapis.com/v2/

Authentication

Include your API key as the X-API-Key request header. HTTP headers are case-insensitive, so x-api-key works too.

X-API-Key: YourSecretAPIKey

Alternatively, pass the key as an apiKey query parameter. The header is preferred.

https://marketplaceapi.steamapis.com/v2/marketplaces?apiKey=YourSecretAPIKey

Response format

Responses are flat JSON. Unlike the Steam API, this API does not wrap responses in a { "success": true, "response": {...} } envelope. Parse the response body directly.

A successful response is either a single object or an array of objects, depending on the endpoint. For example, GET /v2/marketplaces returns an array directly at the top level of the body.

Errors

Errors are returned with a non-2xx HTTP status and a JSON body containing an error message and a machine-readable code.

error.json
{
  "error": "Marketplace not found",
  "code": "NOT_FOUND"
}

Caching and rate limits

Responses are cached server-side for 10 seconds. There are no client-side rate limits — the cache absorbs repeat traffic.

Available endpoints