v14

OpenAPI 3.1.02026-08-03122113375.9 KB
listings

Search listings for an item

Search listings for one specific catalog item while still supporting filters and pagination.

Use this when you already know the item reference (urn or slug) and want live offers for that item.

Lookup and filtering behavior:

  • Resolves the item first from urn or slug.
  • If the item cannot be resolved, the API returns an empty result set instead of an error.
  • Applies additional listing filters and paging controls from the request body.
  • Returns only listings with available stock and enriches hits with seller, lock, and attachment metadata.

Performance:

  • Responses are cacheable for short periods to support high-traffic product pages.
post/listings/item

Request body

querystring

One or more free text search terms

filtersobject[]
fromnumber nullable

Offset for pagination

sizenumber

Number of results to return

urnstring

URN of the item to lookup

slugstring

Slug of the item to lookup

Example request

{
  "urn": "urn:managem:pokemon:product/pop8/pop-series-8-pack-4c899e14",
  "slug": "/pokemon/product/pop8/pop-series-8-pack-4c899e14"
}