---
title: "Search all live listings"
method: POST
path: "/listings"
tags: ["listings"]
---

# Search all live listings

`POST /listings`

Search public listings using free-text terms, facet filters, sorting, and pagination.

Use this endpoint for marketplace browse pages, category landing pages, and search-result views.

What it does:
- Applies your query text and facet filters against public listing data.
- Returns only listings with available stock (`available > 0`).
- Enriches each hit with seller summary data, lock status, and attachment URLs.

Performance and caching:
- Results are cached briefly (~30 seconds) for fast repeat searches.
- The cache key is based on the request body, so different filter sets are isolated.

## Request body

- SearchQuery — A search query includes a free text query property, refinements in the form of facets, pagination controls and optional sorting.
  - `query` string — One or more free text search terms
  - `filters` object[]
  - `facets` object — Facets to refine the search results. Values are case-sensitive unless noted otherwise.
    - `Game` string[] — Game name to match, e.g. Pokemon or Magic
    - `Product Type` string[] — Type of product, for example "card" or "product"
    - `Rarity` string[] — Card rarity values
    - `Series` string[] — Series names
    - `Set` string[] — Set names
    - `Illustrator` string[] — Illustrator names as stored on item images
    - `Condition` string[] — Listing condition codes, e.g. MT, NM
    - `Grading` string[] — Whether the card is "Graded" or "Ungraded"
    - `Price` string[] — Price buckets expressed in pounds sterling (inclusive of lower bounds)
    - `Quantity` string[] — Quantity buckets for available stock
    - `Valid` string[] — Listing validity status for seller views
    - `Hidden` string[] — Listing visibility status for seller views
    - `Availability` string[] — Filter listings or items to only those that are "In Stock"
    - `Category` string[] — Item categories (metadata)
  - `from` number, nullable — Offset for pagination
  - `size` number — Number of results to return
  - `sorting` object — Sort results by field and order
    - `field` 'name' | 'number' | 'indexed' | 'price', required
    - `order` 'asc' | 'desc', required

---

[API](https://skmtc.net/managem/apis/managem-api.md) · [All operations](https://skmtc.net/managem/apis/managem-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/managem/managem-api/versions/5ed45d6a9e2f/schema)