Sign in
Game Items V2

Get listings for game item

Changed on

Get all listings for a specific game item with quality distribution

Returns all active listings for the specified game item along with quality distribution statistics. Supports filtering by quality tier and sorting options. Computes quality distribution across all listings showing quantity, price ranges, and seller counts per quality tier.

Requirements:

  • 38.1: GET /api/v2/game-items/:id/listings endpoint
  • 38.2: Return all active listings for specified game item
  • 38.3: Compute quality distribution across all listings
  • 38.4: Return quantity available per quality_tier
  • 38.5: Return price range per quality_tier (min, max, average)
  • 38.6: Return number of sellers per quality_tier
  • 38.7: Support filtering by quality_tier
  • 38.8: Support sorting by price, quality, quantity, seller_rating
  • 38.9: Support pagination with page and page_size parameters
  • 38.10: Cache quality distribution for performance
  • 38.11: Execute queries within 50ms performance target
  • 38.12: Include game item metadata in response
get/game-items/{id}/listings

Request

  • Base URL: /api/v2 (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/v2/game-items/{id}/listings
  • Auth: none required

Path parameters

idstring required

Game item UUID (required)

Query parameters

quality_tiernumber double

Optional quality tier filter (1-5)

sort_by'price' | 'quality' | 'quantity' | 'shop_rating'

Sort field (default: price)

sort_order'asc' | 'desc'

Sort order (default: asc)

pagenumber double

Page number for pagination (default: 1)

page_sizenumber double

Number of results per page (default: 20, max: 100)

Response

Game item listings with quality distribution

totalnumber double required

Total number of variant rows (for pagination)

pagenumber double required

Current page number

page_sizenumber double required

Page size

Changes