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

  • Base URL: https://api.managem.co.uk
  • URL: https://api.managem.co.uk/listings/item
  • Auth: none declared

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"
}

Response

Listings for the item

totalnumber required

Total number of results

facetsobject required

Facets that can be applied to further refine the search results

Changes

No recorded changes to this operation across all 248 revisions of this API.