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' | 'inactive' | 'sold' | 'expired' | 'cancelled'

New status (optional) — active, inactive, 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

photosstring[]

Replace listing photos with these URLs (handles removals)

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
photo_resource_idsstring[]

New photo resource IDs to append (from two-phase upload)

external_photo_urlsstring[]

New external image URLs to link as photos (validated against domain allowlist, appended after resource IDs)

visibility'public' | 'private'

Listing visibility (null to keep unchanged). Only contractor listings can be 'private'.

Response

Search results with pagination metadata

Changes