---
title: "Search a seller's listings"
method: POST
path: "/listings/seller/{id}"
tags: ["listings"]
---

# Search a seller's listings

`POST /listings/seller/{id}`

Search listings that belong to a specific seller.

Use this endpoint for seller storefront pages, seller profile inventory tabs, and seller-specific search experiences.

Seller targeting:
- The `id` path parameter accepts either a user ID or a username.
- Returns `404` when the seller cannot be found.

Search behavior:
- Applies your query text/facets plus an enforced filter for that seller.
- Returns only listings with available stock (`available > 0`).
- Enriches hits with seller profile, listing lock status, and attachment URLs.

Performance:
- Uses short-lived body-signature caching for repeated seller searches.

## Path parameters

- `id` string, required — User ID or username of the seller

## 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

## Other responses

- `404` — Seller not found

---

[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/e8d78a3a2e8b/schema)