Sign in
Listings V2

Search listings

Changed on

Search listings with filters

Searches active listings using full-text search, quality tier filters, price filters, and game item filters. Uses the listing_search view for optimized query performance.

Requirements:

  • 15.1: GET /api/v2/listings/search endpoint
  • 15.2: Accept text query parameter for full-text search
  • 15.3: Accept game_item_id parameter for item filtering
  • 15.4: Accept quality_tier_min and quality_tier_max parameters
  • 15.5: Accept price_min and price_max parameters
  • 15.6: Accept page and page_size parameters for pagination
  • 15.7: Return listings with price_min, price_max, quality_tier_min, quality_tier_max
  • 15.8: Return total count for pagination
  • 15.9: Support sorting by created_at, price, quality, seller_rating
  • 15.10: Include seller information in results
  • 15.11: Include variant_count in results
  • 15.12: Execute queries within 50ms performance target
put/listings/{id}

Request

  • Base URL: /api/v2 (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/v2/listings/{id}
  • Auth: loggedin (a scheme the document does not define)

Path parameters

idstring required

Request body

titlestring

New title (optional)

status'active' | 'sold' | 'expired' | 'cancelled'

New status (optional) — active, sold, expired, cancelled

descriptionstring

New description (optional)

base_pricenumber double

New base price for unified pricing mode (optional)

pickup_method'delivery' | 'pickup' | 'any' | 'null' nullable

Pickup method: how the buyer receives the item

quantity_unit'unit' | 'scu'

Quantity unit

min_order_quantitynumber double nullable

Per-listing order limits (null to remove)

max_order_quantitynumber double nullable
min_order_valuenumber double nullable
max_order_valuenumber double nullable

Response

Search results with pagination metadata

Changes

  • v2a3060250b39bRevision changes
    • ○

      the endpoint scheme security loggedin was added to the API

    • ○

      the endpoint scheme security jwt was removed from the API